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 .

Commands

Groups

CLI

quick copy

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

Beta On beta, --beta / --channel apply to this run only and do not change updates.channel in config. Set that key if you want beta CLI updates by default.

$ ak self-update --check

ak update

Preview or apply AgentKit-owned kit refreshes; remove unchanged kit files the new source no longer ships

--dry-run--yes--force--global--channel--beta--kits--local--remote--target--show-diff

Beta On beta, --beta / --channel apply to this run only. Without a flag, each installed kit follows the channel it was installed from.

$ ak update --dry-run

ak uninstall

Remove an AK-managed project

$ ak uninstall

ak gui

Launch the AgentKit desktop GUI

$ ak gui

Kits, skills & agents

10 cmds

ak kit

Kit management commands

initinstallinstall-pathlist-kitsrefreshrepair-install-modeuninstallvalidate

Beta On beta, ak kit list-kits reads the remote kit list by default and no longer falls back to a local ./kits folder. For a local source, pass --kits-dir or set AGENTKIT_KITS_DIR.

$ ak kit list-kits

ak kit init

Install or build a kit

--yes--beta--channel

Beta On beta, --beta / --channel apply to this run only and do not change the default channel in config. Set kit.channel in config if you want beta as the default.

$ 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

Account

4 cmds

ak login

--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

Inspect & diagnose

17 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 usage

Inspect trailing 5-hour and week token use per provider from the local analytics store. Local mode does not open a network connection.

limits --provider--window--json

$ ak usage limits --provider claude

ak insights

Measure local skill and agent quality, cost, and time. Collection and aggregate sharing are separate opt-ins.

skillsagentsconsentcollectcompare

Beta Beta adds ak insights work (list, create, defer, dismiss, awaiting-verification, verify) to track improvement work from evidence-backed suggestions. verify only compares recorded evidence; it does not run a model or edit files.

$ ak insights skills

ak eval

Run a controlled local skill and agent evaluation suite.

run

$ ak eval run suite.json

ak analytics

Control the private local analytics index

statusenabledisablerefreshrebuilddelete

$ ak analytics status

ak content-search

Opt-in local project content search (plaintext shards)

statusenabledisablesearchrebuilddelete

$ ak content-search status --project <uuid>

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

Beta On beta, ak versions shows one row per install destination (runtime, scope, delivery mode), and the --json data uses schema version 2. Add --local-only to skip network lookups.

$ 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

Config & runtime

10 cmds

ak secrets

Store named secret values in the OS keychain. ~/.agentkit/secrets/index.json keeps metadata only, never the value.

setgetlistdeleterotateimport-env

$ ak secrets list

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

Beta

Beta-only commands

These commands exist only when you run the beta ak CLI, not yet on stable. How to switch to beta

ak describe

Print the contract of any ak command for agents and scripts: summary, examples, flags, subcommands, declared exit codes, and whether it changes files, needs the network or asks for confirmation. Read-only and offline; values a command has not declared read "unspecified".

--json

$ak describe kit install --json