Arc OS Docs Open in app →

Arc OS — Benutzerhandbuch

Vollständiger Leitfaden zu allen Funktionen des Arc OS CRM Dashboards. Zuletzt aktualisiert: 2026-05-04 (Phase 52.1)

Feature-Übersicht auf einen Blick

graph LR
    Login[1. Login + Einladungscode]
    Dash[2. Alle-Projekte-Ansicht]
    Onb[3. Projekt-Erstellen-Wizard]
    Work[4. Workspace + Worker]
    Time[5. Timeline-Replay]
    Iss[6. Issues redesign]
    Skill[7. Skills + Sage]
    Wiki[8. Wiki + KG]
    NB[9. NotebookLM]
    Bill[10. Testzeitraum + Billing]

    Login --> Dash --> Onb --> Work
    Work --> Time
    Work --> Iss
    Work --> Skill
    Work --> Wiki --> NB
    Dash --> Bill

Inhaltsverzeichnis

  1. Erste Schritte
  2. Dashboard-Layout
  3. Workspace — AI Worker
  4. Dateianhänge
  5. Folders — Dateimanager
  6. Worker Studio — Eigene Worker
  7. Issues
  8. Wiki
  9. Knowledge Graph
  10. Skill Evolution
  11. Roadmap
  12. Reports
  13. Analytics
  14. NotebookLM — Neural Memory
  15. Cloud PM — Projektchat
  16. Projekt-Einstellungen
  17. Telegram-Integration
  18. Design & Einstellungen
  19. Tastaturkürzel
  20. Troubleshooting
  21. Timeline (Phase 47)
  22. Testzeitraum & Billing
  23. Beta-Zugang — Einladungscodes

1. Erste Schritte

Beta-Zugangsbeschränkung (Phase 52.1): Die öffentliche Registrierung ist derzeit nur per Einladung möglich. Du brauchst einen Einladungscode im Format arc-XXXX-XXXX, um ein Konto zu erstellen. Wie du einen bekommst, erfährst du in §23 Beta-Zugang.

Onboarding-Ablauf — Storyboard

sequenceDiagram
    autonumber
    actor U as Du
    participant L as Login Screen
    participant E as Email
    participant W as Onboarding Wizard
    participant M as Master Bot
    participant Wo as Workspace

    U->>L: paste invite code arc-XXXX-XXXX
    L->>L: validate format
    U->>L: enter email + password + name
    L-->>E: send verification link (24h TTL)
    U->>E: click verification link
    E->>L: redirect → logged in
    L->>W: first-time user → wizard
    U->>W: name project · pick blueprint · set Anthropic key (optional)
    W->>M: POST /api/crm/onboarding/setup
    M->>M: allocatePort() · create dirs · clone blueprint · spawn child bot
    M-->>W: project ready
    W->>Wo: redirect to /project/<name>
    U->>Wo: send first message
    Wo-->>U: stream tokens via SSE

Zeitplan: Ziel ≤10 Min. vom Einladungscode bis zur ersten AI-Antwort. Schritte 1-5 ≈ 3 Min., Schritte 6-9 ≈ 2 Min., erster Chat ≈ 1-5 Min. je nach Blueprint-Clone.

Login

Arc OS unterstützt drei Authentifizierungsmethoden:

Option A: E-Mail & Passwort

  1. Öffne das CRM Dashboard (https://arc-os.co oder http://<server>:18888).
  2. Klicke auf dem Login-Bildschirm auf Konto erstellen.
  3. Gib deine E-Mail, deinen Anzeigenamen, dein Passwort und deinen Einladungscode (arc-XXXX-XXXX) ein.
  4. Verifiziere deine E-Mail über den Link, der in dein Postfach gesendet wurde (TTL 24 Stunden).
  5. Melde dich mit E-Mail und Passwort an.

Option B: OAuth (Google / GitHub)

  1. Öffne den CRM-Login-Bildschirm.
  2. Klicke auf Weiter mit Google oder Weiter mit GitHub.
  3. Autorisiere im Popup-Fenster.
  4. Du wirst zurückgeleitet und automatisch eingeloggt.

Alle Methoden erzeugen einen JWT-Token (gültig 24 Stunden), der in deinem Browser gespeichert wird.

Erste Schritte

Nach dem Login siehst du die Alle-Projekte-Ansicht. Benutze das Workspace-Selector-Dropdown im Header, um zwischen Projekten zu wechseln, oder klicke auf Alle Projekte für das globale Dashboard.

2. Dashboard-Layout

Top Header

Element Beschreibung
Hamburger-Menü Sidebar ein-/ausblenden (linke Seite)
Workspace-Selector Dropdown zum Wechseln zwischen Projekten und der globalen „Alle Projekte"-Ansicht
Verbindungsanzeige Grüner Punkt = verbunden, rot = getrennt
Design-Toggle Hell-/Dunkel-Modus umschalten
Benutzermenü Profil, Konto-Einstellungen, Abmelden

Sidebar

Einklappbares Navigationsmenü (Hamburger klicken zum Umschalten). Mobil: Overlay-Schublade mit Hintergrund.

Globale Seiten (sichtbar aus Alle-Projekte):

Projektseiten (sichtbar bei ausgewähltem Projekt):

ContextRail (Rechtes Panel, ≥1280px)

Ein 320px breites rechtes Panel, das Projektkontext neben der aktiven Seite anzeigt. Bereiche:

3. Workspace — AI Worker

Der Workspace ist dein Hauptinterface für die Interaktion mit AI. Er nutzt ein Dynamic Worker-System, bei dem jeder Worker ein spezialisierter AI-Agent ist.

Eingebaute Worker

Worker Typ Modell Zweck
Consultant Chat Sonnet Read-only-Analyse, Architekturberatung, Spec-Vorschläge
Developer Terminal Opus Vollständige Code-Bearbeitung, Dateioperationen, Bash-Befehle

Worker-Leiste

Oben im Workspace siehst du Worker-Pills (Schaltflächen):

Chat-Worker (Consultant)

Chat-Blasen-Interface:

Terminal-Worker (Developer)

Log-Stream-Terminal-Interface:

Modell-Selector

In der unteren Toolbar jedes Worker-Panels:

Quick Actions (untere Leiste)

Schaltfläche Aktion
/btw Kontextnotiz hinzufügen — fragt nach Text, wird der nächsten Nachricht vorangestellt
Pause Aktuellen Claude-Subprocess pausieren (SIGSTOP)
Stop Aktuellen Claude-Subprocess beenden (SIGKILL)
Approve Last /approve für die letzte Spec an den Developer senden

4. Dateianhänge

Du kannst Dateien an jede Worker-Nachricht anhängen.

So hängst du Dateien an

  1. Klicke auf das Büroklammer-Icon im Nachrichteneingabebereich, ODER
  2. Ziehe Dateien per Drag-and-Drop auf den Workspace, ODER
  3. Füge ein Bild aus der Zwischenablage ein

Unterstützte Dateitypen

Typ Erweiterungen Verarbeitung
Text/Code .txt, .md, .py, .js, .ts, .jsx, .tsx, .css, .html, .json, .yaml, .sh, .sql, .csv, .go, .rs, .java, .c, .cpp, .rb, .php usw. Als Text gelesen, Inhalt in Nachricht injiziert
Bilder .png, .jpg, .jpeg, .gif, .webp, .svg, .bmp Auf JPEG komprimiert (max. 1600px, 80% Qualität), als Vorschaubild angezeigt
PDF .pdf Als base64 gelesen, als temporäre Datei auf dem Server gespeichert, Pfad in Prompt injiziert

Anhang-Chips

Nach dem Anhängen erscheinen Dateien als Chips über dem Eingabefeld:

Größenbeschränkungen

5. Folders — Dateimanager

Die Seite Folders bietet einen vollständigen Dateibrowser für dein Projektverzeichnis auf dem Server.

Navigation

Toolbar-Aktionen

Aktion Beschreibung
Upload Mehrere Dateien hochladen (Schaltfläche oder Drag-and-Drop)
Neuer Ordner Ein neues Verzeichnis erstellen (Namen eingeben)
Neue Datei Eine Datei mit optionalem Anfangsinhalt erstellen
Link hinzufügen Eine .link.md-Lesezeichendatei erstellen (URL + Text)
Repo klonen Ein Git-Repository klonen (HTTPS-URL, flach --depth 1)

Kontextmenü (Rechtsklick)

Rechtsklicke auf ein Element für weitere Optionen:

Bei Dateien:

Bei Ordnern:

Bei leerem Bereich:

Dateivorschau-Panel

Wenn du auf eine Datei klickst, öffnet sich ein Seitenpanel mit:

6. Worker Studio — Eigene Worker

Du kannst eigene AI-Worker erstellen, die auf deine Projektanforderungen zugeschnitten sind.

Worker erstellen

  1. Im Workspace klicke auf das Zahnrad-Icon (Worker Studio) in der Worker-Leiste
  2. Klicke auf + Neuer Worker
  3. Fülle die Worker-Konfiguration aus:
Feld Beschreibung
Label Anzeigename (z.B. „QA Tester")
Icon Emoji-Icon für das Worker-Pill
Typ Chat (konversationell) oder Terminal (Log-Stream)
Modell Zu verwendendes AI-Modell (Sonnet, Opus, Haiku)
Max Turns Maximale Claude-Subprocess-Durchläufe (1-50)
Tools Welche Tools der Worker nutzen kann (Read, Edit, Bash usw.) oder „all"
Focus Dirs Verzeichnisse, auf die sich der Worker konzentrieren soll
System Prompt Eigene Systemanweisungen für den Worker
Context Assets Dateien/Verzeichnisse, die automatisch als Kontext geladen werden

KI-generierte System-Prompts

Klicke auf Mit KI generieren, um automatisch einen System-Prompt zu erstellen basierend auf:

Telegram-Bot-Token

Jeder Worker kann seinen eigenen dedizierten Telegram-Bot haben:

  1. Worker in Worker Studio bearbeiten
  2. Im Bereich Telegram-Bot-Token einen Bot-Token einfügen (von @BotFather)
  3. Auf Verbinden klicken
  4. Der Worker-Bot startet automatisch und verarbeitet Nachrichten eigenständig
  5. Zum Entfernen: auf Trennen klicken

Das erlaubt Worker-spezifische Telegram-Bots — z.B. ein Consultant-Bot mit read-only-Zugriff und ein Developer-Bot mit vollem Zugriff.

Worker verwalten

7. Issues

Die Seite Issues ist ein vollständiger Issue-Tracker für dein Projekt.

Funktionen

Über die CLI

Issues können auch über ARC CLI verwaltet werden:

arc issues                         # offene Issues auflisten
arc issue create --title "Bug..." # neues Issue erstellen
arc issue log <id> "Fixed X"      # Aktivitätslog-Eintrag hinzufügen

8. Wiki

Die Seite Wiki ist eine Wissensbasis für dein Projekt.

Funktionen

9. Knowledge Graph

Die Seite Graph visualisiert Beziehungen zwischen Projektentitäten (Issues, Wiki-Seiten, Skills, Roadmap-Phasen) als interaktiven Knotengraphen.

10. Skill Evolution

Die Seite Skill Evolution (heißt in der Projekt-Sidebar „Skills", in der globalen Sidebar „Skills Registry") bietet erweitertes Skill-Management.

Zweispaltiges Layout

Sage Worker

Sage ist ein KI-gestützter Skill-Analyzer:

Skill-Forks

Einen globalen Skill forken, um ihn für ein bestimmtes Projekt anzupassen. Der Fork verfolgt den Ursprungs-Skill und kann Updates abrufen.

11. Roadmap

Die Seite Roadmap zeigt den Entwicklungsplan des Projekts, organisiert nach Phasen.

12. Reports

Die Seite Reports zeigt Analytics und Sitzungsberichte.

13. Analytics

Die Seite Analytics (globale Ansicht) zeigt systemweite Health- und Metriken:

14. NotebookLM — Neural Memory

Wenn dein Projekt mit NotebookLM-Notebooks verknüpft ist, erscheinen diese in der Sidebar-Fußzeile unter „Neural Memory":

Die globale Seite NotebookLMs zeigt alle verknüpften Notebooks projektübergreifend.

15. Cloud PM — Projektchat

Der Cloud PM ist ein persistenter Projektchat, der vom Workspace aus zugänglich ist:

16. Projekt-Einstellungen

Die Seite Projekt-Einstellungen (über die Einstellungsschaltfläche in der Sidebar zugänglich) bietet:

17. Telegram-Integration

Der Telegram-Bot ist eine alternative Befehlsschnittstelle. Alle CRM-Dashboard-Funktionen sind auch über Telegram zugänglich.

Master Bot-Befehle

Befehl Beschreibung
/status Systemübersicht (Health aller Projekte)
/list Alle registrierten Projekte auflisten
/health Detaillierter Health-Check für alle Bots
/watchdog Watchdog-Status und Child Bot-Monitoring
/new_project <name> Interaktiver Projekt-Erstellungs-Wizard
/deploy Updates auf dem VPS deployen
/emergency_stop Alle Child Bots sofort stoppen

Child Bot-Befehle

Befehl Beschreibung
/ping Bot-Health-Check
/thread Thread-Verlaufsgröße
/quality Skill-Qualitätsmetrik-Bericht
/learnings Angesammelte Korrekturregeln anzeigen
/specs Ausstehende Specs anzeigen
/approve <id> Eine Spec genehmigen
/reject <id> [Grund] Eine Spec ablehnen

Nachrichten-Routing

Präfix Wird geleitet an
/c <Nachricht> Consultant Worker
/d <Nachricht> Developer Worker
/w:<worker_id> <Nachricht> Eigener Worker nach ID
(kein Präfix) Aktive Rolle (Standard: Consultant)

Worker-spezifische Telegram-Bots

Jeder Worker kann seinen eigenen Telegram-Bot-Token haben (konfiguriert in Worker Studio). Wenn ein Worker einen eigenen Bot hat:

Inline-Schaltflächen

Nach jeder Bot-Antwort erscheinen Inline-Schaltflächen:

18. Design & Einstellungen

Hell-/Dunkel-Modus

Klicke auf den Design-Toggle im Top Header, um zwischen hellem und dunklem Design zu wechseln. Deine Auswahl wird in localStorage gespeichert.

Konto-Einstellungen

Klicke auf deinen Avatar → Konto-Einstellungen, um Folgendes zu konfigurieren:

Farbsystem

Das Dashboard verwendet CSS-eigene Eigenschaften für konsistentes Design:

Statusfarben

Farbe Bedeutung
Grün Gesund / Erfolg / Online
Gelb/Orange Beeinträchtigt / Warnung / Verarbeitung
Rot Ausgefallen / Fehler / Fehlgeschlagen
Lila Thinking / Spec-Entwurf
Blau Ausführend / Aktiv

19. Tastaturkürzel

Kürzel Kontext Aktion
Enter Nachrichteneingabe Nachricht senden
Shift+Enter Chat-Textarea Neue Zeile
Escape Beliebiges Modal Modal/Overlay schließen
Rechtsklick Dateibrowser Kontextmenü

20. Troubleshooting

„Verbindung getrennt" / Roter Indikator

Das Dashboard hat die Verbindung zum Server verloren. Prüfe:

  1. Läuft das VPS? (ssh auf Server, tmux ls prüfen)
  2. Läuft nginx? (systemctl status nginx)
  3. Läuft der Master Bot? (curl http://<server>:19210/api/master/health)

„Unauthorized" / Login-Schleife

Dein JWT-Token ist abgelaufen (TTL 24h). Melde dich erneut über E-Mail/Passwort oder OAuth an.

Worker-Panel zeigt keine Ausgabe

  1. Prüfe, ob SSE-Stream verbunden ist (Browser DevTools → Netzwerk → nach EventStream filtern)
  2. Der Worker hat möglicherweise noch keine Ausgabe produziert — sende zuerst eine Nachricht
  3. Seite neu laden (F5)

Datei-Upload schlägt fehl

Bot antwortet nicht in Telegram

  1. Bot-Health prüfen: /ping senden
  2. Wenn keine Antwort, per SSH auf VPS und tmux prüfen: tmux attach -t citadel-child
  3. Logs prüfen: tail -50 /var/log/citadel/<project>/system-$(date +%Y-%m-%d).log
  4. Über CRM neu starten: Projekt-Einstellungen → Bot neu starten, oder /deploy im Master Bot

CORS-Fehler in der Browser-Konsole

Die Dashboard-Domain muss in CRM_ALLOWED_ORIGINS enthalten sein. Standardmäßig erlaubt:

invite_required 403 bei der Registrierung (Phase 52.1)

Öffentliche Registrierung ist gesperrt. Entweder:

plan_limit_reached 402 bei Projekt/Worker-Erstellung (Phase 51)

Dein Konto hat das Limit deines Tarifs erreicht:

Upgrade über Einstellungen → Billing (Stage-3-UI in Entwicklung). Für jetzt CEO kontaktieren.

21. Timeline (Phase 47)

Eine DAW-ähnliche Observability-Seite, mit der du die Sitzung eines Workers wie eine Audiomischkonsole abspielen kannst.

sequenceDiagram
    participant U as Du
    participant W as Workspace
    participant T as Timeline
    participant DB as timeline_events table

    U->>W: send message to Worker A
    W->>DB: append events (think · tool · response)
    U->>T: open Timeline page
    T->>DB: query events grouped by worker
    T-->>U: render lanes + playhead
    U->>T: scrub playhead / mute/solo lanes

Funktionen

Wann nutzen

22. Testzeitraum & Billing (Phase 50-51)

Arc OS nutzt Anthropics API in deinem Namen für Chat-/Terminal-Worker. Die Basisplattform ist kostenlos, aber Token-Kosten werden auf dein Konto übertragen.

Testzeitraum-Credits (Phase 50)

Stripe Billing (Phase 51 — Stage 1 live, Stage-3-UI ausstehend)

Tarif Preis Projekte Worker
Free $0 1 5
Min $4.99/Monat 5 ODER 25 (OR-Semantik) OR-Semantik
Max $11.99/Monat 20 ODER 150 OR-Semantik
Beta manuell Unbegrenzt Unbegrenzt

OR-Semantik-Limits: „5 ODER 25" bedeutet, du kannst entweder ≤5 Projekte ODER ≤25 Worker in allen Projekten haben — je nachdem, was du zuerst erreichst.

Eigenen Schlüssel mitbringen

Wenn du lieber direkt bei Anthropic zahlst:

  1. Anthropic-API-Schlüssel von https://console.anthropic.com holen
  2. Konto-Einstellungen → API-Schlüssel → Schlüssel einfügen
  3. Oder Local Bridge CLI nutzen, um Worker kostenlos auf deiner eigenen Maschine auszuführen

Status-Endpunkt

GET /api/crm/billing/status gibt zurück:

23. Beta-Zugang — Einladungscodes (Phase 52.1)

Arc OS befindet sich in der Friends & Family Beta. Die öffentliche Registrierung ist geschlossen, bis die F&F-Erfolgskriterien validiert sind.

Einladung erhalten

Code-Format

arc-XXXX-XXXX — arc--Präfix + 8 Hex-Zeichen in zwei getrennten Gruppen (crypto.randomBytes abgeleitet).

Code verwenden

  1. Zum Registrierungsformular gehen
  2. Code in das Feld Einladungscode einfügen (Monospace-Eingabe, clientseitig validiert)
  3. Der Code wird bei erfolgreicher Registrierung atomisch verbraucht — ein Code pro Konto
  4. Wenn der Code bereits verwendet oder widerrufen wurde: 403 invite_required mit Link zum Feedback-Kanal

Vorteile für Gründungsmitglieder

Admin: Codes erstellen & widerrufen (nur CEO)

arc invites generate --count 5            # 5 neue Codes erstellen
arc invites list                          # aktive Codes + Verwendung anzeigen
arc invites revoke arc-AAAA-BBBB          # geleakten Code ungültig machen

REST-Äquivalente: POST/GET/DELETE /api/crm/admin/invites (Admin-Rolle erforderlich).

Gepflegt vom Arc OS-Team. Nach jeder Phase-Fertigstellung aktualisiert.