CLI commands
ak
AgentKit CLI
ak
AgentKit CLI
Synopsis
/ \ | |/ /
/ _ \ | ' /
/ ___ | . \
/_/ __|_\
AgentKit
What it does: ak: multi-agent toolkit. Start with the project lifecycle commands, then use expert kit/skill commands when you need finer control. Scripted --json output is wrapped in a versioned success envelope (schema_version + kind + data); see docs/specs/ux-contract.md.
Who it's for: Both power devs (CLI scripting) and non-technical users (TUI / GUI).
When to use it: Use as your daily driver for AgentKit onboarding, updates, diagnostics, and agent operations.
Examples: ak init # onboard the current project ak update # preview project refreshes; add --yes to apply ak doctor # check setup and get the next command ak uninstall # preview removal of AK-owned project files ak gui # open the desktop UI ak kit list-kits # advanced: inspect available kits
What changes on disk: Read-only at the root; subcommands document their own disk effects.
Output modes: pretty default on TTY (colors, ASCII markers) plain auto when stdout piped or --no-interactive json --json (single-object envelope, NDJSON-safe)
Exit codes: 0 success 1 runtime error 2 invalid flags 3 user-cancel (SIGINT, prompt-cancel)
Docs / feedback: https://github.com/bestagentkits/agentkit-support
Examples
ak init # onboard the current project
ak kit init engineer --remote # install the paid engineer kit
ak doctor # check setup and get the next commandOptions
-h, --help help for akSEE ALSO
- ak activity - Inspect the local AgentKit activity feed
- ak agents - Per-agent management commands
- ak api - Run a local API + proxy server for AgentKit
- ak audit - Check installed kits for drift
- ak backups - Manage rollback snapshots
- ak changelog - Show verified CLI, app, and kit release changelogs
- ak codex-agent-runtime - Codex agent MCP dispatch runtime.
- ak commands - Per-slash-command management commands
- ak config - Open the local AgentKit dashboard
- ak content - Publish content to channels
- ak diagnostics - Export redacted support diagnostics
- ak doctor - Run health checks on the AgentKit installation
- ak feedback - Send or export product feedback
- ak gui - Launch the AgentKit desktop GUI
- ak init - Initialize an AgentKit project
- ak kit - Kit management commands
- ak licenses - Show licensed AgentKit kits
- ak login - Log in to AgentKit
- ak logout - Clear local AgentKit credentials
- ak mcp - Inspect local MCP server configuration
- ak migrate - Migrate an existing ClaudeKit install to AgentKit
- ak new - Bootstrap a new AgentKit project
- ak plan - Manage AgentKit plan directories
- ak projects - Manage the global AK project registry
- ak recover - Recover AgentKit state from a snapshot
- ak run - Run a skill via the configured agent adapter
- ak self-update - Check or apply signed AgentKit binary updates
- ak sessions - Inspect and maintain local coding-agent sessions
- ak setup - Guided first-run configuration wizard for AgentKit
- ak skill - Manage per-skill runtime envs
- ak skills - Browse and install kit skills
- ak uninstall - Remove an AK-managed project
- ak update - Preview or apply AgentKit-owned project refreshes
- ak versions - List local versions for ak, kits, and skills
- ak watch - Watch a GitHub repository and auto-respond to issues
- ak whoami - Show current AgentKit login and licensed kits