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 .

45
Commands
5
Groups
ak
CLI
quick copy
01

Lifecycle & setup

8 cmds
ak init

Initialize an AgentKit project

--dry-run--force--docs-dir--plans-dir--project-id--no-backup
$ ak init
ak new

Bootstrap a new AgentKit project

$ ak new myproj
ak setup

Guided first-run configuration wizard for AgentKit

$ ak setup
ak onboard

Run only missing first-run setup, login, and Kit install. --yes never force-overwrites.

--kit--target--channel--global--project-dir--email--yes--no-interactive
$ ak onboard --kit engineer --target codex
ak self-update

Check or apply signed AgentKit binary updates

--check--channel--beta--dry-run--include-desktop--changelog--enable-auto-update--disable-auto-update
$ ak self-update --check
ak update

Preview or apply AgentKit-owned project refreshes

--dry-run--yes--force--global--channel--beta--kits--local--remote--target--show-diff
$ ak update --dry-run
ak uninstall

Remove an AK-managed project

$ ak uninstall
ak gui

Launch the AgentKit desktop GUI

$ ak gui
02

Kits, skills & agents

10 cmds
ak kit

Kit management commands

initinstallinstall-pathlist-kitsrefreshrepair-install-modeuninstallvalidate
$ ak kit list-kits
ak kit init

Install or build a kit

$ ak kit init engineer --yes
ak kit refresh

Refresh an installed kit and remove stale generated files

$ ak kit refresh engineer
ak kit uninstall

Uninstall a kit from the current project or adapter user directory. Dry-run unless --yes.

$ ak kit uninstall engineer --dry-run
ak skills

Browse and install kit skills

graphinstalllistremovesearchshow
$ ak skills list
ak skill

Manage per-skill runtime envs

$ ak skill
ak agents

Per-agent management commands

$ ak agents
ak run

Run a skill via the configured agent adapter

$ ak run engineer/scout
ak commands

Per-slash-command management commands

$ ak commands
ak content

Publish content to channels

$ ak content
03

Account

4 cmds
ak login

Log in to AgentKit

--email--license-key--api-key--device-name
$ ak login --email you@example.com
ak logout

Clear local AgentKit credentials

$ ak logout
ak whoami

Show current AgentKit login and licensed kits

$ ak whoami
ak licenses

Show licensed AgentKit kits

$ ak licenses
04

Inspect & diagnose

14 cmds
ak doctor

Run health checks on the AgentKit installation

--json--adapter--check--fix--list--offline--exit-on-fail
$ ak doctor --json
ak audit

Check installed kits for drift

$ ak audit
ak backups

Manage rollback snapshots

$ ak backups
ak recover

Restore one rollback snapshot (alias of ak backups restore)

--dry-run--latest--allow-root
$ ak recover <id> --dry-run
ak journal

Manage journals in configured plan storage

createlistshowvalidate
$ ak journal list
ak activity

Inspect the local AgentKit activity feed

$ ak activity
ak analytics

Control the private local analytics index

statusenabledisablerefreshrebuilddelete
$ ak analytics status
ak data

Inspect derived-data retention and run bounded ingest

statusretentioningest
$ ak data status
ak sessions

Inspect and maintain local coding-agent sessions

$ ak sessions
ak diagnostics

Export redacted support diagnostics

$ ak diagnostics
ak versions

List local versions for ak, kits, and skills

$ ak versions
ak changelog

Show verified CLI, app, and kit release changelogs

--channel--target--from--full--since-current--json
$ ak changelog --channel stable --target cli
ak feedback

Send or export product feedback

$ ak feedback
05

Config & runtime

9 cmds
ak config

Open the local AgentKit dashboard

$ ak config
ak mcp

Inspect local MCP server configuration

$ ak mcp
ak migrate

Migrate an existing ClaudeKit install to AgentKit

prefsrollback --from--dry-run--yes--switch-to-plugin--force-unlock
$ ak migrate --from=ck
ak projects

Manage the global AK project registry

$ ak projects
ak plan

Manage AgentKit plan directories

$ ak plan
ak api

Run a local API + proxy server for AgentKit

$ ak api
ak watch

Watch a GitHub repository and auto-respond to issues

$ ak watch
ak orchestrate

Run and supervise external CLI job graphs (Darwin only)

startstatusresumestop
$ ak orchestrate status <run-id>
ak codex-agent-runtime

Codex agent MCP dispatch runtime

$ ak codex-agent-runtime