Skip to main content

Install Zippy CLI

The zippy CLI lets you publish content, manage courses and lessons, configure rubrics, and run evaluations directly from your terminal. It runs on macOS and Linux.

Quick install

curl -fsSL https://heyzippy.io/install.sh | sh

Installs the latest zippy binary into /usr/local/bin (or ~/.local/bin as fallback if you do not have write access to /usr/local/bin).

Pin a version

Set ZIPPY_VERSION to install a specific release:

curl -fsSL https://heyzippy.io/install.sh | ZIPPY_VERSION=v0.1.2 sh

Set ZIPPY_INSTALL_DIR to choose a custom install location:

curl -fsSL https://heyzippy.io/install.sh | ZIPPY_INSTALL_DIR=$HOME/bin sh

Verify the install

zippy --version

Should print the version you installed.

Quick start

Authenticate with your Zippy account:

zippy login

List your courses:

zippy courses list

Scaffold a new course in the current directory:

zippy courses init

See all available commands and flags in the releases page.

Use with Claude Code (skills)

The heyzippy/zippy repo includes a set of Claude Code skills that teach Claude how to author Zippy content using this CLI. Install them once and Claude will use them automatically when relevant.

git clone --depth 1 https://github.com/heyzippy/zippy.git /tmp/zippy-skills
cp -r /tmp/zippy-skills/skills/* ~/.claude/skills/
rm -rf /tmp/zippy-skills

Claude will pick up the skills on the next session start. No restart needed if Claude Code is already running — open a new session and the skills will be available.

Source on GitHubReport an issue