Erste Schritte mit Arc OS

Arc OS — AI-Orchestrierungssystem für Entwicklungsteams. Dieser Leitfaden erklärt, was Arc OS ist, warum es existiert und wie du es effektiv einsetzt.

Was ist Arc OS?

Arc OS ist eine Plattform, mit der du ein persönliches AI-Entwicklungsteam auf Basis von Claude aufbaust und verwaltest.

Die Kernidee: Statt jedes Mal einen neuen AI-Chat zu öffnen, wenn du Hilfe brauchst, hast du persistente AI-Worker, die:

Deine Codebasis, Architektur und Historie kennen
Nie den Kontext zwischen Sessions verlieren
Jeweils auf eine bestimmte Rolle spezialisiert sind
Dieselbe Projekt-Wissensbasis teilen

Du baust dein Team einmal auf. Danach arbeitest du damit — über CLI, IDE oder Web.

Die Grundidee: Ein LLM, geteilter Kontext, spezialisierte Rollen

Die meisten Entwickler nutzen AI als Wegwerf-Chat — Code einfügen, Antwort erhalten, vergessen.

Arc OS ist anders:

Ein LLM (Claude) — alle Worker laufen auf Claude. Wir haben Claude wegen des langen Kontextfensters, der Befolgung von Anweisungen und der Code-Qualität gewählt. Du bringst dein eigenes Claude-Abonnement mit.

Kein Kontextverlust — jeder Worker hat Zugriff auf:

Dein Projekt-Wiki (Architekturentscheidungen, Konventionen, Notizen)
Deine Skills (eigene Anweisungen für bestimmte Aufgaben)
Deinen Issue-Tracker (woran gearbeitet wird, was erledigt ist)
Die Session-Historie (was zuvor besprochen wurde)

Spezialisierte Rollen — jeder Worker hat eine eigene Persönlichkeit, eigene Berechtigungen und einen eigenen Zweck:

Worker	Rolle	Aufgaben
Developer	Vollzugriff	Schreibt Code, führt Befehle aus, committet, debuggt
Consultant	Nur Lesen	Reviewt, erklärt, berät — fasst nie Dateien an
Designer	UI/UX-Fokus	Komponentendesign, Barrierefreiheit, visuelle Systeme
Sentinel	Sicherheit	Auditiert Code, findet Schwachstellen, härtet Systeme
Archivist	Dokumentation	Schreibt Doku, hält das Wiki aktuell, erstellt Reports
Product Owner	Planung	Verwaltet die Roadmap, erstellt Issues, priorisiert das Backlog

Du kannst außerdem eigene Worker für deine spezifischen Bedürfnisse erstellen.

Was ist ein Projekt?

Ein Projekt in Arc OS entspricht einer Codebasis oder einem Produkt, an dem du arbeitest.

Jedes Projekt hat:

Sein eigenes Set an Workern (Developer, Consultant usw.)
Sein eigenes Wiki (Architektur-Doku, Entscheidungen, Konventionen)
Seine eigenen Skills (eigene Anweisungen, die in Worker injiziert werden)
Seinen eigenen Issue-Tracker (Aufgaben, Bugs, Features)
Seine eigene Session-Historie

Du kannst mehrere Projekte haben — eines pro Produkt, Kunde oder Repository.

Der primäre Arbeitsweg: CLI Bridge

Die CLI Bridge ist die Hauptschnittstelle von Arc OS. Sie verbindet dein lokales Terminal oder deine IDE direkt mit deinen AI-Workern.

# Start a Developer session on project "my-app"
arc my-app developer

# Start a Consultant (read-only) session
arc my-app consultant

# Continue the previous session (restores context)
arc my-app developer continue

Wenn du arc <project> <worker> ausführst, macht der Worker Folgendes:

Lädt dein Projekt-Wiki, deine Skills und das aktive Issue
Öffnet eine interaktive Claude-Session in deinem Terminal
Hat vollen Zugriff auf dein lokales Dateisystem (Developer) oder nur Lesezugriff (Consultant)
Speichert den Session-Kontext für das nächste Mal

Warum CLI-First?

Funktioniert in jedem Terminal (macOS, Linux, Windows)
Integriert sich über das Terminal-Panel in VS Code, Cursor, JetBrains
Kein Kontextwechsel — du bleibst in deinem Editor
Git-bewusst: Der Worker sieht deinen aktuellen Branch, gestagte Änderungen, letzte Commits

Wichtige arc-CLI-Befehle

arc <project> <worker>               # Start a session
arc <project> <worker> continue      # Resume previous session
arc sessions <project>               # Browse past sessions
arc issues                           # List open issues
arc issue create --title "..."       # Create new issue
arc issue log <id> "progress note"   # Log progress
arc skill <name>                     # Load a skill into context
arc wiki                             # Browse project wiki
arc roadmap                          # View project roadmap
arc retro <project>                  # Reconstruct issues from history

So legst du los

Schritt 1 — arc CLI installieren

Lade die Binärdatei für dein Betriebssystem aus dem Arc OS Dashboard herunter (Settings → CLI).

# macOS / Linux
chmod +x arc-linux-x64
sudo mv arc-linux-x64 /usr/local/bin/arc
arc --version

Schritt 2 — Dein erstes Projekt erstellen

Im CRM-Dashboard:

Klicke auf New Project
Gib einen Namen ein und verbinde dein GitHub-Repository
Das System erstellt dein Worker-Team automatisch

Schritt 3 — Skills hinzufügen (optional, aber empfohlen)

Skills sind eigene Anweisungssets, die Worker schlauer im Umgang mit deinem Projekt machen:

Code-Style-Konventionen
Architekturmuster, die du verwendest
Bibliotheken und Frameworks in deinem Stack
Dinge, die der Worker immer / nie tun soll

Gehe zu Skill Registry → Generate — das System liest deine Codebasis und schlägt automatisch Skills vor.

Schritt 4 — Deine erste Session starten

arc my-project developer

Der Developer-Worker stellt sich vor, lädt deinen Projektkontext und wartet auf deine erste Aufgabe.

Schritt 5 — Telegram verbinden (optional)

Wenn du Workern vom Smartphone aus oder unterwegs schnelle Nachrichten senden möchtest, verbinde Telegram über Settings → Telegram Bot.

Telegram ist optional — die gesamte Kernfunktionalität funktioniert über die CLI.

Wie Worker Wissen teilen

Alle Worker desselben Projekts teilen:

Wiki — Markdown-Dokumente, die du oder Worker über das Projekt schreiben. Architekturentscheidungen, API-Konventionen, „Dinge, die man wissen sollte", Onboarding-Notizen. Worker lesen das Wiki automatisch beim Session-Start.

Skills — wiederverwendbare Anweisungssets. Ein Skill „TypeScript strict mode" oder „immer zuerst Tests schreiben" wird in jede relevante Worker-Session injiziert.

Issues — wenn ein Worker an Issue #42 arbeitet, kennt er diesen Kontext. Andere Worker können sehen, woran gearbeitet wird.

Session-Historie — Worker können über arc sessions oder continue auf das verweisen, was in früheren Sessions besprochen wurde.

Standard Cloud — Always-On Workspace

Standard Cloud ist ab sofort verfügbar. Mit einem Standard-Cloud-Abonnement erhältst du einen dedizierten Docker-Container auf Arc-OS-Servern (Hetzner).

Was dir das bringt

Persistente Projektdateien auf dem VPS Dein /workspace-Verzeichnis liegt auf dem Server — nicht auf deinem Laptop. Die Dateien sind da, wenn du zurückkommst, auch nachdem du deinen Rechner zugeklappt hast.

/workspace/my-project/   ← your code, always available
/home/arcuser/.claude/   ← Claude auth, persisted
/home/arcuser/.ssh/      ← GitHub SSH key, persisted

GitHub-Sync via SSH Der Container hat einen dedizierten SSH-Key, der mit deinem GitHub-Konto verbunden ist. Du führst git clone einmal aus — danach git pull / push von überall, ohne sich erneut zu authentifizieren.

# Inside your container workspace
cd /workspace
git clone [email protected]:you/project.git   # once
git pull                                    # any time, from any device

Zugriff von jedem Gerät Öffne das Arc OS CRM vom Smartphone, Tablet oder einem anderen Rechner — dein Workspace und deine Dateien sind genau dort, wo du sie zurückgelassen hast. Kein „Das Projekt liegt auf meinem anderen Rechner"-Problem.

Dort weitermachen, wo du aufgehört hast

# In Telegram, next morning:
/continue

# Worker responds:
# Yesterday: finished auth middleware, tests remaining
# Continuing...

Der Worker nimmt den Kontext der vorherigen Session auf und arbeitet weiter — während du Kaffee trinkst.

Was enthalten ist

Feature	Free / Lokal	Standard Cloud
arc CLI (lokal)	✅	✅
CRM-Dashboard	✅	✅
Persistenter VPS-Workspace	❌	✅
GitHub-SSH-Integration	❌	✅
Zugriff von jedem Gerät	❌	✅
/continue über Telegram	❌	✅
Dateien überleben das Zuklappen des Laptops	❌	✅

Aktivierung

Gehe zu Billing → Standard Cloud
Abonniere (aktuelle Preise findest du im Dashboard)
Klicke auf Create Cloud Workspace — der Container ist in unter 60 Sekunden bereit
Verbinde Claude Code (dein Claude-Pro-Abonnement)
Verbinde den GitHub-SSH-Key
Klone dein Projekt nach /workspace

Dein Claude-Pro/Max-Abonnement ist separat — du bringst dein eigenes mit. Arc OS berechnet keine Gebühren für die Claude-Nutzung.

Was Arc OS NICHT ist

Kein autonomer Agent — Worker laufen nicht ohne dich im Hintergrund. Jede Session startet, wenn du sie öffnest.
Kein Kundensupport-Bot — Worker sprechen mit dir (dem Entwickler), nicht mit deinen Endnutzern.
Kein Workflow-Automatisierungstool — Arc OS verbindet sich nicht eigenständig mit externen APIs. Worker helfen dir, Code zu schreiben, der das tut.
Kein Ersatz für Claude.ai — Arc OS baut auf Claude auf und ergänzt Projektkontext und Teamstruktur.

Häufige erste Fragen

F: Brauche ich Telegram? Nein. Telegram ist optional. Die CLI Bridge ist die primäre Schnittstelle.

F: Teilen Worker untereinander Kontext? Ja — über das gemeinsame Wiki, die Skills und den Issue-Tracker. Sie teilen keinen Live-Session-Zustand, lesen aber dieselbe Wissensbasis.

F: Kann ich Worker anpassen? Ja. Im Worker Studio (im CRM) kannst du den System-Prompt, die Skills und das Verhalten jedes Workers bearbeiten.

F: Wie funktioniert die Abrechnung? Du nutzt dein eigenes Claude-Pro- oder Max-Abonnement. Arc OS erhebt keine zusätzlichen Gebühren für die Claude-Nutzung — du zahlst direkt an Anthropic. Arc OS berechnet eine Plattformgebühr für Dashboard und Tooling.

F: Was, wenn ich einen Worker-Typ möchte, der nicht aufgelistet ist? Erstelle einen eigenen Worker im Worker Studio. Definiere Rolle und Berechtigungen und injiziere beliebige Skills.

Deine Daten & Privatsphäre

Arc OS ist so konzipiert, dass deine Daten unter deiner Kontrolle bleiben.

Daten exportieren (DSGVO Art. 20)

Du kannst jederzeit einen vollständigen JSON-Export all deiner Kontodaten herunterladen:

Gehe zu Settings → Security → Download my data
Eine JSON-Datei wird generiert und sofort heruntergeladen

Der Export umfasst deine Kontoinformationen, Projekte, Chat-Verlauf, Issues, Wiki-Seiten, Skills und Aktivitätsprotokolle. Begrenzt auf 3 Exporte pro 24 Stunden.

Konto löschen (DSGVO Art. 17)

Du kannst dein Konto jederzeit dauerhaft löschen:

Gehe zu Settings → Security → Delete account
Bestätige die Löschung

Damit werden alle deine Daten in allen Tabellen sofort und dauerhaft gelöscht — Projekte, Chat-Verlauf, Skills, Vault-Einträge, Aktivitätsprotokolle und dein Kontodatensatz. Diese Aktion ist unwiderruflich.

Was wir nicht tun

Wir verwenden deinen Code, deine Prompts oder AI-Antworten nicht für Modelltraining
Wir betten keine Werbe-Tracker oder Analytics-SDKs ein
Wir setzen keine HTTP-Cookies — der gesamte Session-Zustand liegt in localStorage
Wir geben deine Daten nicht an Dritte weiter, über das hinaus, was für den Betrieb des Dienstes nötig ist (Cloudflare CDN, Anthropic AI-Inferenz, OAuth-Anbieter)

Die vollständige Richtlinie findest du in der Datenschutzerklärung.