Skip to content

Latest commit

 

History

History
346 lines (241 loc) · 16.3 KB

File metadata and controls

346 lines (241 loc) · 16.3 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 Discord

Orchestration multi-agents pour Claude Code. Aucune courbe d'apprentissage.

N'apprenez pas Claude Code. Utilisez simplement OMC.

DémarrerDocumentationGuide de migration


Démarrage rapide

Étape 1 : Installation

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

Étape 2 : Configuration

/oh-my-claudecode:omc-setup

Étape 3 : Construisez quelque chose

autopilot: build a REST API for managing tasks

C'est tout. Le reste est automatique.

Team Mode (Recommandé)

À partir de la v4.1.7, Team est la surface d'orchestration canonique dans OMC. Les anciens points d'entrée comme swarm et ultrapilot sont toujours supportés, mais redirigent désormais vers Team en coulisses.

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

Team fonctionne comme un pipeline par étapes :

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

Activez les teams natifs de Claude Code dans ~/.claude/settings.json :

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

Si les teams sont désactivés, OMC vous avertira et basculera vers une exécution sans Team lorsque possible.

Note : Nom du package — Le projet utilise la marque oh-my-claudecode (repo, plugin, commandes), mais le package npm est publié sous le nom oh-my-claude-sisyphus. Si vous installez les outils CLI via npm/bun, utilisez npm install -g oh-my-claude-sisyphus.

Mise à jour

# 1. Mettre à jour le plugin
/plugin install oh-my-claudecode

# 2. Relancer le setup pour actualiser la configuration
/oh-my-claudecode:omc-setup

Si vous rencontrez des problèmes après la mise à jour, videz l'ancien cache du plugin :

/oh-my-claudecode:omc-doctor

Votre Claude vient de recevoir des super-pouvoirs.

oh-my-claudecode


Pourquoi oh-my-claudecode ?

  • Aucune configuration requise — Fonctionne directement avec des valeurs par défaut intelligentes
  • Orchestration team-first — Team est la surface multi-agents canonique (swarm/ultrapilot sont des façades de compatibilité)
  • Interface en langage naturel — Aucune commande à mémoriser, décrivez simplement ce que vous voulez
  • Parallélisation automatique — Les tâches complexes sont distribuées entre des agents spécialisés
  • Exécution persistante — N'abandonne pas tant que le travail n'est pas vérifié et terminé
  • Optimisation des coûts — Le routage intelligent des modèles économise 30 à 50 % sur les tokens
  • Apprentissage par l'expérience — Extrait et réutilise automatiquement les patterns de résolution de problèmes
  • Visibilité en temps réel — La HUD statusline montre ce qui se passe en coulisses

Fonctionnalités

Modes d'orchestration

Plusieurs stratégies pour différents cas d'utilisation — de l'orchestration Team au refactoring économe en tokens. En savoir plus →

Mode Description Utilisation
Team (recommandé) Pipeline canonique par étapes (team-plan → team-prd → team-exec → team-verify → team-fix) Agents coordonnés travaillant sur une liste de tâches partagée
Autopilot Exécution autonome (un seul agent leader) Développement de fonctionnalités de bout en bout avec un minimum de cérémonie
Ultrawork Parallélisme maximal (sans Team) Corrections/refactorings parallèles en rafale quand Team n'est pas nécessaire
Ralph Mode persistant avec boucles verify/fix Tâches devant être entièrement complétées (pas de résultats partiels silencieux)
Ecomode Routage économe en tokens Itération soucieuse du budget
Pipeline Traitement séquentiel par étapes Transformations multi-étapes avec un ordre strict
Swarm / Ultrapilot (ancien) Façades de compatibilité redirigeant vers Team Workflows existants et ancienne documentation

Orchestration intelligente

  • 32 agents spécialisés pour l'architecture, la recherche, le design, les tests, la data science
  • Routage intelligent des modèles — Haiku pour les tâches simples, Opus pour le raisonnement complexe
  • Délégation automatique — Le bon agent pour le bon travail, à chaque fois

Expérience développeur

  • Mots-clés magiquesralph, ulw, eco, plan pour un contrôle explicite
  • HUD statusline — Métriques d'orchestration en temps réel dans votre barre d'état
  • Apprentissage de compétences — Extraction de patterns réutilisables depuis vos sessions
  • Analytique et suivi des coûts — Compréhension de l'utilisation des tokens sur toutes les sessions

Compétences Personnalisées

Apprenez une fois, réutilisez à jamais. OMC extrait les connaissances durement acquises lors du débogage en fichiers de compétences portables qui s'injectent automatiquement quand pertinent.

Portée Projet Portée Utilisateur
Chemin .omc/skills/ ~/.omc/skills/
Partagé avec Équipe (versionné) Tous vos projets
Priorité Haute (écrase la portée utilisateur) Basse (repli)
# .omc/skills/fix-proxy-crash.md
---
name: Fix Proxy Crash
description: aiohttp proxy crashes on ClientDisconnectedError
triggers: ["proxy", "aiohttp", "disconnected"]
source: extracted
---
Enveloppez le handler à server.py:42 dans try/except ClientDisconnectedError...

Gestion des compétences : /skill list | add | remove | edit | search Auto-apprentissage : /learner extrait des patterns réutilisables avec des critères de qualité stricts Auto-injection : Les compétences correspondantes se chargent automatiquement dans le contexte — aucun rappel manuel nécessaire

Liste complète des fonctionnalités →


Mots-clés magiques

Raccourcis optionnels pour les utilisateurs avancés. Le langage naturel fonctionne très bien sans eux.

Mot-clé Effet Exemple
team Orchestration Team canonique /oh-my-claudecode:team 3:executor "fix all TypeScript errors"
autopilot Exécution entièrement autonome autopilot: build a todo app
ralph Mode persistant ralph: refactor auth
ulw Parallélisme maximal ulw fix all errors
eco Exécution économe en tokens eco: migrate database
plan Entretien de planification plan the API
ralplan Consensus de planification itératif ralplan this feature
swarm Ancien mot-clé (redirige vers Team) swarm 5 agents: fix lint errors
ultrapilot Ancien mot-clé (redirige vers Team) ultrapilot: build a fullstack app

Notes :

  • ralph inclut ultrawork : lorsque vous activez le mode ralph, il inclut automatiquement l'exécution parallèle d'ultrawork.
  • La syntaxe swarm N agents est toujours reconnue pour l'extraction du nombre d'agents, mais le runtime est basé sur Team dans v4.1.7+.

Utilitaires

Attente de rate limit

Reprise automatique des sessions Claude Code lorsque les rate limits sont réinitialisés.

omc wait          # Vérifier le statut, obtenir des conseils
omc wait --start  # Activer le daemon de reprise automatique
omc wait --stop   # Désactiver le daemon

Prérequis : tmux (pour la détection de session)

Tags de notification (Telegram/Discord)

Vous pouvez configurer qui est mentionné lorsque les callbacks d'arrêt envoient des résumés de session.

# Définir/remplacer la liste des tags
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"

# Mises à jour incrémentales
omc config-stop-callback telegram --add-tag charlie
omc config-stop-callback discord --remove-tag @here
omc config-stop-callback discord --clear-tags

Comportement des tags :

  • Telegram : alice est normalisé en @alice
  • Discord : supporte @here, @everyone, les IDs utilisateur numériques et role:<id>
  • Les callbacks de type file ignorent les options de tags

Intégration OpenClaw

Transmettez les événements de session Claude Code vers une passerelle OpenClaw pour activer des réponses automatisées et des workflows via votre agent OpenClaw.

Configuration rapide (recommandé) :

/oh-my-claudecode:configure-notifications
# → Tapez "openclaw" quand demandé → choisir "OpenClaw Gateway"

Configuration manuelle : créez ~/.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 }
  }
}

Variables d'environnement :

Variable Description
OMC_OPENCLAW=1 Activer OpenClaw
OMC_OPENCLAW_DEBUG=1 Activer la journalisation de débogage
OMC_OPENCLAW_CONFIG=/path/to/config.json Chemin alternatif du fichier de configuration

Événements hook pris en charge (6 actifs dans bridge.ts) :

Événement Déclencheur Variables de template principales
session-start La session démarre {{sessionId}}, {{projectName}}, {{projectPath}}
stop La réponse de Claude est terminée {{sessionId}}, {{projectName}}
keyword-detector À chaque soumission de prompt {{prompt}}, {{sessionId}}
ask-user-question Claude demande une saisie utilisateur {{question}}, {{sessionId}}
pre-tool-use Avant l'invocation d'outil (fréquence élevée) {{toolName}}, {{sessionId}}
post-tool-use Après l'invocation d'outil (fréquence élevée) {{toolName}}, {{sessionId}}

Variables d'environnement du canal de réponse :

Variable Description
OPENCLAW_REPLY_CHANNEL Canal de réponse (ex. discord)
OPENCLAW_REPLY_TARGET ID du canal
OPENCLAW_REPLY_THREAD ID du thread

Voir scripts/openclaw-gateway-demo.mjs pour un gateway de référence qui relaie les payloads OpenClaw vers Discord via ClawdBot.


Documentation


Prérequis

  • Claude Code CLI
  • Abonnement Claude Max/Pro OU clé API Anthropic

Optionnel : Orchestration Multi-AI

OMC peut optionnellement orchestrer des fournisseurs d'IA externes pour la validation croisée et la cohérence du design. Ils ne sont pas requis — OMC fonctionne pleinement sans eux.

Fournisseur Installation Ce que ça apporte
Gemini CLI npm install -g @google/gemini-cli Revue de design, cohérence UI (contexte de 1M tokens)
Codex CLI npm install -g @openai/codex Validation d'architecture, vérification croisée de code review

Coût : 3 plans Pro (Claude + Gemini + ChatGPT) couvrent tout pour environ 60 $/mois.


Licence

MIT


Inspiré par : oh-my-opencodeclaude-hudSuperpowerseverything-claude-code

Aucune courbe d'apprentissage. Puissance maximale.

Star History

Star History Chart

💖 Soutenir ce projet

Si Oh-My-ClaudeCode améliore votre workflow, envisagez de devenir sponsor :

Sponsor on GitHub

Pourquoi sponsoriser ?

  • Maintenir le développement actif
  • Support prioritaire pour les sponsors
  • Influencer la roadmap et les fonctionnalités
  • Aider à maintenir le logiciel libre et open source

Autres façons d'aider

  • ⭐ Mettre une étoile au dépôt
  • 🐛 Signaler des bugs
  • 💡 Suggérer des fonctionnalités
  • 📝 Contribuer au code