Skip to content

Latest commit

 

History

History
320 lines (220 loc) · 14.9 KB

README.it.md

File metadata and controls

320 lines (220 loc) · 14.9 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

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.

oh-my-claudecode

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

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

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

Star History Chart

💖 Supporta questo progetto

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

Sponsor on GitHub

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