Skip to content

Latest commit

 

History

History
320 lines (220 loc) · 14.7 KB

File metadata and controls

320 lines (220 loc) · 14.7 KB

English | 한국어 | 中文 | 日本語 | Español | Tiếng Việt | Português | Русский | Türkçe | Deutsch | Français | Italiano

oh-my-claudecode

npm version npm downloads GitHub stars License: MIT Sponsor

Multi-Agenten-Orchestrierung für Claude Code. Null Lernkurve.

Lernen Sie nicht Claude Code. Nutzen Sie einfach OMC.

LoslegenDokumentationMigrationsleitfaden


Schnellstart

Schritt 1: Installation

/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
/plugin install oh-my-claudecode

Schritt 2: Einrichtung

/oh-my-claudecode:omc-setup

Schritt 3: Etwas bauen

autopilot: build a REST API for managing tasks

Das war's. Alles andere passiert automatisch.

Team Mode (Empfohlen)

Ab v4.1.7 ist Team die kanonische Orchestrierungsoberfläche in OMC. Legacy-Einstiegspunkte wie swarm und ultrapilot werden weiterhin unterstützt, leiten aber im Hintergrund an Team weiter.

/oh-my-claudecode:team 3:executor "fix all TypeScript errors"

Team läuft als gestufte Pipeline:

team-plan → team-prd → team-exec → team-verify → team-fix (loop)

Aktivieren Sie Claude Code native Teams in ~/.claude/settings.json:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

Wenn Teams deaktiviert sind, warnt OMC Sie und fällt auf Ausführung ohne Team zurück, wenn möglich.

Hinweis: Paketbenennung — Das Projekt nutzt die Marke oh-my-claudecode (Repo, Plugin, Befehle), aber das npm-Paket wird als oh-my-claude-sisyphus veröffentlicht. Wenn Sie die CLI-Tools über npm/bun installieren, verwenden Sie npm install -g oh-my-claude-sisyphus.

Aktualisierung

# 1. Plugin aktualisieren
/plugin install oh-my-claudecode

# 2. Setup erneut ausführen, um Konfiguration zu aktualisieren
/oh-my-claudecode:omc-setup

Bei Problemen nach der Aktualisierung leeren Sie den alten Plugin-Cache:

/oh-my-claudecode:omc-doctor

Ihr Claude hat gerade Superkräfte erhalten.

oh-my-claudecode


Warum oh-my-claudecode?

  • Keine Konfiguration nötig — Funktioniert sofort mit intelligenten Standardwerten
  • Team-first-Orchestrierung — Team ist die kanonische Multi-Agenten-Oberfläche (swarm/ultrapilot sind Kompatibilitätsfassaden)
  • Natürliche Sprachschnittstelle — Keine Befehle auswendig lernen, beschreiben Sie einfach, was Sie wollen
  • Automatische Parallelisierung — Komplexe Aufgaben werden auf spezialisierte Agenten verteilt
  • Beharrliche Ausführung — Gibt nicht auf, bis die Arbeit verifiziert und abgeschlossen ist
  • Kostenoptimierung — Intelligentes Model-Routing spart 30-50% an Tokens
  • Aus Erfahrung lernen — Extrahiert und wiederverwendet automatisch Problemlösungsmuster
  • Echtzeit-Sichtbarkeit — HUD statusline zeigt, was im Hintergrund passiert

Funktionen

Orchestrierungsmodi

Mehrere Strategien für verschiedene Anwendungsfälle — von Team-gestützter Orchestrierung bis token-effizientem Refactoring. Mehr erfahren →

Modus Beschreibung Verwendung
Team (empfohlen) Kanonische gestufte Pipeline (team-plan → team-prd → team-exec → team-verify → team-fix) Koordinierte Agenten mit gemeinsamer Aufgabenliste
Autopilot Autonome Ausführung (einzelner Leitagent) End-to-End-Feature-Arbeit mit minimalem Aufwand
Ultrawork Maximale Parallelität (ohne Team) Parallele Fixes/Refactorings, wenn Team nicht nötig ist
Ralph Beharrlicher Modus mit Verify/Fix-Schleifen Aufgaben, die vollständig abgeschlossen werden müssen (keine stillen Teilergebnisse)
Ecomode Token-effizientes Routing Budget-bewusste Iteration
Pipeline Sequentielle, gestufte Verarbeitung Mehrstufige Transformationen mit strikter Reihenfolge
Swarm / Ultrapilot (veraltet) Kompatibilitätsfassaden, die an Team weiterleiten Bestehende Workflows und ältere Dokumentation

Intelligente Orchestrierung

  • 32 spezialisierte Agenten für Architektur, Forschung, Design, Tests, Data Science
  • Intelligentes Model-Routing — Haiku für einfache Aufgaben, Opus für komplexes Reasoning
  • Automatische Delegation — Immer der richtige Agent für die richtige Aufgabe

Entwicklererfahrung

  • Magische Schlüsselwörterralph, ulw, eco, plan für explizite Steuerung
  • HUD statusline — Echtzeit-Orchestrierungsmetriken in Ihrer Statusleiste
  • Skill-Lernen — Wiederverwendbare Muster aus Ihren Sitzungen extrahieren
  • Analytik & Kostenverfolgung — Token-Nutzung über alle Sitzungen verstehen

Vollständige Feature-Liste →


Magische Schlüsselwörter

Optionale Abkürzungen für Power-User. Natürliche Sprache funktioniert auch ohne sie.

Schlüsselwort Effekt Beispiel
team Kanonische Team-Orchestrierung /oh-my-claudecode:team 3:executor "fix all TypeScript errors"
autopilot Vollständig autonome Ausführung autopilot: build a todo app
ralph Beharrlichkeitsmodus ralph: refactor auth
ulw Maximale Parallelität ulw fix all errors
eco Token-effiziente Ausführung eco: migrate database
plan Planungsinterview plan the API
ralplan Iterativer Planungskonsens ralplan this feature
swarm Veraltetes Schlüsselwort (leitet an Team weiter) swarm 5 agents: fix lint errors
ultrapilot Veraltetes Schlüsselwort (leitet an Team weiter) ultrapilot: build a fullstack app

Hinweise:

  • ralph beinhaltet ultrawork: Wenn Sie den ralph-Modus aktivieren, beinhaltet er automatisch die parallele Ausführung von ultrawork.
  • Die Syntax swarm N agents wird weiterhin für die Agentenanzahl-Extraktion erkannt, aber die Laufzeitumgebung basiert in v4.1.7+ auf Team.

Hilfsprogramme

Rate Limit Wartezeit

Automatische Wiederaufnahme von Claude Code Sitzungen, wenn Rate Limits zurückgesetzt werden.

omc wait          # Status prüfen, Anleitung erhalten
omc wait --start  # Auto-Resume-Daemon aktivieren
omc wait --stop   # Daemon deaktivieren

Voraussetzung: tmux (für Sitzungserkennung)

Benachrichtigungs-Tags (Telegram/Discord)

Sie können konfigurieren, wer getaggt wird, wenn Stop-Callbacks Sitzungszusammenfassungen senden.

# Tag-Liste festlegen/ersetzen
omc config-stop-callback telegram --enable --token <bot_token> --chat <chat_id> --tag-list "@alice,bob"
omc config-stop-callback discord --enable --webhook <url> --tag-list "@here,123456789012345678,role:987654321098765432"

# Inkrementelle Aktualisierungen
omc config-stop-callback telegram --add-tag charlie
omc config-stop-callback discord --remove-tag @here
omc config-stop-callback discord --clear-tags

Tag-Verhalten:

  • Telegram: alice wird zu @alice normalisiert
  • Discord: unterstützt @here, @everyone, numerische Benutzer-IDs und role:<id>
  • file-Callbacks ignorieren Tag-Optionen

OpenClaw-Integration

Leiten Sie Claude Code Session-Ereignisse an ein OpenClaw-Gateway weiter, um automatisierte Antworten und Workflows über Ihren OpenClaw-Agenten zu ermöglichen.

Schnelle Einrichtung (empfohlen):

/oh-my-claudecode:configure-notifications
# → Bei der Abfrage "openclaw" eingeben → "OpenClaw Gateway" wählen

Manuelle Einrichtung: Erstellen Sie ~/.claude/omc_config.openclaw.json:

{
  "enabled": true,
  "gateways": {
    "my-gateway": {
      "url": "https://your-gateway.example.com/wake",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" },
      "method": "POST",
      "timeout": 10000
    }
  },
  "hooks": {
    "session-start": { "gateway": "my-gateway", "instruction": "Session started for {{projectName}}", "enabled": true },
    "stop":          { "gateway": "my-gateway", "instruction": "Session stopping for {{projectName}}", "enabled": true }
  }
}

Umgebungsvariablen:

Variable Beschreibung
OMC_OPENCLAW=1 OpenClaw aktivieren
OMC_OPENCLAW_DEBUG=1 Debug-Protokollierung aktivieren
OMC_OPENCLAW_CONFIG=/path/to/config.json Konfigurationsdatei-Pfad überschreiben

Unterstützte Hook-Ereignisse (6 aktive in bridge.ts):

Ereignis Auslöser Wichtige Template-Variablen
session-start Session beginnt {{sessionId}}, {{projectName}}, {{projectPath}}
stop Claude-Antwort abgeschlossen {{sessionId}}, {{projectName}}
keyword-detector Bei jeder Prompt-Übermittlung {{prompt}}, {{sessionId}}
ask-user-question Claude fordert Benutzereingabe an {{question}}, {{sessionId}}
pre-tool-use Vor Tool-Aufruf (hohe Frequenz) {{toolName}}, {{sessionId}}
post-tool-use Nach Tool-Aufruf (hohe Frequenz) {{toolName}}, {{sessionId}}

Reply-Channel-Umgebungsvariablen:

Variable Beschreibung
OPENCLAW_REPLY_CHANNEL Antwortkanal (z.B. discord)
OPENCLAW_REPLY_TARGET Kanal-ID
OPENCLAW_REPLY_THREAD Thread-ID

Siehe scripts/openclaw-gateway-demo.mjs für ein Referenz-Gateway, das OpenClaw-Payloads über ClawdBot an Discord weiterleitet.


Dokumentation


Voraussetzungen

  • Claude Code CLI
  • Claude Max/Pro-Abonnement ODER Anthropic API-Schlüssel

Optional: Multi-AI-Orchestrierung

OMC kann optional externe AI-Anbieter für Kreuzvalidierung und Design-Konsistenz orchestrieren. Diese sind nicht erforderlich — OMC funktioniert vollständig ohne sie.

Anbieter Installation Was es ermöglicht
Gemini CLI npm install -g @google/gemini-cli Design-Review, UI-Konsistenz (1M Token Kontext)
Codex CLI npm install -g @openai/codex Architekturvalidierung, Code-Review-Gegenprüfung

Kosten: 3 Pro-Pläne (Claude + Gemini + ChatGPT) decken alles für ca. $60/Monat ab.


Lizenz

MIT


Inspiriert von: oh-my-opencodeclaude-hudSuperpowerseverything-claude-code

Null Lernkurve. Maximale Leistung.

Star History

Star History Chart

💖 Dieses Projekt unterstützen

Wenn Oh-My-ClaudeCode Ihren Workflow verbessert, erwägen Sie ein Sponsoring:

Sponsor on GitHub

Warum sponsern?

  • Aktive Entwicklung aufrechterhalten
  • Prioritäts-Support für Sponsoren
  • Einfluss auf Roadmap & Features
  • Freie und Open-Source-Wartung unterstützen

Andere Möglichkeiten zu helfen

  • ⭐ Dem Repository einen Stern geben
  • 🐛 Fehler melden
  • 💡 Features vorschlagen
  • 📝 Code beitragen