CLI Commands

Complete reference for the Arcana CLI. Run arcana --help or arcana --help for the latest flags. Package name is arcana-ai; the binary is always arcana.

Core

arcana / arcana run

Start an interactive agent session (TUI) or run a one-shot prompt.

# Interactive TUI session
arcana
arcana run

# One-shot prompt
arcana run "explain this codebase"
arcana "review open PRs for bugs"

# Check system health first
arcana doctor

arcana doctor

Diagnose config, API keys, cache, and runtime environment. Run this first when something looks wrong.

arcana doctor
arcana doctor --web   # also checks the optional web dashboard package

arcana console login

Pair the CLI with your Arcana account via device flow (opens the browser seal at arcana.otnelhq.com).

arcana console login

arcana trust

Trust the current workspace so project plugins, tools, and local MCP servers can load.

arcana trust

Models & Providers

arcana models

List available models from detected providers.

arcana providers

Manage provider credentials. Keys are usually set via environment variables (OPENAI_API_KEY, ANTHROPIC_API_KEY, etc.) and auto-detected.

Sessions

arcana session list

List past sessions.

arcana history

Browse, inspect, and resume previous sessions.

arcana history list
arcana history show --id 
arcana history resume --id 

arcana stats

Usage and cost statistics.

Memory

arcana memory

FTS5-powered session memory, facts, and artifacts.

arcana memory search "deployment config"
arcana memory sessions --limit 10
arcana memory facts
arcana memory stats

Skills

arcana skills

List, search, and inspect skills.

arcana skills list
arcana skills list --query "python testing"
arcana skills info --skill "python-testing"
arcana skills ranked

Cron

arcana cron

Scheduled autonomous agent jobs.

# Add jobs
arcana cron add --name "review PRs" --schedule "0 */4 * * *" --prompt "review open PRs for bugs"
arcana cron add --name "daily digest" --schedule "@daily" --prompt "summarize today's changes"

# Manage
arcana cron list
arcana cron remove --id 
arcana cron pause --id 
arcana cron resume --id 
arcana cron run --id      # run now
arcana cron start                 # daemon (blocking)

Gateway

arcana gateway

Run chat adapters for Telegram, Discord, Slack, and WhatsApp. Configure tokens and allowlists in ~/.arcana/config.json. Requires Pro/Enterprise license after arcana console login.

arcana gateway

Server

arcana serve

Local headless HTTP server (loopback by default). Non-loopback binds require ARCANA_SERVER_PASSWORD.

arcana serve
arcana serve --host 127.0.0.1 --port 3000

Learn

arcana learn

Self-improving knowledge pipeline. After multi-turn sessions the agent extracts learnings into wiki files and a map of consciousness.

arcana learn list
arcana learn show --slug kebab-case-slug
arcana learn moc

Global flags

Install reminder

npx arcana-ai@latest
# or
npm install -g arcana-ai
arcana