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

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

Requires Rust 1.80+:

cargo install --git https://github.com/Dicklesworthstone/jeffreys-skills.md.git --path cli jsm

Manual download

Download the latest release from the GitHub releases page and place the binary somewhere on your PATH.

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

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.