Oh My Pi vs Pi: il fork, le differenze e quale eseguire

Oh My Pi è un fork di Pi, non un concorrente cresciuto al suo fianco: il codice è confluito da Pi a Oh My Pi, entrambi i progetti sono ancora attivi oggi e ora ottimizzano obiettivi opposti. Pi è un harness terminale volutamente minimale, che si estende in TypeScript. Oh My Pi è la stessa linea di discendenza ricostruita come ambiente di coding completo, con LSP, debugger, subagenti e uno strumento browser integrati. Entrambi sono distribuiti con licenza MIT e costano $0 da installare, quindi la scelta riguarda il flusso di lavoro, il modello di esecuzione e il formato di configurazione, non il costo della licenza.

Prima i nomi, perché tre di essi si sovrappongono. Pi qui indica l'harness dell'agente su pi.dev, pubblicato da Earendil Works in earendil-works/pi. Non è Pi di Inflection AI (pi.ai), né la moneta Pi Network, né Raspberry Pi. Oh My Pi indica l'agente su omp.sh di can1357/oh-my-pi, il cui binario è omp: non le panetterie che dominano una ricerca di quella frase, né Oh My Zsh o Oh My Posh, nonostante l'eco nel nome. E pi-mono non è un terzo prodotto: è il vecchio nome del repository di Pi. github.com/badlogic/pi-mono ora restituisce un 301 verso earendil-works/pi, anche se la documentazione di terze parti usa ancora il vecchio percorso: la pagina ufficiale d'integrazione di DeepSeek si trova letteralmente in /agent_integrations/pi_mono/.

Vale la pena chiarire la direzione del fork, perché le ricerche vanno in entrambe le direzioni e la risposta non è simmetrica. Il README di Oh My Pi dichiara nel proprio titolo di essere un "Fork of Pi by @mariozechner", collegandosi all'URL precedente al cambio di nome. GitHub riporta fork: false e parent: null per questo repository, perché si tratta di un fork del codice sorgente e non del pulsante Fork: quindi l'API non te lo dirà. Il repository contiene ancora docs/porting-from-pi-mono.md, una checklist di merge il cui Last Sync Point registrato è il commit b21b42d, datato 22 marzo 2026. Questo indicatore è l'unica prova della divergenza disponibile dall'esterno; questa pagina non può confermare se sia avvenuta una sincronizzazione successiva non registrata.

Oh My Pi e Pi: quale scegliere?

Sono cinque gli assi che determinano la scelta, indipendentemente dalla direzione da cui sei arrivato, e solo uno riguarda le funzionalità.

• Flusso di lavoro. Scegli Pi se vuoi un nucleo ridotto e intendi scrivere da solo le parti mancanti. Fino all'aggiornamento della documentazione del 22 settembre 2026, la documentazione d'uso dichiarava che "intentionally does not include built-in MCP, sub-agents, permission popups, plan mode, to-dos, or background bash" e rimandava invece a estensioni, pacchetti, container e tmux. L'aggiornamento ha rimosso quella frase e v0.99.0 ha poi reso MCP un'estensione integrata caricata per impostazione predefinita; subagenti, modalità piano, attività e richieste di approvazione sono ancora estensioni in v0.99.2. Scegli Oh My Pi se vuoi queste funzioni incluse fin dal primo giorno e non vuoi mantenere un'estensione.
• Permessi e modello di esecuzione. Nessuna delle due impostazioni predefinite è quella sicura, quindi scegli quale modalità di errore puoi accettare. Pi non ha un sistema di permessi e lo dichiara esplicitamente. Oh My Pi ne ha uno reale a tre livelli e viene fornito con yolo come impostazione predefinita. Se ti servono richieste di conferma per singolo strumento, Oh My Pi può fornirtele dopo una riga di configurazione; Pi non può farlo senza un'estensione.
• Protocollo e limiti del piano. Se il percorso del modello è un endpoint di terze parti compatibile con OpenAI o Anthropic, entrambi possono raggiungerlo, ma Oh My Pi documenta nove dialetti wire mentre Pi ne documentava quattro fino all'aggiornamento della documentazione del 22 settembre 2026, e aggiunge un percorso tramite variabile d'ambiente che Pi non ha. Il divario tra i dialetti è più ristretto nel codice che sulla carta: il codice sorgente di Pi in v0.99.2 inoltra api di un provider personalizzato a una delle dieci implementazioni integrate, sei delle quali non sono mai state documentate per questo uso. Se il tuo percorso è un abbonamento OAuth — Claude Pro/Max, Codex, GitHub Copilot — entrambi i client lo collegano tramite /login e memorizzano un token del fornitore, che un gateway intermedio rifiuterebbe; la documentazione dei provider di Oh My Pi indica proprio questo come motivo per cui una chiave models.yml ha deliberatamente la precedenza sull'OAuth memorizzato. Non includere in questo gruppo i piani di coding cinesi: Pi elenca ZAI/GLM, Kimi For Coding e Qwen Token Plans nella propria tabella delle chiavi API (ZAI_API_KEY, KIMI_API_KEY, QWEN_TOKEN_PLAN_API_KEY), mentre Oh My Pi li contrassegna come plan anziché oauth, quindi in entrambi sono provider ordinari basati su chiave.
• Percorso dei costi. Il client è gratuito da entrambe le parti e nessuno dei due modifica la tariffa per token. L'asimmetria è che Pi dispone di un gateway a pagamento di prima parte (Radius, gestito dalla stessa azienda) collegato al proprio /login, mentre Oh My Pi non vende alcun percorso ospitato: l'unico server che gestisce è il relay dietro i link di sessione /collab, che non applica costi.
• Costo della migrazione. All'incirca un blocco provider, da riscrivere. I formati e le directory di configurazione sono diversi — JSON in ~/.pi, YAML in ~/.omp — e nessuno dei due repository documenta uno strumento d'importazione. Alcuni nomi di variabili d'ambiente sono condivisi, con le precisazioni riportate sotto.

Cosa non dovrebbe determinarla: i numeri di versione. Oh My Pi ha riassegnato la numerazione al momento del fork, quindi 18.2.7 e 0.86.1 di Pi appartengono a schemi diversi, non sono diciotto versioni di maturità aggiuntiva.

Cosa differisce realmente tra i due

Letto dalla documentazione dei due repository il 19 settembre 2026: le pagine di Pi overview, security e models, e le pagine di Oh My Pi README, approval-mode e providers. Le righe relative a design dichiarato, MCP, modello dei permessi e dialetti di Pi sono state ricontrollate il 1° ottobre 2026 sulla documentazione aggiornata, sul README e sul codice sorgente in v0.99.2. I conteggi delle funzionalità nella riga di Oh My Pi sono dichiarazioni dello stesso progetto; non è pubblicata alcuna metodologia e anche la tabella dei benchmark del README è una dichiarazione del fornitore che questa pagina non riproduce.

Entrambi sono attivi. Nessuna delle due metriche stabilisce "quale sia più grande"

L'errore più comune su questa coppia consiste nel trattare uno dei due come abbandonato o superato. Entrambi hanno pubblicato codice il giorno di questa verifica.

Dati del repository, delle release e delle stelle dall'API di GitHub, letti il 21 settembre 2026; conteggi dei download dall'API dei download di npm per la settimana terminata il 16 settembre 2026. Non trasformare nessuna delle due colonne in un verdetto sull'adozione. In particolare, il confronto npm non è omogeneo: la documentazione di Pi inizia con npm install -g, mentre il README di Oh My Pi documenta curl-to-shell, Homebrew, Bun, Nix, PowerShell e mise e non fornisce mai un comando npm, quindi npm lo sottostima in misura che qui non è possibile quantificare. Le stelle favoriscono Pi; la cadenza delle release favorisce Oh My Pi; qualsiasi frase sulla popolarità basata su una sola metrica sarà errata almeno in una direzione.

Prove neutrali di terze parti che entrambi sono aggiornati, se vuoi escludere le metriche: Ollama pubblica una pagina d'integrazione per Oh My Pi e una per Pi, e DeepSeek pubblica una guida d'integrazione dell'agente per entrambi — la guida per Pi è ancora archiviata nel vecchio percorso pi_mono. Tutte e quattro le pagine hanno risposto il 21 settembre 2026.

Indirizzare l'uno o l'altro verso il proprio endpoint

È qui che il fork è più visibile e dove un /v1 errato può costarti un pomeriggio. Entrambi i client possono raggiungere un endpoint di terze parti compatibile con OpenAI o Anthropic, ma tramite meccanismi diversi e convenzioni URL opposte.

Oh My Pi dispone di un percorso tramite variabile d'ambiente che Pi non ha. Il suo provider Anthropic risolve l'URL di base tramite normalizeAnthropicBaseUrl($env.ANTHROPIC_BASE_URL), prima del valore predefinito ufficiale, e quel normalizzatore rimuove un /v1 finale, quindi sia https://api.kunavo.com sia https://api.kunavo.com/v1 puntano allo stesso host. Letto da packages/ai/src/providers/anthropic-state.ts, dove sono definiti resolveDirectAnthropicBaseUrl() e il normalizzatore, il 19 settembre 2026: dal codice sorgente, non da una richiesta effettuata da noi.

# Oh My Pi honours ANTHROPIC_BASE_URL for its built-in anthropic provider.
# normalizeAnthropicBaseUrl() strips a trailing /v1, so both forms resolve
# to the same host here. Pi ships no equivalent gateway base-URL variable.
export ANTHROPIC_API_KEY="$KUNAVO_API_KEY"
export ANTHROPIC_BASE_URL="https://api.kunavo.com"
omp

Una trappola di precedenza accompagna questo percorso. L'ordine documentato di Oh My Pi pone una models.yml apiKey in posizione 2, sopra l'OAuth memorizzato in posizione 3, ma una variabile d'ambiente del provider in posizione 5, sotto di essa. Quindi, se hai già effettuato l'accesso a Anthropic tramite /login, il token dell'abbonamento prevale su ANTHROPIC_API_KEY e la chiave del tuo gateway non viene mai utilizzata. Fissa la chiave nella configurazione oppure esci prima da quel provider.

Per un provider nominato, Oh My Pi usa YAML e qui il /v1 viene riaggiunto, perché il percorso OpenAI aggiunge /chat/completions all'URL di base troncato, senza modifiche.

providers:
  kunavo:
    baseUrl: https://api.kunavo.com/v1   # /v1 REQUIRED: omp appends /chat/completions
    api: openai-completions              # use anthropic-messages, and then drop /v1
    apiKey: KUNAVO_API_KEY               # env var name, a literal, or "!cmd"
    authHeader: true                     # send Authorization: Bearer <key>
    models:
      - id: claude-sonnet-5
        contextWindow: 200000
        maxTokens: 64000

Per indirizzare Pi verso un gateway hai un solo percorso: ~/.pi/agent/models.json. Pi non legge ANTHROPIC_BASE_URL: una ricerca nel codice dell'intero repository il 19 settembre 2026 restituisce due occorrenze di quella stringa esatta, entrambe non sovrascrivibili (una costante Cloudflare AI Gateway e uno script di generazione dei modelli); inoltre non esiste neppure un OPENAI_BASE_URL semplice. Esiste una variabile per l'URL di base, ma non è una via di fuga generica: AZURE_OPENAI_BASE_URL, elencata nella documentazione dei provider di Pi, indirizza il provider Azure OpenAI verso la tua risorsa Azure e nulla più.

{
  "providers": {
    "kunavo": {
      "baseUrl": "https://api.kunavo.com",
      "api": "anthropic-messages",
      "apiKey": "$KUNAVO_API_KEY",
      "models": [
        {
          "id": "claude-sonnet-5",
          "contextWindow": 200000,
          "maxTokens": 64000
        }
      ]
    }
  }
}

Quanto al suffisso, la documentazione ufficiale di Pi non l'ha mai stabilito definitivamente e dovresti saperlo invece di fidarti di un singolo esempio. Fino all'aggiornamento della documentazione del 22 settembre 2026, la pagina dei modelli mostrava in un punto un proxy anthropic-messages come https://proxy.example.com/v1 e in un altro come https://proxy.example.com senza suffisso; l'aggiornamento ha rimosso entrambi senza stabilire una soluzione. La forma senza suffisso è quella da seguire e il ragionamento deriva dal codice sorgente, non da test a runtime: Pi non include nulla di simile al normalizzatore di Oh My Pi che rimuove /v1 nel percorso anthropic-messages; l'unica normalizzazione descritta nella documentazione è specifica per Azure: gli URL radice delle risorse nei domini propri di Azure "are normalized to the OpenAI API path"; il valore Anthropic predefinito integrato è https://api.anthropic.com senza /v1, mentre quello OpenAI è https://api.openai.com/v1; per anthropic-messages passa model.baseUrl direttamente all'SDK ufficiale Anthropic, che aggiunge autonomamente /v1/messages. Un /v1 in quel punto produrrebbe /v1/v1/messages. Kunavo documenta la stessa convenzione nella propria pagina degli URL di base: solo l'origine per i client in stile Anthropic, /v1 per quelli in stile OpenAI.

Vale la pena pianificare attorno ad altri due confini. Fino all'aggiornamento della documentazione del 22 settembre 2026, la tabella documentata di Pi elencava quattro dialetti per i provider personalizzati, sebbene il repository fornisse handler aggiuntivi; l'aggiornamento ha eliminato la tabella senza indicare un elenco sostitutivo, quindi quei quattro restano l'unica superficie documentata da Pi per i provider personalizzati. Gli handler aggiuntivi, però, non sono riservati ai componenti integrati: il codice sorgente di Pi in v0.99.2 tratta un models.json api come stringa libera e lo inoltra all'implementazione registrata tra dieci che corrisponde (BUILTIN_APIS in packages/ai/src/compat.ts), quindi un provider personalizzato può nominare bedrock-converse-stream o google-vertex; non è documentato né testato qui se uno dei due funzioni con un endpoint di terze parti. In Oh My Pi, inoltre, disabledProviders viene verificato prima delle credenziali: un ID provider intercettato da quell'elenco scompare silenziosamente indipendentemente dalla chiave fornita; gli array delle impostazioni vengono sostituiti integralmente dal livello con precedenza maggiore anziché uniti, quindi un elenco a livello di progetto scarta silenziosamente quello globale. Entrambi i progetti forniscono anche vie di compatibilità che potresti realmente dover usare con un gateway: disableStrictTools di Oh My Pi, supportsEagerToolInputStreaming e allowEmptySignature di Pi. Qui non è stato testato se Kunavo accetti gli schemi predefiniti rigorosi, i marcatori di cache o lo streaming eager degli input degli strumenti di ciascun client.

Quanto costa realmente passare da uno all'altro

Meno di quanto suggerisca il divario tra i numeri di versione, e più di una semplice copia di file. Nella documentazione di nessuno dei due repository sono documentati un comando d'importazione, un convertitore di sessioni o un migratore della configurazione, quindi prevedi di riscrivere il blocco provider nell'altro formato — da JSON a YAML o viceversa. Neppure le credenziali vengono trasferite: Pi le conserva in ~/.pi/agent/auth.json, mentre Oh My Pi mantiene un archivio SQLite delle credenziali in ~/.omp/agent/agent.db.

Le variabili d'ambiente si estendono meno di quanto suggerisca la discendenza condivisa, quindi leggi attentamente questa parte. Oh My Pi legge ancora i nomi con prefisso PI_ — tra cui PI_CONFIG_DIR e PI_CODING_AGENT_DIR — ma questi ricollocano le directory di Oh My Pi; esportarne uno in un profilo shell condiviso con Pi indirizza entrambi i client verso lo stesso percorso anziché rendere portabile la configurazione. Il mirroring da OMP_ a PI_ descritto nel suo riferimento alle variabili d'ambiente è ancora più limitato: il documento stabilisce che la regola si applica all'interno di ciascun file .env analizzato e precisamente "not arbitrary variables inherited from the parent process". Ciò che non viene trasferito affatto è tutto ciò che è costruito sull'harness: un'estensione TypeScript di Pi è scritta sulla sua API e circa sei mesi di sviluppo mantenuto separatamente dal marcatore di sincronizzazione del 22 marzo 2026 sono esattamente il punto in cui tali API divergono. Testa un'estensione invece di presumere che sia portabile.

Il costo è lo stesso da entrambe le parti

Nessuno dei due client ti addebita costi, quindi passare dall'uno all'altro modifica di zero la spesa per i modelli. La variabile è il percorso attraverso cui acquisti i token e, su questo punto, i due differiscono in un aspetto: Pi ha un gateway a pagamento di prima parte e Oh My Pi no. Radius è gestito da Earendil, è closed source, viene raggiunto tramite il /login di Pi e la sua FAQ dichiara che applica "the fees we have with our payment processor on top of the list prices": una percentuale che non pubblica, quindi il totale Radius non può essere calcolato dall'esterno. L'unico gateway di Oh My Pi è omp auth-gateway serve, un software che ospiti tu, con la sicurezza del trasporto delegata all'operatore.

C'è una cosa da eliminare prima che entri in un budget: un abbonamento Claude Pro o Max con accesso effettuato in uno dei due harness non equivale a utilizzo gratuito. Fino a quando l'aggiornamento della documentazione del 22 settembre 2026 ha rimosso la frase, la documentazione dei provider di Pi dichiarava che l'utilizzo di harness di terze parti "draws from extra usage and is billed per token, not against Claude plan limits"; l'avviso che Pi stampa quando un modello Anthropic viene eseguito con autenticazione tramite abbonamento dice ancora che "draws from extra usage and is billed per token, not your Claude plan limits" (source, v0.99.2). Non è stata trovata un'affermazione equivalente nella documentazione di Oh My Pi, quindi non presumere che si comporti diversamente: controlla il tuo account.

Per il percorso tramite gateway, ecco il calcolo del carico di lavoro, non del client. Supponi un mese di lavoro continuo dell'agente: 5.000.000 token di input non memorizzati nella cache e 400.000 token di output, senza letture o scritture della cache e senza costi per immagini o strumenti. Le tariffe sono i prezzi attuali del catalogo Kunavo per milione di token.

Si tratta di stime illustrative dei token secondo le ipotesi sopra, non di costi misurati delle attività e non di un limite massimo della fattura. La colonna è identica per entrambi i client perché il client non è una variabile di prezzo, ma il carico di lavoro può esserlo: lo strumento task di Oh My Pi distribuisce i subagenti in parallelo e ogni agente parallelo porta con sé il proprio contesto, cioè un moltiplicatore dei token di input che nessuna tabella qui può dimensionare per te. Misuralo su una modifica circoscritta prima di estendere la stima.

Due precisazioni dal lato Kunavo appartengono allo stesso numero. L'importo del catalogo è un minimo di fatturazione, non un tetto massimo: quando il fornitore upstream comunica il proprio addebito, la fattura è il maggiore tra il costo del catalogo e il costo upstream moltiplicato per il markup applicabile, come spiega la guida alla fatturazione. Inoltre, la ricarica minima è $10 di credito prepagato: il denaro necessario per finanziare un account, non il costo di un'attività né un abbonamento.

Kunavo pubblica una guida alla configurazione per ciascun client — Pi e Oh My Pi — ma non ha testato nessuno dei due a runtime contro il proprio endpoint; una guida alla configurazione è un riferimento di configurazione, non un test di compatibilità. Entrambe le configurazioni sopra sono state scritte sulla base della documentazione e del codice sorgente pubblicati e dovrebbero essere verificate sul tuo computer. Mantieni disponibile un percorso funzionante mentre ne provi uno. Quando vuoi stabilire il prezzo di un'attività reale anziché di un modello, crea un account Kunavo, ricaricalo ed esegui una modifica circoscritta con il modello preselezionato. Se stai ancora scegliendo un harness anziché un provider, i prezzi del coding agent Pi analizzano i quattro percorsi di fatturazione di Pi e Pi e OpenCode confronta Pi con un altro client per cui è pubblicata una guida alla configurazione Kunavo.

Domande frequenti

Gli alberi della documentazione e i pacchetti npm di entrambi i repository sono stati verificati il 19 settembre 2026, e le affermazioni sull'URL di base e sull'ordine delle credenziali sono state lette dai file sorgente indicati inline nella stessa data; le metriche dei repository e gli storici delle release sono stati riletti il 21 settembre 2026. Dopo l'aggiornamento della documentazione di Pi del 22 settembre 2026, gli esempi di URL di base anthropic-messages, la frase sulla normalizzazione Azure, i valori api documentati e l'ordine delle credenziali sono stati ricontrollati il 1° ottobre 2026 sulla documentazione aggiornata e sul sorgente alla v0.99.2. Lo stesso giorno, dopo il rilascio di Pi v0.99.0 con MCP integrato, l'elenco delle funzionalità omesse, la formulazione sulla fiducia nel progetto e il design dichiarato sono stati ricontrollati sulle pagine usage, MCP, settings e security e sul README, sui valori api a cui rimanda il suo sorgente, sulla riga relativa all'utilizzo aggiuntivo confrontandola con l'avviso del terminale in quel sorgente e sull'indice delle integrazioni di questo sito. Sempre il 1° ottobre 2026, i valori api documentati di Oh My Pi sono stati ricontrollati rispetto al suo docs/models.md e al suo schema models.yml alla v18.4.8. Le tariffe Kunavo sono visualizzate dal catalogo in tempo reale e ogni cifra in dollari qui riportata è un calcolo illustrativo dei token. Nessuno dei due client è stato testato a runtime con Kunavo e non si intende suggerire alcun confronto di prestazioni o benchmark tra i due progetti — non ne esiste nessuno che questa pagina possa citare.