Arc OS — Dokumentation

Das Orchestrierungssystem für KI-Teams. 70+ API-Endpunkte. CRM-Dashboard. Selbst-gehostete semantische Suche (Cohere + sqlite-vec, Phase 71). Entwickelt mit Claude Code.

ℹ️ Phase 71 (2026-06-05): Die semantische Suche läuft jetzt über eine selbst-gehostete RAG-Pipeline (shared/rag.ts + Cohere embed-multilingual-v3.0 + sqlite-vec). Der Phase-36 NotebookLM-Bridge-Service wurde außer Betrieb genommen. Erwähnungen von NotebookLM unten verweisen auf das alte Setup; aktuelle Architektur: RAG Architecture (Englisch — Übersetzung folgt).

Schnellnavigation

Nach Abschnitt

Produkt

Was Arc OS ist, für wen es gedacht ist und warum es existiert.

• Überblick — Kernfähigkeiten, Architektur-Zusammenfassung, wichtige Zahlen
• Probleme & Lösungen — 5 echte Probleme, mit denen Entwickler bei KI-Tools konfrontiert sind, und wie Arc OS jedes davon löst
• Wettbewerbsanalyse — Feature-Matrix vs. ChatGPT, Cursor, Windsurf, Devin. Anwendungsfall-Vergleiche

Architektur

Wie das System unter der Haube funktioniert.

• Worker & Intelligence Layer — 6 eingebaute Worker, Binary Evals (6 Regeltypen), Context Router, Learnings, Karpathy Loop (nächtliche Selbstverbesserung)
• Datenbankschema — 21+ Tabellen, 21 Migrationen, Fremdschlüssel, ER-Diagramm. SQLite WAL-Modus, Indizes, Pragmas
• Intelligence Layer — Die 4 Säulen — Binary Evals, Context Router, Reflect Loop, Karpathy Loop. Plus Sage Worker und Marketplace Discovery
• System-Report — Phase 21.5 — Historischer Snapshot: Modul-Übersicht, Skills-Inventar, Infrastruktur-Details (Phase 21.5)

Leitfäden

Schritt-für-Schritt-Anleitungen zur Nutzung und Erweiterung des Systems.

• Benutzerhandbuch — Vollständiger CRM-Dashboard-Leitfaden: Login (OAuth, E-Mail, Telegram), Workspace, Worker, Issues, Wiki, Skills, Datei-Manager, Analytics und mehr
• ARC CLI-Referenz — Alle CLI-Befehle: login, issues, skills, wiki, roadmap, report, memory, wrapup (Dokumentations-Durchsetzung), github (Repo-Verknüpfung). Mit Beispielen und Umgebungsvariablen
• Telegram-Bots-Leitfaden — Master Bot (Orchestrierung) + Child Bot (KI-Proxy). Befehle, Inline-Keyboards, Worker-Routing, CRM-Integration
• NotebookLM Bridge — Semantische Suche via Google AI. Auto-Sync, Query-Cache, Memory-Tiers, Artefakt-Download
• Local Bridge CLI — Abhängigkeitsfreie Bridge: herunterladen, Token einfügen, fertig. Eigenständige Binärdateien für Windows, macOS, Linux
  • Local Bridge — macOS — Apple Silicon + Intel, Gatekeeper-Workflow, install.command
  • Local Bridge — Linux — x64 + arm64, tar.gz-Entpackung, ripgrep-Tipps
  • Local Bridge — Windows — Windows 10/11, SmartScreen, Antivirus-Eigenheiten
• Skills erstellen — skill.md schreiben, evals.json hinzufügen, in _registry.json registrieren, Pipeline testen
• Multi-Projekt-Skill-Isolation — 3 Isolationsebenen: CLAUDE.md, skills/, Context Router. Pro-Projekt-Evals, Learnings, Metriken
• Entwicklungs-Setup — Lokale Entwicklungsumgebung: Bun, Node, Ports, Umgebungsvariablen, Docker, Projektstruktur
• Troubleshooting — Auth-, Worker-, Bridge-, Frontend- und Datenbankprobleme nach Symptom diagnostizieren
• GitHub-Integration — Webhook-basierte Benachrichtigungen + Sidebar-Feed für verknüpfte Repos. HMAC-SHA256, Multi-Repo pro Projekt, Telegram-Alerts (Phase 49.3)
• E-Mail-Setup — Betriebshandbuch für [email protected]: Cloudflare E-Mail-Routing (kostenlos, 10 min), DMARC, Migrationspfad zu Zoho/Workspace

API

• CRM API-Referenz — 70+ Endpunkte in 13 Kategorien: auth, projects, workers, files, skills, chat, wiki, analytics, marketplace, billing, invites, memory. Request-/Response-Formate, Fehlercodes, Sicherheit

Architektur (Detailansicht)

Interne Architektur für fortgeschrittene Benutzer — Komponenten, Entscheidungen und phasenweise Deep Dives.

• Architektur-Überblick — Systemübersicht auf oberster Ebene mit Mermaid-Diagramm, Komponentenliste, Datenflüsse
• Phase 20 — Föderierte Bots — Master + Children-Architektur, Watchdog, Vault
• Phase 45 — Zero-Knowledge E2EE — PBKDF2-Schlüsselableitung, AES-256-GCM, Recovery-Keys, sessionStorage-Caching
• Dual-Agent-Flow — Consultant + Developer-Aufteilung, Spec-Queue, Genehmigungsfluss
• Sich entwickelnde Intelligenz — Karpathy Loop, Learnings-Injektion, nächtliche Verbesserung
• CRM-Backend — Bun-HTTP-Server-Interna, Route-Dispatch, SSE/WebSocket-Primitiven

Sicherheit

• Sicherheitsüberblick — Bedrohungsmodell, Härtungs-Zusammenfassung, Deploy-Zeit-Smoke-Tests
• Sicherheits-Audit 2026-04-23 — Sentinel Multi-Pass-Review, 13 Patches, GREEN-Urteil

Projektstatus

• Roadmap — Phasen-Zeitplan (Mermaid) + abgeschlossen/in Bearbeitung/geplant für alle 52 Phasen
• Produkt-Überblick — Vollständige Feature-Liste (27 Features), v1→v2-Reduktion, Zielgruppe

Nach Mechanismus

Dokumentation für ein bestimmtes Arc OS-Feature finden.

Dokumentenstatus