Arc OS Documentation
The Orchestration System for AI Teams. 70+ API endpoints. CRM Dashboard. Semantic search. Built on Claude Code.
Quick Navigation
| I want to... | Go to |
|---|---|
| See what Arc OS does in 5 slides | Main Features — 5 pillars + watch-the-tour button |
| Learn how to use the CRM dashboard | User Guide |
| Connect my local machine to CRM workers | Local Bridge CLI — zero-dependency, download & double-click |
| Use ARC CLI for tasks, wiki & roadmap | ARC CLI Reference — all commands with examples |
| Set up Telegram bots | Telegram Bots Guide — Master Bot, Child Bot, worker routing |
| Use semantic search across project content | RAG Architecture — Cohere embeddings + sqlite-vec, replaces NotebookLM since Phase 71 |
| Understand Workers & Intelligence Layer | Workers & Intelligence — Evals, Context Router, Learnings |
| Browse the API reference | API Reference — 70+ endpoints with params |
| See the database schema | Database Schema — 30+ tables, 35 migrations, ER diagram |
| Set up local development | Development Setup — Bun, Node, ports, env vars |
| Diagnose a problem | Troubleshooting — auth, workers, bridge, frontend errors |
| Understand what Arc OS is | Product Overview |
| See what problems it solves | Pain Points & Solutions |
| Compare with other tools | Competitive Analysis |
| Learn how the Intelligence Layer works | The 4 Pillars |
| See an early system snapshot (historical) | System Report — Phase 21.5 archive |
| Create a new skill | Creating Skills |
| Run multiple projects without context mixing | Multi-Project Skill Isolation |
By Section
Product
What Arc OS is, who it's for, and why it exists.
- Overview — Core capabilities, architecture summary, key numbers
- Pain Points & Solutions — 5 real problems developers face with AI tools and how Arc OS solves each
- Competitive Analysis — Feature matrix vs ChatGPT, Cursor, Windsurf, Devin. Use case comparisons
Architecture
How the system works under the hood.
- Workers & Intelligence Layer — 13 worker role presets, Binary Evals (6 rule types), Context Router, Learnings, Karpathy Loop (nightly self-improvement)
- Database Schema — 30+ tables, 35 migrations, foreign keys, ER diagram. SQLite WAL mode, indexes, pragmas
- Intelligence Layer — The 4 Pillars — Binary Evals, Context Router, Reflect Loop, Karpathy Loop. Plus Sage Worker and Marketplace Discovery
- System Report — Phase 21.5 (archive) — Historical snapshot from early development; kept for reference, superseded by the architecture pages above
Guides
Step-by-step instructions for using and extending the system.
- User Guide — Complete CRM dashboard guide: login (OAuth, email, Telegram), workspace, workers, issues, wiki, skills, file manager, analytics, and more
- ARC CLI Reference — All CLI commands: login, issues, skills, wiki, roadmap, report, memory, wrapup (doc enforcement), github (repo linking). With examples and env vars
- Telegram Bots Guide — Master Bot (orchestration) + Child Bot (AI proxy). Commands, inline keyboards, worker routing, CRM integration
- RAG Architecture — Self-hosted semantic search since Phase 71: Cohere embed-multilingual-v3.0 +
sqlite-vecinside the existing SQLite SSOT. Replaces the legacy NotebookLM bridge (decommissioned 2026-06-05) - Local Bridge CLI — Zero-dependency bridge: download, paste token, done. Standalone binaries for Windows, macOS, Linux
- Local Bridge — macOS — Apple Silicon + Intel, Gatekeeper workflow, install.command
- Local Bridge — Linux — x64 + arm64, tar.gz extraction, ripgrep tips
- Local Bridge — Windows — Windows 10/11, SmartScreen, antivirus quirks
- Creating Skills — Write skill.md, add evals.json, register in _registry.json, test the pipeline
- Multi-Project Skill Isolation — 3 levels of isolation: CLAUDE.md, skills/, Context Router. Per-project evals, learnings, metrics
- Development Setup — Local dev environment: Bun, Node, ports, env vars, Docker, project structure
- Troubleshooting — Diagnose auth, worker, bridge, frontend and database issues by symptom
- GitHub Integration — Webhook-based notifications + sidebar feed for linked repos. HMAC-SHA256, multi-repo per project, Telegram alerts (Phase 49.3)
- Email Setup — Operational runbook for
[email protected]: Cloudflare Email Routing (free, 10 min), DMARC, migration path to Zoho/Workspace
API
- CRM API Reference — 70+ endpoints across 13 categories: auth, projects, workers, files, skills, chat, wiki, analytics, marketplace, billing, invites, memory. Request/response formats, error codes, security
Architecture (Deep Dive)
Internal architecture for advanced users — components, decisions, and per-phase deep dives.
- Architecture Overview — Top-level system map with mermaid diagram, component list, data flows
- Phase 20 — Federated Bots — Master + Children architecture, watchdog, vault, watchdog
- Phase 45 — Zero-Knowledge E2EE — PBKDF2 key derivation, AES-256-GCM, recovery keys, sessionStorage caching
- Dual-Agent Flow — Consultant + Developer split, spec queue, approval flow
- Evolving Intelligence — Karpathy loop, learnings injection, nightly improvement
- CRM Backend — Bun HTTP server internals, route dispatch, SSE/WebSocket primitives
Security
- Security Overview — Threat model, hardening summary, deploy-time smoke tests
- Security Audit 2026-04-23 — Sentinel multi-pass review, 13 patches, GREEN verdict
Project Status
- Roadmap — Phase timeline (mermaid) + completed/in-progress/planned for all 52 phases
- Product Overview — Complete feature list (27 features), v1→v2 reduction, who-it's-for
By Mechanism
Find documentation for a specific Arc OS feature.
| Mechanism | What It Does | Docs |
|---|---|---|
| Binary Evals | Declarative rules that validate every AI response | Intelligence Layer, Creating Skills |
| Context Router | Scores skills per message, injects top-5 as hints | Intelligence Layer, System Report |
| Reflect Loop | Converts Fix It / thumbs-down into persistent rules | Intelligence Layer |
| Karpathy Loop | Nightly analysis of metrics, CEO-approved improvements | Intelligence Layer |
| Sage Worker | AI-powered skill analyzer, benchmarks, marketplace discovery | User Guide |
| Skill System | Portable instruction sets with evals and registry | Creating Skills, Multi-Project |
| Project Isolation | Federated child bots with independent context | Multi-Project, Overview |
| Quality Tracking | Per-skill success rate, feedback, duration metrics | System Report, Pain Points |
| Learnings | Persistent correction memory per project | Intelligence Layer, Multi-Project |
| Skill Registry | Central index with triggers, keywords, categories | Creating Skills, Multi-Project |
| Dynamic Workers | Extensible AI worker system (chat + terminal types) | User Guide, User Guide |
| File Attachments | Text, images, and PDF uploads to worker messages | User Guide |
| File Manager | Server-side file browser with CRUD + git clone | User Guide |
| Issues | Project issue tracker with activity log | User Guide |
| Wiki | Per-project knowledge base with markdown pages | User Guide |
| Knowledge Graph | Interactive entity relationship visualization | User Guide |
| CRM Dashboard | Web UI for project management and AI interaction | User Guide |
| Local Bridge | WebSocket relay for local file access from CRM workers | Local Bridge CLI |
| Cloud PM | Persistent project chat with Claude | User Guide |
| ARC CLI | Command-line tool for skills, issues, wiki, reports | ARC CLI Reference, User Guide |
| Telegram Bots | Master (orchestration) + Child (AI proxy per project) | Telegram Bots Guide |
| RAG / Semantic search | Self-hosted: Cohere embed-multilingual-v3.0 + sqlite-vec; auto-embeds wiki/issue/skill writes |
RAG Architecture, Intelligence Layer |
| Worker System | 6 built-in workers with scoped tools and models | Workers & Intelligence |
| CRM API | 70+ REST endpoints with JWT auth | API Reference |
| Security & Encryption | E2EE foundation, at-rest encryption, recovery keys | Security Architecture, Phase 45 E2EE |
| GitHub Integration | Webhook notifications + sidebar feed for linked repos | GitHub Integration Setup |
| Doc Enforcement | Pre-push hook + arc wrapup CLI for keeping docs in sync |
ARC CLI Reference |
| Database | SQLite with WAL, 30+ tables, 35 migrations | Database Schema |
| Troubleshooting | Diagnose issues by symptom | Troubleshooting |
Document Status
| Document | Version | Last Updated |
|---|---|---|
| User Guide | 2.0 | 2026-04-15 |
| ARC CLI Reference | 1.0 | 2026-04-27 |
| Telegram Bots Guide | 1.0 | 2026-04-27 |
| RAG Architecture | 1.0 | 2026-06-05 |
| Workers & Intelligence | 1.0 | 2026-04-27 |
| API Reference | 1.0 | 2026-04-27 |
| Database Schema | 1.0 | 2026-04-27 |
| Development Setup | 1.0 | 2026-04-27 |
| Troubleshooting | 1.0 | 2026-04-27 |
| Product Overview | 2.0 | 2026-04-15 |
| Pain Points & Solutions | 1.0 | 2026-04-03 |
| Competitive Analysis | 2.0 | 2026-04-15 |
| Intelligence Layer | 2.0 | 2026-04-15 |
| System Report 21.5 | 1.0 (historical) | 2026-04-03 |
| Creating Skills | 1.0 | 2026-04-03 |
| Multi-Project Isolation | 1.0 | 2026-04-03 |
| Local Bridge CLI | 2.0 | 2026-04-08 |