npx arcanova-cli@latest

What Is This?

Arcanova CLI connects your AI coding agent to Arcanova — a project management platform with an encrypted secrets vault, Kanban boards, and real-time SSE updates.

Your agent picks tasks from the board, researches context, writes code, documents the work, and moves on to the next task. Autonomously.

PICK → RESEARCH → EXECUTE → DOCUMENT → COMPLETE → REPEAT

Quick Start

1. Create an Arcanova account

Sign up at arcanova.online with GitHub or Google. Free tier available.

2. Create an API token

Go to Settings > API Tokens → New Token → copy it.

3. Install

npx arcanova-cli@latest

You'll be asked for your API token and server URL. The installer writes config files for your AI agent automatically.

4. Use it

In Claude Code:

/arcanova:connect my-project
/arcanova:status
/arcanova:pick
/arcanova:autopilot

In other agents (Copilot, Cursor, Gemini, Codex, Qwen): the agent reads its config file and follows the workflow using curl commands.

Supported Agents

All agents get the full Autopilot workflow with API endpoints and curl commands. Claude Code additionally gets 12 native slash commands.

Slash Commands (Claude Code)

Autopilot Workflow

┌─────────────────────────────────────────────┐
│            /arcanova:autopilot              │
├─────────────────────────────────────────────┤
│                                             │
│  1. PICK                                    │
│     Auto-select highest priority task       │
│     Move to IN_PROGRESS                     │
│                                             │
│  2. RESEARCH                                │
│     Read task + feature + notes + comments  │
│     Explore codebase for patterns           │
│     Post research brief as comment          │
│                                             │
│  3. EXECUTE                                 │
│     Write code following research plan      │
│     On failure → create issue, move to      │
│     REVIEW, continue to next task           │
│                                             │
│  4. DOCUMENT (mandatory)                    │
│     Post completion comment                 │
│     Create documentation note               │
│                                             │
│  5. COMPLETE                                │
│     Mark DONE → pick next → repeat          │
│                                             │
│  6. EXIT                                    │
│     No tasks left → session summary note    │
│                                             │
└─────────────────────────────────────────────┘

Supervised Mode

/arcanova:autopilot --supervised

Pauses after the research phase so you can approve the plan before the agent writes code.

Multi-Agent

Multiple agents can work on the same project simultaneously:

• Each agent gets its own API token
• Tasks are auto-assigned when picked — other agents skip them
• Dependencies prevent agents from starting blocked work
• Real-time SSE keeps boards synchronized
• Comments serve as inter-agent communication

Features

• Real-time boards — SSE-powered, cards move instantly
• Task dependencies — depends on / blocked by
• Encrypted secrets vault — AES-256-GCM
• AI spec analyzer — paste a spec, AI generates features + tasks
• File attachments — with inline preview (images, PDF, DOCX, code)
• Markdown comments — with @mention notifications
• GitHub-style rendering — syntax-highlighted code blocks
• 5 AI providers — Gemini, Claude, OpenAI, Grok, Qwen (BYO keys)

Options

# Install globally (all projects)
npx arcanova-cli@latest --global

# Uninstall
npx arcanova-cli@latest --uninstall

API

All endpoints accept Bearer token auth:

curl -H "Authorization: Bearer arc_your_token" https://arcanova.online/api/projects

Full API docs at arcanova.online/docs.

License

MIT