Skip to content

Installation

System requirements

  • macOS 12+ (Intel or Apple Silicon)
  • Linux x86_64 (Ubuntu 20.04+, Fedora 36+, or similar)
  • Windows 10+ x64

The CLI is a single static binary with no runtime dependencies.

Installation methods

Quick install (recommended)

macOS / Linux:

curl -fsSL "https://jeffreys-skills.md/install.sh?$(date +%s)" | bash

Windows (PowerShell as Administrator):

irm https://jeffreys-skills.md/install.ps1 | iex

The install script downloads the correct binary for your platform, places it in ~/.local/bin (or %LOCALAPPDATA%\jsm on Windows), and adds it to your PATH.

Build from source

This path is intended for maintainers and contributors who already have access to the repository. For normal installs, use the installer or manual archive download below.

Requires Rust 1.85+ and a local checkout:

cargo install --path cli --locked
jsm --version

Manual download

The public release archive lives on the Jeffrey's Skills CDN, not GitHub Releases.

  1. Resolve the latest published version from latest.txt
  2. Download the archive for your platform from https://pub-e3089ab465f24bcf81d59f760fe9769c.r2.dev/jsm/<version>/
  3. Extract the jsm binary (or jsm.exe) and place it on your PATH

Examples:

  • Linux x86_64: jsm-x86_64-unknown-linux-musl.tar.gz
  • macOS Intel: jsm-x86_64-apple-darwin.tar.gz
  • macOS Apple Silicon: jsm-aarch64-apple-darwin.tar.gz
  • Windows x64: jsm-x86_64-pc-windows-msvc.zip

Verification

After installing, verify the CLI is available:

jsm --version

You should see output like:

jsm 0.1.0

First-time setup

Run the setup wizard to configure your projects directory and skill directories:

jsm setup

Then sign in:

jsm login

This opens your browser for Google OAuth. After signing in, confirm with:

jsm whoami

WSL2, containers, or remote shells

If your browser is not on the same machine as the CLI process, or loopback callbacks are unreliable in your environment, prefer:

jsm login --remote

If you already have loopback port forwarding configured and want to paste the final callback URL manually, you can also use:

jsm login --manual

Troubleshooting

jsm: command not found

Your shell may not have picked up the PATH change. Try:

  1. Open a new terminal window
  2. Or manually add the install location:
export PATH="$HOME/.local/bin:$PATH"

To make this permanent, add the line above to your ~/.bashrc, ~/.zshrc, or equivalent shell config file.

Permission denied

On Linux, you may need to make the binary executable:

chmod +x ~/.local/bin/jsm

Proxy or corporate firewall

If you are behind a proxy, set the standard environment variables before running jsm:

export HTTPS_PROXY=http://proxy.example.com:8080
jsm login

Diagnostics

Run the built-in diagnostics tool to check for common issues:

jsm doctor

This checks: authentication status, skill directory permissions, database integrity, network connectivity, and CLI version.