Install the synaptory CLI

The CLI runs alongside the Claude Code plugin — it handles authentication, skill cache sync, telemetry, and project enumeration. One install per laptop covers every project you're a member of.

Quick install

curl -fsSL https://synaptory.h3t.co/cli/install.sh | bash

iwr -useb https://synaptory.h3t.co/cli/install.ps1 | iex

Both installers detect your OS+arch, fetch the right binary, verify SHA-256, and put synap on your PATH (under ~/.local/bin on Unix, %LOCALAPPDATA%\synap\bin on Windows).

First run

synap login

synap whoami

synap projects list

What the CLI does for you

• Auth — single sign-in, token refresh on every request, revoke locally with synap logout.
• Skill cache sync — pulls watermarked skill bodies into ~/.synap/.cache/skills/ so the plugin loads instantly.
• Telemetry — sends per-session and per-receipt events to the control plane for project audit + Grafana dashboards.
• Project enumeration — synap projects list shows every project you're a member of and your role in each.
• Outbox replay — when offline, events queue locally and replay on next online session.

Manual download

Latest version pointer: /cli/latest.json. Per-version binaries live under /cli/<version>/:

Each version directory ships a sha256sums.txt for integrity verification.

Updating

The CLI checks /cli/latest.json on each invocation; when a newer version is available it prints a one-line notice with the upgrade command. To force right now:

synap upgrade

Or just re-run the install one-liner — the installer is idempotent and replaces the binary in place.

Uninstall

synap logout                # revoke session + clear keychain
rm $(which synap)           # macOS / Linux
# Windows: delete %LOCALAPPDATA%\synap\

References

• Plugin marketplace — install the Claude Code plugin (uses tokens this CLI issues)
• Control Plane — sign in to manage projects, sessions, activity, and skills
• Latest version manifest — JSON the install scripts read