CLI Commands

Core

arcana run

Start an interactive or one-shot agent session in the current project.

# Interactive TUI session
arcana run

# One-shot query
arcana run "explain this codebase"

# Specify a model
arcana run --model openai/gpt-4o "summarize the auth flow"

# With autonomy mode
arcana run "fix auth tests" --mode advise
arcana run "audit auth module" --mode ask

arcana doctor

Check system health — config, API keys, cache files, and runtime environment.

arcana doctor

# Check web app health
arcana doctor --web

arcana models

List all available models from detected providers and the models.dev catalog.

arcana models

arcana providers

Interactive provider credential management.

arcana providers

Account & license

arcana console

Device-flow login, org management, and logout.

# Login (default server)
arcana console login

# Login to a custom server
arcana console login https://arcana.otnelhq.com

# List organizations
arcana console orgs

# Switch active org
arcana console switch

# Logout
arcana console logout [email]

# Open console in browser
arcana console open

arcana license

Activate, check, or deactivate a Pro/Enterprise license key.

# Activate a license
arcana license activate <key>

# Check status
arcana license status

# Deactivate
arcana license deactivate

arcana trust

Manage workspace trust for project plugins, tools, and local MCP.

# Trust current workspace
arcana trust

# Check trust status
arcana trust status [path]

# List all trusted workspaces
arcana trust list

# Revoke trust
arcana trust revoke [path]

# Grant trust to a specific path
arcana trust grant [path]

Sessions & data

arcana session

List and delete past sessions.

# List sessions
arcana session list

# Delete a session
arcana session delete <sessionID>

arcana history

Browse and resume past sessions.

# List past sessions
arcana history list

# Show session detail
arcana history show --id <session-id>

# Resume a session
arcana history resume --id <session-id>

arcana memory

Manage FTS5-powered session memory, facts, and cloud sync.

# List extracted facts
arcana memory facts

# Full-text search
arcana memory search --query <q>

# Show statistics
arcana memory stats

# Cloud sync
arcana memory push     # local facts → cloud
arcana memory pull     # cloud facts → local
arcana memory sync     # push then pull

arcana export / import

Export and import session data.

arcana export
arcana import

arcana stats

Show usage statistics.

arcana stats

arcana learn

View accumulated knowledge from the self-improving knowledge pipeline.

# List learned entries
arcana learn list

# Show a specific entry
arcana learn show --slug <slug>

# Show map of consciousness
arcana learn moc

arcana db

Local database utilities (inspect / path). Prefer higher-level commands unless debugging.

arcana db --help

MCP, plugins, agents

arcana mcp

Manage MCP (Model Context Protocol) servers.

# List MCP servers
arcana mcp list

# Add an MCP server
arcana mcp add [name]

# Authenticate an MCP server
arcana mcp auth [name]

# Logout from an MCP server
arcana mcp logout [name]

# Debug an MCP server
arcana mcp debug <name>

arcana plugin

Plugin management.

arcana plugin --help

arcana plugin-store

Browse and install plugins from the store.

arcana plugin-store --help

arcana agent

Agent configuration helpers.

arcana agent --help

Server & integrations

arcana serve

Headless control plane server. Defaults to loopback. Non-loopback binds require ARCANA_SERVER_PASSWORD.

# Start on loopback
arcana serve

# Bind to specific address
arcana serve --hostname 127.0.0.1 --port 4096

# Non-loopback (requires password)
ARCANA_SERVER_PASSWORD=secret arcana serve --hostname 0.0.0.0 --port 4096

arcana attach

Attach to a running server.

arcana attach --help

arcana web

Optional SolidJS web dashboard.

# Start web app
arcana web

# Build for production
arcana web --build

# Custom host/port
arcana web --host 127.0.0.1 --port 3000 --open

arcana github / pr

GitHub and pull request helpers.

arcana github --help
arcana pr --help

Lifecycle & maintenance

arcana upgrade

Upgrade Arcana to the latest version.

arcana upgrade

arcana uninstall

Uninstall Arcana.

arcana uninstall

arcana audit

Audit helpers.

arcana audit --help

Advanced

arcana proxy

Proxy connection helpers — check health, list models, and view usage.

# Check proxy health
arcana proxy status

# List available models
arcana proxy models

# View usage
arcana proxy usage

arcana gateway

Start chat platform adapters (Telegram, Discord, Slack, WhatsApp).

# Start with config
arcana gateway

# Pass tokens directly
arcana gateway --telegram-token "111:xxx"
arcana gateway --discord-token "xxx"

See Gateway for full setup instructions.

arcana cron

Schedule and manage recurring agent jobs.

# Add a job
arcana cron add --name "review" --schedule "0 */4 * * *" --prompt "review open PRs"

# List jobs
arcana cron list

# Run a job now
arcana cron run --id <id>

# Start the scheduler daemon
arcana cron start

See Cron for the full scheduled jobs reference.

arcana skills

Browse, search, and manage skills.

# List all skills
arcana skills list

# Search by keyword
arcana skills list --query "python testing"

# Show skill details
arcana skills info --skill "python-testing"

# Skills ranked by usage
arcana skills ranked

See Skills for the full skills reference.

arcana team

Team collaboration helpers.

arcana team --help

arcana generate

Generation utilities.

arcana generate --help

arcana acp

ACP (Agent Communication Protocol) mode.

arcana acp --help

arcana debug

Debug tools for troubleshooting.

arcana debug --help

Environment variables

Common environment variables that affect CLI behavior:

Global flags