# oh-my-agent: Portable Multi-Agent Harness [![npm version](https://img.shields.io/npm/v/oh-my-agent?color=cb3837&logo=npm)](https://www.npmjs.com/package/oh-my-agent) [![npm downloads](https://img.shields.io/npm/dm/oh-my-agent?color=cb3837&logo=npm)](https://www.npmjs.com/package/oh-my-agent) [![GitHub stars](https://img.shields.io/github/stars/first-fluke/oh-my-agent?style=flat&logo=github)](https://github.com/first-fluke/oh-my-agent) [![License](https://img.shields.io/github/license/first-fluke/oh-my-agent)](https://github.com/first-fluke/oh-my-agent/blob/main/LICENSE) [![Last Updated](https://img.shields.io/github/last-commit/first-fluke/oh-my-agent?label=updated&logo=git)](https://github.com/first-fluke/oh-my-agent/commits/main) [English](../README.md) | [한국어](./README.ko.md) | [中文](./README.zh.md) | [Português](./README.pt.md) | [日本語](./README.ja.md) | [Español](./README.es.md) | [Nederlands](./README.nl.md) | [Polski](./README.pl.md) | [Русский](./README.ru.md) | [Deutsch](./README.de.md) | [Tiếng Việt](./README.vi.md) | [ภาษาไทย](./README.th.md) Tu as déjà rêvé que ton assistant IA ait des collègues ? C'est exactement ce que fait oh-my-agent. Au lieu qu'une seule IA fasse tout (et se perde en route), oh-my-agent répartit le boulot entre des **agents spécialisés** : frontend, backend, architecture, QA, PM, DB, mobile, infra, debug, design, et plus encore. Chacun connaît son domaine sur le bout des doigts, a ses propres outils et checklists, et reste dans sa voie. Compatible avec tous les principaux IDEs IA : Antigravity, Claude Code, Codex, Cursor, Grok Build, Kimi Code, OpenCode, Pi, Qwen Code, et d'autres. ## Démarrage Rapide ```bash # macOS / Linux — installe bun, uv & serena automatiquement si absents curl -fsSL https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.sh | bash ``` ```powershell # Windows (PowerShell) — installe bun, uv & serena automatiquement si absents irm https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.ps1 | iex ``` ```bash # Ou manuellement (n'importe quel OS, nécessite bun + uv + serena) bunx oh-my-agent@latest ``` ### Installation via Agent Package Manager

L'Agent Package Manager (APM) de Microsoft : distribution skills uniquement. Clique pour déplier.

> À ne pas confondre avec l'APM (Application Performance Monitoring) d'`oma-observability`. ```bash # Tous les skills, déployés sur chaque runtime détectée # (.claude, .cursor, .codex, .opencode, .github, .agents) apm install first-fluke/oh-my-agent # Un seul skill apm install first-fluke/oh-my-agent/.agents/skills/oma-frontend ``` APM ne livre que les skills. Pour les workflows, les règles, `oma-config.yaml`, les hooks de détection de mots-clés et la CLI `oma agent:spawn`, utilise `bunx oh-my-agent@latest`. Une seule méthode de distribution par projet, sinon ça finit par diverger.

Choisis un preset et c'est parti : | Preset | Ce Que Tu Obtiens | |--------|-------------| | ✨ All | Tous les agents et skills | | 🌐 Fullstack | architecture + frontend + backend + db + pm + qa + debug + brainstorm + scm | | 🎨 Frontend | architecture + frontend + pm + qa + debug + brainstorm + scm | | ⚙️ Backend | architecture + backend + db + pm + qa + debug + brainstorm + scm | | 📱 Mobile | architecture + mobile + pm + qa + debug + brainstorm + scm | | 🚀 DevOps | architecture + tf-infra + dev-workflow + pm + qa + debug + brainstorm + scm | ## Compatible avec Tous les Agents `oh-my-agent` conserve `.agents/` comme source unique de vérité (SSOT) et la projette dans la disposition native de chaque runtime. Tous les outils pris en charge partagent ainsi les mêmes skills, workflows et règles.

Claude Code _{natif + adaptateur}	Codex CLI _{natif + adaptateur}	Antigravity _{SSOT natif}	Cursor _{natif + adaptateur}	Qwen Code _{dispatch natif}	Reasonix _{compatible nativement}
Pi _{compatible nativement}	OpenCode _{compatible nativement}	Amp _{compatible nativement}	GitHub Copilot _{skills via symlink}	Grok Build _{hooks natifs}	Kiro CLI _{hooks natifs + agents}

_{& plus}

## Ton Équipe d'Agents | Agent | Ce Qu'il Fait | |-------|-------------| | **oma-academic-writer** | Rédige, révise et audite ta prose académique jusqu'à la qualité publication | | **oma-architecture** | Évalue les arbitrages d'architecture et trace les frontières de modules avec une analyse ADR/ATAM/CBAM | | **oma-backend** | Construit et sécurise tes APIs en Python, Node.js ou Rust | | **oma-brainstorm** | Explore les idées avec toi avant de te lancer dans le code | | **oma-coordination** | Guide la coordination manuelle pas à pas des agents PM, frontend, backend, mobile et QA | | **oma-db** | Conçoit tes schémas, migrations, index et vector stores | | **oma-debug** | Identifie la cause racine, corrige le bug et écrit un test de régression | | **oma-deepsec** | Scanne ton code pour détecter les failles de sécurité et bloque les pull requests à risque | | **oma-design** | Construit des systèmes de design avec tokens, accessibilité et layouts responsive | | **oma-dev-workflow** | Automatise ton CI/CD, tes releases et tes tâches monorepo | | **oma-docs** | Vérifie les références cassées dans ta doc et signale les pages touchées par un changement de code | | **oma-frontend** | Construit ton UI avec React/Next.js, TypeScript, Tailwind CSS v4 et shadcn/ui | | **oma-hwp** | Convertit les fichiers HWP, HWPX et HWPML en Markdown | | **oma-image** | Génère des images via plusieurs fournisseurs d'IA en parallèle | | **oma-market** | Analyse ton marché à partir de signaux communautaires et le structure avec SWOT, Porter's 5F et PESTEL | | **oma-mobile** | Construit des apps multiplateformes avec Flutter | | **oma-observability** | Route les tâches d'observabilité entre métriques, logs, traces, SLOs et forensique d'incidents | | **oma-orchestrator** | Lance plusieurs agents en parallèle depuis la CLI | | **oma-pdf** | Convertit les fichiers PDF en Markdown | | **oma-pm** | Planifie les tâches, découpe les exigences et définit les contrats d'API | | **oma-qa** | Passe ton code en revue pour détecter les failles OWASP, les problèmes de performance et d'accessibilité | | **oma-recap** | Résume ton historique de conversations en synthèses de travail organisées par thème | | **oma-refactor** | Refactorise le code sans changer son comportement grâce au ciblage des hotspots, aux tests de caractérisation et aux commits dédiés au refactor | | **oma-scholar** | Explore la littérature académique et t'aide à mener une évaluation par les pairs | | **oma-scm** | Gère tes branches, fusions, worktrees et Conventional Commits | | **oma-search** | Route chaque requête vers la meilleure source et évalue le niveau de confiance du résultat | | **oma-skill-creator** | Rédige et audite les nouveaux skills OMA au format SSL-lite | | **oma-slide** | Génère des decks de présentation HTML distinctifs riches en animations et exporte vers PDF/PNG/PPTX | | **oma-tf-infra** | Provisionne une infrastructure multi-cloud avec Terraform | | **oma-translator** | Traduit entre les langues comme si un natif avait écrit le texte | | **oma-video** | Génère des vidéos courtes, explicatives et de démo via un pipeline Remotion utilisable sans clés | | **oma-voice** | Génère des voix off et transcrit de l'audio en local, sans cloud | ## Comment Ça Marche Discute, tout simplement. Décris ce que tu veux et oh-my-agent choisit les bons agents. ``` Toi : "Construis une app TODO avec authentification" → PM planifie le travail → Backend construit l'API d'auth → Frontend construit l'UI React → DB conçoit le schéma → QA passe tout en revue → Terminé : code coordonné et vérifié ``` Ou utilise les slash commands pour des workflows structurés : | Étape | Commande | Description | |-------|----------|-------------| | 0 | `/deepinit` | Cartographie ta base de code existante dans AGENTS.md, ARCHITECTURE.md et docs | | 1 | `/brainstorm` | Explore les idées avec toi avant que tu te lances dans la construction | | 2 | `/architecture` | Pèse les arbitrages de ta conception et trace des frontières de modules nettes | | 2 | `/design` | Construit ton système de design avec tokens, accessibilité et mises en page responsive | | 2 | `/plan` | Découpe ta feature en tâches priorisées | | 3 | `/work` | Construit ta feature étape par étape sur plusieurs agents | | 3 | `/orchestrate` | Lance plusieurs agents en parallèle pour construire ta feature plus vite | | 3 | `/ultrawork` | Construit ta feature à travers cinq phases qualité et onze portes de revue | | 3 | `/ralph` | Répète `/ultrawork` jusqu'à ce qu'un vérificateur indépendant valide chaque critère | | 4 | `/review` | Revoit ton code pour les problèmes de sécurité, de performance et d'accessibilité | | 4 | `/deepsec` | Lance un scan de sécurité profond et bloque les pull requests à risque | | 5 | `/debug` | Trouve la cause racine, corrige le bug et écrit un test de régression | | 5 | `/docs` | Vérifie tes docs pour les références cassées et corrige celles que touchent tes changements de code | | 6 | `/scm` | Gère tes branches, tes merges et les Conventional Commits | | - | `/schedule` | Planifie une tâche d'agent à exécuter sur un intervalle récurrent | **Auto-détection** : Tu n'as même pas besoin des slash commands. Des mots-clés comme "architecture", "plan", "review" et "debug" dans ton message (en 11 langues !) activent automatiquement le bon workflow. ### Modèles par agent Chaque agent peut cibler son propre modèle et son `effort` via `.agents/oma-config.yaml`. Runtime profiles prêts à l'emploi : `antigravity`, `claude`, `codex`, `cursor`, `kiro`, `mixed`, `qwen`. Vérifiez la matrice d'auth résolue avec `oma doctor --profile`. Guide complet : [web/docs/guide/per-agent-models.md](../web/docs/guide/per-agent-models.md). ## Pourquoi oh-my-agent ? > [En savoir plus →](https://github.com/first-fluke/oh-my-agent/issues/155#issuecomment-4142133589) - **Portable** : `.agents/` voyage avec ton projet, pas enfermé dans un IDE - **Basé sur les rôles** : des agents modélisés comme une vraie équipe d'ingé, pas un tas de prompts - **Économe en tokens** : le design de skills à deux couches économise ~75% de tokens - **Qualité d'abord** : Charter preflight, quality gates et workflows de revue intégrés : - `oma verify ` — 14 vérifications déterministes par type d'agent (TypeScript strict, tests, raw SQL, secrets hardcodés, Flutter analyze, inline styles, scope violation, charter alignment, …) - `session.quota_cap` — quotas de tokens / spawn / par-vendor par session dans `oma-config.yaml` ; le Step 5 d'`orchestrate` bloque le prochain spawn en cas de dépassement - workflow `ralph` — un JUDGE indépendant re-vérifie chaque criterion à chaque itération pour détecter les régressions silencieuses ; cache pour les tests >30s - Exploration Loop — après 2 retries, `orchestrate` spawn des variantes d'hypothèse en parallèle et conserve la meilleure note - Auto-routing monorepo — `detectWorkspace` lit pnpm / nx / turbo / lerna et route chaque agent vers son workspace - **Multi-vendor** : mélange Antigravity, Claude, Codex, Cursor, Kiro et Qwen par type d'agent - **Observable** : dashboards terminal et web pour le monitoring en temps réel ## Architecture ```mermaid flowchart TD subgraph Workflows["Workflows"] direction TB W0["/brainstorm"] W1["/work"] W1b["/ultrawork"] W2["/orchestrate"] W3["/architecture"] W4["/plan"] W5["/review"] W6["/debug"] W7["/deepinit"] W8["/design"] end subgraph Orchestration["Orchestration"] direction TB PM[oma-pm] ORC[oma-orchestrator] end subgraph Domain["Domain Agents"] direction TB ARC[oma-architecture] FE[oma-frontend] BE[oma-backend] DB[oma-db] MB[oma-mobile] DES[oma-design] TF[oma-tf-infra] end subgraph Quality["Quality"] direction TB QA[oma-qa] DBG[oma-debug] end Workflows --> Orchestration Orchestration --> Domain Domain --> Quality Quality --> SCM([oma-scm]) ``` ## En Savoir Plus - **[Documentation Détaillée](./AGENTS_SPEC.md)** : spec technique complète et architecture - **[Agents Supportés](./SUPPORTED_AGENTS.md)** : matrice de support des agents par IDE - **[Docs Web](https://first-fluke.github.io/oh-my-agent/)** : guides, tutoriels et référence CLI ## Sponsors Ce projet est maintenu grâce à nos généreux sponsors. > **Tu aimes ce projet ?** Mets-lui une étoile ! > > ```bash > gh api --method PUT /user/starred/first-fluke/oh-my-agent > ``` > > Essaie notre template starter optimisé : [fullstack-starter](https://github.com/first-fluke/fullstack-starter)

### 🚀 Champion ### 🛸 Booster ### ☕ Contributor [Devenir sponsor →](https://github.com/sponsors/first-fluke) Voir [SPONSORS.md](../SPONSORS.md) pour la liste complète des supporters. ## Star History [![Star History Chart](https://api.star-history.com/svg?repos=first-fluke/oh-my-agent&type=date&legend=bottom-right)](https://www.star-history.com/#first-fluke/oh-my-agent&type=date&legend=bottom-right) ## Références - Liang, Q., Wang, H., Liang, Z., & Liu, Y. (2026). *From skill text to skill structure: The scheduling-structural-logical representation for agent skills* (Version 4) [Preprint]. arXiv. https://doi.org/10.48550/arXiv.2604.24026 - Chen, C., Yu, Q., Gu, Y., Huang, Z., Li, H., Liu, H., Liu, S., Liu, J., Peng, D., Wang, J., Yan, Z., Meng, F., Qin, E., Che, C., & Hu, M. (2026). *The scaling laws of skills in LLM agent systems* (Version 1) [Preprint]. arXiv. https://doi.org/10.48550/arXiv.2605.16508 - Yang, Y., Gong, Z., Huang, W., Yang, Q., Zhou, Z., Huang, Z., Li, Y., Gao, X., Dai, Q., Liu, B., Qiu, K., Yang, Y., Chen, D., Yang, X., & Luo, C. (2026). *SkillOpt: Executive strategy for self-evolving agent skills* [Preprint]. arXiv. https://doi.org/10.48550/arXiv.2605.23904 - Huang, Z., Xu, J., Yang, Y., Gong, Z., Yang, Q., Tian, M., Wang, X., Lv, C., Gao, X., Dai, Q., Liu, B., Qiu, K., Yang, X., Chen, D., Zheng, X., & Luo, C. (2026). *From raw experience to skill consumption: A systematic study of model-generated agent skills* [Preprint]. arXiv. https://doi.org/10.48550/arXiv.2605.23899 ## Licence MIT