Skip to content

Troubleshooting

Fixes for common problems. If your issue is not covered here, open an issue on the project tracker.

Installation

macOS: "SkillKeeper.app is damaged and can't be opened"

macOS Gatekeeper shows this when it cannot verify the app's signature and the download carries the com.apple.quarantine attribute a browser attaches. The file is not actually corrupt: the current macOS bundles are not yet signed with an Apple Developer ID or notarized, so a quarantined copy is rejected outright.

Remove the quarantine attribute, then open the app normally (adjust the path if the app is not in /Applications):

xattr -dr com.apple.quarantine /Applications/SkillKeeper.app

You can confirm the attribute was the cause with:

xattr -l /Applications/SkillKeeper.app | grep quarantine

On Apple Silicon, if the app still will not open after clearing quarantine (an unsigned binary needs at least an ad-hoc signature), re-sign it locally and clear quarantine again:

codesign --force --deep --sign - /Applications/SkillKeeper.app
xattr -dr com.apple.quarantine /Applications/SkillKeeper.app

The skillkeeper CLI is missing after installing the desktop app

The desktop bundle (dmg/.app, deb/AppImage, nsis/msi) ships the GUI only -- it does not place a skillkeeper command on your PATH. The CLI is installed separately. This applies to every platform, macOS included.

Use the install script -- it detects your platform, downloads the matching CLI archive from the latest release, and adds the binary to your PATH.

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/lorem-dev/skillkeeper/main/scripts/install.sh | sh

Windows (PowerShell):

irm https://raw.githubusercontent.com/lorem-dev/skillkeeper/main/scripts/install.ps1 | iex

Or build it from the workspace with cargo:

cargo install --path crates/skillkeeper-cli   # installs to ~/.cargo/bin
# or: cargo build --release -p skillkeeper-cli (binary at target/release/skillkeeper)

Make sure the install directory is on your PATH, then verify with skillkeeper version. See the CLI Reference for the available commands.