ak init Initialize an AgentKit project (onboard current project)
--yes--kit <name>--global
$ ak init
AK CLI command deck
AgentKit CLI Quick Reference
List of ak commands — setup , kits , account , inspect , config . Copy examples; scan key flags.
Source: ak --help
(AgentKit CLI). Universal flags: --json , --yes , --no-interactive , --quiet
.
40
Commands
5
Groups
ak
CLI
01
Lifecycle & setup
6 cmds
ak new Bootstrap a new AgentKit project
--kit <name>--yes--dir <dir>
$ ak new --kit engineer --yes
ak setup Guided first-run configuration wizard
--global
$ ak setup
ak self-update Check or apply signed AgentKit binary updates
--check--yes--beta--include-desktop--enable-auto-update--disable-auto-update--channel <stable|beta>
$ ak self-update --check
ak update Preview or apply AgentKit-owned kit/project refreshes (TTY wizard: CLI → global → project)
--yes--global-g--kits <names>--force--show-diff--target <runtime>--beta
$ ak update --yes
ak uninstall Remove an AK-managed project (preview by default) — not for global kit removal
--yes--dry-run--force
$ ak uninstall --dry-run
02
Kits, skills & agents
10 cmds
ak kit Kit management commands
initrefreshuninstalllist-kits initrefreshuninstalllist-kits
$ ak kit init engineer --remote
ak kit init Install a kit for a target runtime (project or global)
--remote--local--global--target <runtime>--switch-to-plugin--yes--force
$ ak kit init engineer --yes
ak kit refresh Force re-emit an installed kit; remove stale generated files
--global--target <runtime>--switch-to-plugin--yes--no-backup
$ ak kit refresh engineer --yes
ak kit uninstall Remove AgentKit-owned kit content (global/project, native/plugin); preview-first
--global--plugin-mode--project-dir <path>--yes--dry-run
$ ak kit uninstall engineer --global --dry-run
ak skills Browse and install kit skills
--list--install--search--global
$ ak skills --list
ak skill Manage per-skill runtime environments
$ ak skill --help
ak agents Per-agent management commands
--list--install--global
$ ak agents --list
ak run Run a skill via the configured agent adapter
--skill <id>--target <runtime>
$ ak run --help
ak content Publish content to channels / content engine
startstopstatusqueue startstopstatus
$ ak content status
ak commands Per-slash-command management commands
--list
$ ak commands --list
03
Account
4 cmds
ak login Log in to AgentKit (email OTP, API key, or license key)
--email <addr>--api-key <key>--license-key <key>--no-interactive
$ ak login --email you@example.com
ak logout Clear local AgentKit CLI credentials
--json
$ ak logout
ak whoami Show current login and licensed kits
--json
$ ak whoami
ak licenses Show licensed AgentKit kits
--json
$ ak licenses
04
Inspect & diagnose
10 cmds
ak doctor Run health checks on the AgentKit installation
--json--offline--fix
$ ak doctor --json
ak audit Check installed kits for drift
--json
$ ak audit
ak backups Manage rollback snapshots
listrestoreverifypruneshow listrestoreverifyprune
$ ak backups list
ak recover Recover AgentKit state from a snapshot
$ ak recover --help
ak activity Inspect the local AgentKit activity feed
--json
$ ak activity
ak sessions Inspect and maintain local coding-agent sessions
$ ak sessions --help
ak diagnostics Export redacted support diagnostics
$ ak diagnostics
ak versions List local versions for ak, kits, and skills
--json
$ ak versions
ak changelog Show verified CLI, app, and kit release changelogs
--target <cli|app|kits>
$ ak changelog
ak feedback Send or export product feedback
$ ak feedback
05
Config & runtime
10 cmds
ak config Open local AgentKit dashboard (or HTTP dashboard)
startstopstatusprefs startstopstatusprefs--no-window--port <n>
$ ak config
ak config prefs Resolve, validate, or set preference keys in config.yaml
resolvevalidatesetunset resolvevalidatesetunset--scope user|project
$ ak config prefs validate
ak mcp Inspect local MCP server configuration
$ ak mcp --help
ak migrate Migrate an existing ClaudeKit install to AgentKit
rollback --from=ck--dry-run--yes--switch-to-pluginrollback
$ ak migrate --from=ck
ak projects Manage the global AK project registry
listaddremove listaddremove
$ ak projects list
ak plan Manage AgentKit plan directories
statusvalidatekanban statusvalidatekanban
$ ak plan status
ak gui Launch the AgentKit desktop GUI (or show download hint)
$ ak gui
ak api Run a local API + proxy server for AgentKit
startstatus startstatus
$ ak api status
ak watch Watch a GitHub repository and auto-respond to issues
--interval--dry-run
$ ak watch --dry-run
ak codex-agent-runtime Codex agent MCP dispatch runtime
$ ak codex-agent-runtime --help