AgentKit
ReferenceCLI commands

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 command

Options

  -h, --help   help for ak

SEE 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

On this page