AI Cockpit Reasoning CLI command reference

Run aic <command> --help to see every option supported by your installed version.

Shell commands

Command	Purpose
aic [project]	Start the interactive terminal interface.
aic --worktree <name>	Create or reuse a Git worktree and start the terminal interface in it.
aic --continue	Continue the last session.
aic run [message]	Execute a task headlessly.
aic auth login	Connect a model provider.
aic auth list	List configured provider credentials.
aic auth logout	Remove provider credentials.
aic profile	Show the connected AI Cockpit account.
aic org	Select an AI Cockpit organization.
aic models [provider]	List available models, optionally filtered by provider.
aic mcp add	Add an MCP server.
aic mcp list	Inspect configured MCP servers.
aic mcp auth <name>	Authenticate a remote MCP server.
aic mcp logout <name>	Remove an MCP server authentication.
aic agent list	List agents available in the project.
aic agent create	Create an agent interactively.
aic session list	List recent sessions.
aic worktree create <name>	Create or reuse a Git worktree for the current project.
aic worktree list	List Git worktrees for the current project.
aic worktree remove <name>	Remove a Git worktree and delete its branch.
aic plugin <module>	Install a plugin in the project configuration.
aic plugin <module> --global	Install a plugin in the global configuration.
aic export <session-id>	Export a session.
aic import <file>	Import a session.
aic stats	Show token usage and cost statistics.
aic serve	Start the local server and its browser interface.
aic attach <url>	Attach the terminal interface to a running server.
aic config check	Check the resolved configuration.
aic upgrade	Upgrade AI Cockpit Reasoning CLI.
aic help [command]	Show detailed help.

Interactive commands

Run these commands from the TUI prompt:

Command	Purpose
/connect	Connect a model provider.
/models	Select a model.
/agents	Select a primary agent.
/sessions	Open or resume a session.
/new	Start a new session.
/rename	Rename the current session.
/fork	Branch the current session.
/undo / /redo	Move through reversible session changes.
/compact	Summarize a long session to recover context.
/mcps	Inspect and toggle MCP servers.
/skills	Inspect available skills.
/status	Show provider, MCP, plugin, and project status.
/help	Show commands and keyboard shortcuts.
/exit	Close the TUI.

See Use the interactive terminal for navigation, permission prompts, sessions, and keyboard shortcuts.

Project extensions

Skills

Place reusable workflows in .aicockpit/skills/<skill-name>/SKILL.md or .agents/skills/<skill-name>/SKILL.md. Start a new session after changing a skill, then use /skills to verify discovery. See Skills for authoring guidance.

Plugins

Install an npm plugin with aic plugin <module>. Local TypeScript or JavaScript plugins can live under .aicockpit/plugin/ or .aicockpit/plugins/. Plugins execute code on your machine, so review their source before installation.

Agents and subagents

Primary agents handle the main conversation. Subagents perform delegated work in isolated sessions and return the result to their parent. An agent mode can be primary, subagent, or all.

@code-reviewer review the authentication module

Create project agent files under .aicockpit/agent/, or configure their models, prompts, and permissions in .aicockpit/aicockpit.jsonc.

Permissions

Permissions use three decisions: allow, ask, and deny. The last matching pattern wins:

{
  "$schema": "https://app.aicockpit.ai/config.json",
  "permission": {
    "read": "allow",
    "edit": "ask",
    "bash": {
      "*": "ask",
      "git status *": "allow",
      "git diff *": "allow",
      "rm *": "deny"
    }
  }
}

Keep broad defaults first and specific exceptions after them.