summonaikit
Back to Docs
// INSTALLATION

Installation

Install the SummonAI Kit binary, sign in, and verify everything is wired correctly.

//Prerequisites

SummonAI Kit drives one or more AI CLIs. You need at least one of the three to be installed and authenticated before you run the kit:

  • Claude Code, curl -fsSL https://claude.ai/install.sh | bash, then claude auth login
  • Cursor CLI, install from cursor.com, then sign in
  • Codex CLI, install via OpenAI's installer, then codex login

You don't need all three. The kit auto-detects which are present and asks you which one to use for generation and which directories to install into.

//Install the Binary

macOS / Linux / WSL:

code
curl -fsSL https://cli.summonaikit.com/install.sh | bash

Windows (PowerShell):

code
irm https://cli.summonaikit.com/install.ps1 | iex

The installer drops a single signed binary into ~/.summonaikit/bin/ and adds it to your shell PATH. No npm, no Node, no Python, summonaikit is a self-contained executable.

//Authenticate

The first time you run summonaikit, the CLI opens a browser tab via device flow:

code
summonaikit
# → Visit https://summonaikit.com/device and enter code: ABCD-1234

Tokens are stored in your system keychain (Bun.secrets) when available. On WSL, containers, or other keychainless environments they fall back to ~/.summonaikit/credentials.json with 0600 perms.

To force re-authentication or sign out:

code
summonaikit login    # re-run the device flow
summonaikit logout   # clear stored credentials
summonaikit whoami   # show signed-in user + plan tier

//Verify

code
summonaikit --version
# → 3.0.0

Then run inside any git repository:

code
summonaikit

You should see a preflight that:

  1. Detects your installed AI CLIs (Claude Code, Cursor, Codex).
  2. Verifies each one is authenticated.
  3. Reports which targets are eligible for installation.

If all three show green, you're ready for the codebase pass.

//Updating

The CLI checks for new versions at startup and tells you when one is available. To update on demand:

code
summonaikit update

The updater handles slow / flaky networks gracefully, version checks time out instead of crashing the CLI.

//Uninstall

code
rm -rf ~/.summonaikit
# remove the PATH line from ~/.zshrc / ~/.bashrc / $PROFILE if you want

Generated artifacts (CLAUDE.md, .claude/skills/, .mcp.json, etc.) live in your project repo and are unaffected.

//Requirements

  • macOS 12+ (Intel or Apple Silicon)
  • Ubuntu 20.04+ / Debian 11+ (x64 or arm64)
  • Windows 10/11 with PowerShell 5.1+
  • An authenticated Claude Code, Cursor, or Codex CLI
  • Internet (auth flow + premade-skill catalog fetch)

//Troubleshooting

"AI CLI installed but not authenticated", the preflight tells you exactly which CLI to log into. Run its login command (claude auth login, cursor login, codex login) and re-run summonaikit.

"Browser didn't open" during device flow, copy the URL from the terminal manually. The device code stays valid for ten minutes.

Empty CLAUDE.md after a run, fixed in 1.2.14. Update with summonaikit update.

"Skill name invalid", fixed in 2.0.25. Skill folder names must be lowercase, hyphenated, and ≤ 64 chars. The CLI now enforces this end-to-end.

For anything else, open an issue at the public tracker or run summonaikit --help.