Commands

Core

arctic

Launch the TUI (default command).

arctic run

Run a single prompt (headless).

arctic run "Summarize this repo"
arctic run -f ./src/index.ts "Review this file"

Options:

• --command <name> run a named command template
• --model <provider/model> force a model
• --agent <name> pick an agent
• --continue or --session <id> resume a session
• --format json stream raw events
• -f, --file attach files or directories

arctic models

List available models, optionally by provider:

arctic models
arctic models openai --verbose

arctic auth

Manage credentials:

arctic auth login
arctic auth list
arctic auth logout

arctic agent

Create or list agents:

arctic agent create
arctic agent list

arctic session

Manage sessions:

arctic session list
arctic session fork <session-id>

arctic export / arctic import

arctic export <sessionId>
arctic import <file-or-url>

arctic stats

Show comprehensive token usage and cost statistics across your sessions.

arctic stats
arctic stats --days 7 --provider openai

Options:

• --days <number>: Show stats for the last N days (default: all time)
• --tools <number>: Limit the number of tools shown
• --project <string>: Filter by project ID (empty string for current project)
• --provider <string>: Filter by provider ID
• --model <string>: Filter by model ID (partial match)

Output includes:

• Overview: Session count, message count, active days
• Cost & Tokens: Total cost, average cost/day, token usage breakdown (input/output/cache)
• Most Used Models: Usage counts and costs per model
• Tool Usage: Frequency of tool calls

arctic mcp

Manage MCP servers:

arctic mcp list
arctic mcp add
arctic mcp auth
arctic mcp logout

arctic debug

Low‑level debug tooling:

arctic debug config
arctic debug file read <path>
arctic debug snapshot diff <hash>

Slash Commands (TUI)

In the TUI, you can use slash commands for quick actions. Type / in the input to see autocomplete suggestions.

Built-in slash commands

• /status - Show system status
• /usage - View usage and rate limits
• /models - Model picker
• /agents - Agent picker
• /session - Session list
• /new - New session
• /mcp - MCP server status
• /theme - Theme picker
• /undo - Undo last message
• /redo - Redo message
• /compact - Compact session history
• /rename - Rename session
• /copy - Copy session
• /export - Export session
• /timeline - View session timeline
• /thinking - Toggle thinking mode
• /benchmark - Run benchmark
• /connect - Connect to provider
• /help - Show help
• /commands - List all commands
• /exit - Exit Arctic

Custom commands (defined in .arctic/command/) also appear in slash command autocomplete.

Custom Commands

Commands are defined as markdown templates in:

• Project: .arctic/command/*.md
• Global: ~/.config/arctic/command/*.md

Each command file uses frontmatter:

---
description: "Review changes"
model: "provider/model"
agent: "build"
subtask: true
---

Review the following changes:
{{diff}}

Invoke with:

arctic run --command review

Or in the TUI with /review.

Import from Claude Code

Arctic can import commands from Claude Code on first launch:

• Project commands: .claude/commands/ → .arctic/command/claude/
• Global commands: ~/.claude/commands/ → ~/.config/arctic/command/claude/

You'll be prompted once. Imported commands work immediately as slash commands in the TUI.