[English](README.md) | [한국어](README.ko.md) | [中文](README.zh.md) | [日本語](README.ja.md) | [Español](README.es.md) | [Tiếng Việt](README.vi.md) | [Português](README.pt.md) | [Русский](README.ru.md) | [Türkçe](README.tr.md) | [Deutsch](README.de.md) | Français | [Italiano](README.it.md)

# oh-my-claudecode

[![npm version](https://img.shields.io/npm/v/oh-my-claude-sisyphus?color=cb3837)](https://www.npmjs.com/package/oh-my-claude-sisyphus)
[![npm downloads](https://img.shields.io/npm/dm/oh-my-claude-sisyphus?color=blue)](https://www.npmjs.com/package/oh-my-claude-sisyphus)
[![GitHub stars](https://img.shields.io/github/stars/Yeachan-Heo/oh-my-claudecode?style=flat&color=yellow)](https://github.com/Yeachan-Heo/oh-my-claudecode/stargazers)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
[![Sponsor](https://img.shields.io/badge/Sponsor-❤️-red?style=flat&logo=github)](https://github.com/sponsors/Yeachan-Heo)
[![Discord](https://img.shields.io/discord/1452487457085063218?color=5865F2&logo=discord&logoColor=white&label=Discord)](https://discord.gg/sj4exxQ9v)

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

_N'apprenez pas Claude Code. Utilisez simplement OMC._

[Démarrer](#démarrage-rapide) • [Documentation](https://yeachan-heo.github.io/oh-my-claudecode-website) • [Guide de migration](docs/MIGRATION.md) • [Discord](https://discord.gg/sj4exxQ9v)

---

## Démarrage rapide

**Étape 1 : Installation**

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

**Étape 2 : Configuration**

```bash
/oh-my-claudecode:omc-setup
```

Si vous exécutez OMC via `omc --plugin-dir <path>` ou `claude --plugin-dir <path>`, ajoutez `--plugin-dir-mode` à `omc setup` (ou exportez `OMC_PLUGIN_ROOT` auparavant) pour éviter de dupliquer les compétences/agents que le plugin fournit déjà au moment de l'exécution. Consultez la [section Plugin directory flags dans REFERENCE.md](./docs/REFERENCE.md#plugin-directory-flags) pour une matrice de décision complète et tous les indicateurs disponibles.

<!-- TODO(i18n): verify translation -->

**É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**.

```bash
/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` :

```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`](https://www.npmjs.com/package/oh-my-claude-sisyphus). Si vous installez les outils CLI via npm/bun, utilisez `npm install -g oh-my-claude-sisyphus`.

### Mise à jour

```bash
# 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 :

```bash
/oh-my-claudecode:omc-doctor
```

<h1 align="center">Votre Claude vient de recevoir des super-pouvoirs.</h1>

<p align="center">
  <img src="assets/omc-character.jpg" alt="oh-my-claudecode" width="400" />
</p>

---

## 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 →](https://yeachan-heo.github.io/oh-my-claudecode-website/docs/#execution-modes)

| 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 magiques** — `ralph`, `ulw`, `eco`, `plan` pour un contrôle explicite
- **HUD statusline** — Métriques d'orchestration en temps réel dans votre barre d'état
  - Si vous lancez Claude Code directement avec `claude --plugin-dir <path>` (en contournant le shim `omc`), exportez `OMC_PLUGIN_ROOT=<path>` dans votre shell afin que le bundle HUD se résolve vers le même checkout que le chargeur de plugin. Voir [la section Plugin directory flags dans REFERENCE.md](./docs/REFERENCE.md#plugin-directory-flags) pour les détails.

  <!-- TODO(i18n): verify translation -->
- **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

### Contribuer

Vous souhaitez contribuer à OMC ? Voir [CONTRIBUTING.md](./CONTRIBUTING.md) pour le guide complet du développeur, incluant comment faire un fork, configurer un checkout local, le lier en tant que plugin actif, exécuter des tests et soumettre des PR.

<!-- TODO(i18n): verify translation -->

### 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) |

```yaml
# .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 :** `/skillify` 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 →](docs/REFERENCE.md)

---

## 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.

```bash
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.

```bash
# 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](https://openclaw.ai/) pour activer des réponses automatisées et des workflows via votre agent OpenClaw.

**Configuration rapide (recommandé) :**

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

**Configuration manuelle :** créez `~/.claude/omc_config.openclaw.json` :

```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

- **[Référence complète](docs/REFERENCE.md)** — Documentation complète des fonctionnalités
- **[Monitoring de performance](docs/PERFORMANCE-MONITORING.md)** — Suivi des agents, débogage et optimisation
- **[Site web](https://yeachan-heo.github.io/oh-my-claudecode-website)** — Guides interactifs et exemples
- **[Guide de migration](docs/MIGRATION.md)** — Mise à jour depuis v2.x
- **[Architecture](docs/ARCHITECTURE.md)** — Comment ça fonctionne en coulisses

---

## Prérequis

- [Claude Code](https://docs.anthropic.com/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](https://github.com/google-gemini/gemini-cli) | `npm install -g @google/gemini-cli` | Revue de design, cohérence UI (contexte de 1M tokens)          |
| [Codex CLI](https://github.com/openai/codex)              | `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

---

<div align="center">

**Inspiré par :** [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) • [claude-hud](https://github.com/ryanjoachim/claude-hud) • [Superpowers](https://github.com/NexTechFusion/Superpowers) • [everything-claude-code](https://github.com/affaan-m/everything-claude-code)

**Aucune courbe d'apprentissage. Puissance maximale.**

</div>

## Star History

[![Star History Chart](https://api.star-history.com/svg?repos=Yeachan-Heo/oh-my-claudecode&type=date&legend=top-left)](https://www.star-history.com/#Yeachan-Heo/oh-my-claudecode&type=date&legend=top-left)

## 💖 Soutenir ce projet

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

[![Sponsor on GitHub](https://img.shields.io/badge/Sponsor-❤️-red?style=for-the-badge&logo=github)](https://github.com/sponsors/Yeachan-Heo)

### 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
