oh-my-claudecode

Orchestrazione multi-agente per Claude Code. Zero curva di apprendimento.

Non imparare Claude Code. Usa semplicemente OMC.

Inizia • Documentazione • Guida alla migrazione

Avvio rapido

Passo 1: Installazione

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

Passo 2: Configurazione

/oh-my-claudecode:omc-setup

Passo 3: Costruisci qualcosa

autopilot: build a REST API for managing tasks

Tutto qui. Il resto è automatico.

Team Mode (Consigliato)

A partire dalla v4.1.7, Team è la superficie di orchestrazione canonica in OMC. I punti di ingresso legacy come swarm e ultrapilot sono ancora supportati, ma ora vengono instradati a Team dietro le quinte.

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

Team funziona come una pipeline a stadi:

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

Abilita i team nativi di Claude Code in ~/.claude/settings.json:

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

Se i team sono disabilitati, OMC ti avviserà e passerà all'esecuzione senza Team quando possibile.

Nota: Nome del pacchetto — Il progetto utilizza il brand oh-my-claudecode (repo, plugin, comandi), ma il pacchetto npm è pubblicato come oh-my-claude-sisyphus. Se installi gli strumenti CLI tramite npm/bun, usa npm install -g oh-my-claude-sisyphus.

Aggiornamento

# 1. Aggiorna il plugin
/plugin install oh-my-claudecode

# 2. Riesegui il setup per aggiornare la configurazione
/oh-my-claudecode:omc-setup

Se riscontri problemi dopo l'aggiornamento, svuota la vecchia cache del plugin:

/oh-my-claudecode:omc-doctor

Il tuo Claude ha appena ricevuto dei superpoteri.

Perché oh-my-claudecode?

Nessuna configurazione richiesta — Funziona immediatamente con impostazioni predefinite intelligenti
Orchestrazione team-first — Team è la superficie multi-agente canonica (swarm/ultrapilot sono facciate di compatibilità)
Interfaccia in linguaggio naturale — Nessun comando da memorizzare, descrivi semplicemente ciò che vuoi
Parallelizzazione automatica — Le attività complesse vengono distribuite tra agenti specializzati
Esecuzione persistente — Non si arrende finché il lavoro non è verificato e completato
Ottimizzazione dei costi — Il routing intelligente dei modelli risparmia dal 30 al 50% sui token
Apprendimento dall'esperienza — Estrae e riutilizza automaticamente i pattern di risoluzione dei problemi
Visibilità in tempo reale — La HUD statusline mostra cosa succede dietro le quinte

Funzionalità

Modalità di orchestrazione

Strategie multiple per diversi casi d'uso — dall'orchestrazione basata su Team al refactoring efficiente in termini di token. Scopri di più →

Modalità	Descrizione	Utilizzo
Team (consigliato)	Pipeline canonica a stadi (`team-plan → team-prd → team-exec → team-verify → team-fix`)	Agenti coordinati che lavorano su una lista di attività condivisa
Autopilot	Esecuzione autonoma (singolo agente leader)	Sviluppo di funzionalità end-to-end con cerimonia minima
Ultrawork	Parallelismo massimo (senza Team)	Correzioni/refactoring paralleli in burst quando Team non è necessario
Ralph	Modalità persistente con cicli verify/fix	Attività che devono essere completate interamente (nessun risultato parziale silenzioso)
Ecomode	Routing efficiente in termini di token	Iterazione attenta al budget
Pipeline	Elaborazione sequenziale a stadi	Trasformazioni multi-step con ordine rigoroso
Swarm / Ultrapilot (legacy)	Facciate di compatibilità che instradano a Team	Workflow esistenti e documentazione precedente

Orchestrazione intelligente

32 agenti specializzati per architettura, ricerca, design, test, data science
Routing intelligente dei modelli — Haiku per attività semplici, Opus per ragionamento complesso
Delega automatica — L'agente giusto per il lavoro giusto, ogni volta

Esperienza sviluppatore

Parole chiave magiche — ralph, ulw, eco, plan per un controllo esplicito
HUD statusline — Metriche di orchestrazione in tempo reale nella barra di stato
Apprendimento delle competenze — Estrazione di pattern riutilizzabili dalle sessioni
Analisi e tracciamento dei costi — Comprensione dell'utilizzo dei token su tutte le sessioni

Competenze Personalizzate

Impara una volta, riutilizza per sempre. OMC estrae le conoscenze di debug duramente acquisite in file di competenze portabili che si iniettano automaticamente quando pertinenti.

	Ambito Progetto	Ambito Utente
Percorso	`.omc/skills/`	`~/.omc/skills/`
Condiviso con	Team (versionato)	Tutti i tuoi progetti
Priorità	Più alta (sovrascrive l'ambito utente)	Più bassa (fallback)

# .omc/skills/fix-proxy-crash.md
---
name: Fix Proxy Crash
description: aiohttp proxy crashes on ClientDisconnectedError
triggers: ["proxy", "aiohttp", "disconnected"]
source: extracted
---
Avvolgi l'handler in server.py:42 con try/except ClientDisconnectedError...

Gestione competenze: /skill list | add | remove | edit | search Auto-apprendimento: /learner estrae pattern riutilizzabili con criteri di qualità rigorosi Auto-iniezione: Le competenze corrispondenti si caricano automaticamente nel contesto — nessuna chiamata manuale necessaria

Lista completa delle funzionalità →

Parole chiave magiche

Scorciatoie opzionali per utenti avanzati. Il linguaggio naturale funziona bene anche senza di esse.

Parola chiave	Effetto	Esempio
`team`	Orchestrazione Team canonica	`/oh-my-claudecode:team 3:executor "fix all TypeScript errors"`
`autopilot`	Esecuzione completamente autonoma	`autopilot: build a todo app`
`ralph`	Modalità persistente	`ralph: refactor auth`
`ulw`	Parallelismo massimo	`ulw fix all errors`
`eco`	Esecuzione efficiente in termini di token	`eco: migrate database`
`plan`	Intervista di pianificazione	`plan the API`
`ralplan`	Consenso di pianificazione iterativo	`ralplan this feature`
`swarm`	Parola chiave legacy (instrada a Team)	`swarm 5 agents: fix lint errors`
`ultrapilot`	Parola chiave legacy (instrada a Team)	`ultrapilot: build a fullstack app`

Note:

ralph include ultrawork: quando attivi la modalità ralph, include automaticamente l'esecuzione parallela di ultrawork.
La sintassi swarm N agents è ancora riconosciuta per l'estrazione del numero di agenti, ma il runtime è basato su Team nella v4.1.7+.

Utilità

Attesa rate limit

Riprendi automaticamente le sessioni Claude Code quando i rate limit vengono ripristinati.

omc wait          # Controlla lo stato, ottieni indicazioni
omc wait --start  # Abilita il daemon di ripristino automatico
omc wait --stop   # Disabilita il daemon

Requisiti: tmux (per il rilevamento della sessione)

Tag di notifica (Telegram/Discord)

Puoi configurare chi viene taggato quando i callback di stop inviano i riepiloghi della sessione.

# Imposta/sostituisci la lista dei tag
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"

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

Comportamento dei tag:

Telegram: alice viene normalizzato in @alice
Discord: supporta @here, @everyone, ID utente numerici e role:<id>
I callback di tipo file ignorano le opzioni dei tag

Integrazione OpenClaw

Inoltra gli eventi di sessione di Claude Code a un gateway OpenClaw per abilitare risposte automatizzate e workflow tramite il tuo agente OpenClaw.

Configurazione rapida (consigliato):

/oh-my-claudecode:configure-notifications
# → Digita "openclaw" quando richiesto → scegli "OpenClaw Gateway"

Configurazione manuale: crea ~/.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 }
  }
}

Variabili d'ambiente:

Variabile	Descrizione
`OMC_OPENCLAW=1`	Abilita OpenClaw
`OMC_OPENCLAW_DEBUG=1`	Abilita il logging di debug
`OMC_OPENCLAW_CONFIG=/path/to/config.json`	Percorso alternativo del file di configurazione

Eventi hook supportati (6 attivi in bridge.ts):

Evento	Trigger	Variabili template principali
`session-start`	La sessione inizia	`{{sessionId}}`, `{{projectName}}`, `{{projectPath}}`
`stop`	La risposta di Claude è completata	`{{sessionId}}`, `{{projectName}}`
`keyword-detector`	A ogni invio di prompt	`{{prompt}}`, `{{sessionId}}`
`ask-user-question`	Claude richiede input dall'utente	`{{question}}`, `{{sessionId}}`
`pre-tool-use`	Prima dell'invocazione dello strumento (alta frequenza)	`{{toolName}}`, `{{sessionId}}`
`post-tool-use`	Dopo l'invocazione dello strumento (alta frequenza)	`{{toolName}}`, `{{sessionId}}`

Variabili d'ambiente del canale di risposta:

Variabile	Descrizione
`OPENCLAW_REPLY_CHANNEL`	Canale di risposta (es. `discord`)
`OPENCLAW_REPLY_TARGET`	ID del canale
`OPENCLAW_REPLY_THREAD`	ID del thread

Vedi scripts/openclaw-gateway-demo.mjs per un gateway di riferimento che inoltra i payload OpenClaw a Discord tramite ClawdBot.

Documentazione

Riferimento completo — Documentazione completa delle funzionalità
Monitoraggio delle prestazioni — Tracciamento degli agenti, debugging e ottimizzazione
Sito web — Guide interattive ed esempi
Guida alla migrazione — Aggiornamento dalla v2.x
Architettura — Come funziona dietro le quinte

Requisiti

Claude Code CLI
Abbonamento Claude Max/Pro OPPURE chiave API Anthropic

Opzionale: Orchestrazione Multi-AI

OMC può opzionalmente orchestrare provider AI esterni per la validazione incrociata e la coerenza del design. Non sono richiesti — OMC funziona completamente senza di essi.

Provider	Installazione	Cosa abilita
Gemini CLI	`npm install -g @google/gemini-cli`	Revisione del design, coerenza UI (contesto di 1M token)
Codex CLI	`npm install -g @openai/codex`	Validazione dell'architettura, verifica incrociata della code review

Costo: 3 piani Pro (Claude + Gemini + ChatGPT) coprono tutto per circa $60/mese.

Licenza

MIT

Ispirato da: oh-my-opencode • claude-hud • Superpowers • everything-claude-code

Zero curva di apprendimento. Potenza massima.

Star History

💖 Supporta questo progetto

Se Oh-My-ClaudeCode migliora il tuo workflow, considera di diventare sponsor:

Perché sponsorizzare?

Mantenere lo sviluppo attivo
Supporto prioritario per gli sponsor
Influenzare la roadmap e le funzionalità
Contribuire a mantenere il software libero e open source

Altri modi per aiutare

⭐ Metti una stella al repository
🐛 Segnala bug
💡 Suggerisci funzionalità
📝 Contribuisci al codice

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

oh-my-claudecode

Avvio rapido

Team Mode (Consigliato)

Aggiornamento

Il tuo Claude ha appena ricevuto dei superpoteri.

Perché oh-my-claudecode?

Funzionalità

Modalità di orchestrazione

Orchestrazione intelligente

Esperienza sviluppatore

Competenze Personalizzate

Parole chiave magiche

Utilità

Attesa rate limit

Tag di notifica (Telegram/Discord)

Integrazione OpenClaw

Documentazione

Requisiti

Opzionale: Orchestrazione Multi-AI

Licenza

Star History

💖 Supporta questo progetto

Perché sponsorizzare?

Altri modi per aiutare

FilesExpand file tree

README.it.md

Latest commit

History

README.it.md

File metadata and controls

oh-my-claudecode

Avvio rapido

Team Mode (Consigliato)

Aggiornamento

Il tuo Claude ha appena ricevuto dei superpoteri.

Perché oh-my-claudecode?

Funzionalità

Modalità di orchestrazione

Orchestrazione intelligente

Esperienza sviluppatore

Competenze Personalizzate

Parole chiave magiche

Utilità

Attesa rate limit

Tag di notifica (Telegram/Discord)

Integrazione OpenClaw

Documentazione

Requisiti

Opzionale: Orchestrazione Multi-AI

Licenza

Star History

💖 Supporta questo progetto

Perché sponsorizzare?

Altri modi per aiutare