Torna ai progetti selezionati

Developer tooling · 2026

Forge for Pi

Gli stessi quattro strumenti. Un’ingegnerizzazione migliore sotto.

Forge aggiunge protezioni, efficienza del contesto e osservabilità lato host intorno a Pi senza aggiungere tool, skill, comandi, testo di prompt o messaggi visibili al modello.

Versione
Forge for Pi v1.0.2
Target
Pi coding agent · verificato su 0.84.4
Tool visibili al modello
read · bash · edit · write
Licenza
MIT
Workflow Forge for Pi mostrato su un MacBook in una fotografia tecnica editoriale.

Principio centrale

Migliorare l’ambiente, non l’interfaccia vista dal modello.

Pi mantiene la normale superficie a quattro strumenti. Forge sostituisce implementazioni lato host di slot già esistenti oppure osserva gli eventi del ciclo di vita. Se Forge è disattivato, il normale pi resta vanilla.

read
bash
edit
write

Componenti

Sei livelli, tutti lato host.

Smart Read

Restituisce una vista strutturale compatta per file sorgente grandi idonei, mantenendo disponibili gli intervalli esatti tramite il normale tool read.

Safe Snapshot Edit

Aggiunge snapshot circoscritti, validazione delle aree viste, protezione stale, guardia no-op ed edit atomici senza introdurre un nuovo tool.

Reactive Diagnostics

Aggiunge dopo le scritture i nuovi diagnostici locali introdotti, con la prima release focalizzata soprattutto su Python e Ruff.

Context Intelligence

Compatta in modo conservativo grandi evidenze di tool precedenti lato host quando ciò produce un risparmio materiale di contesto.

Task Progress Monitor

Mostra lo stato osservato Understand → Work → Finalize e la velocità media di output misurata quando Pi espone l’uso token finale.

Telemetry opzionale

Scrive misure locali solo di metadati esclusivamente quando il tracing viene abilitato esplicitamente.

Workflow lato host

Il modello continua a lavorare come se Forge non ci fosse.

Forge resta dietro l’interfaccia normale di Pi. Il modello continua a chiamare read, bash, edit e write; Forge rafforza alcuni comportamenti host e mostra stato locale senza iniettare istruzioni nascoste nel contesto del modello.

Forge for Pi usato all’interno di un workflow di sviluppo.

Benchmark misurati

Evidenza dove esiste. Nessuna promessa prestazionale globale.

Forge riporta solo misure registrate nei file pubblici di benchmark e validazione. I risultati appartengono allo specifico scope di test e non vengono presentati come miglioramenti universali.

−25,90%
Token input Smart Read

Solo benchmark specifico Smart Read.

−39,14%
Byte restituiti Smart Read

Solo benchmark specifico Smart Read.

2 / 2
Edit stale reali bloccati

Valutazione stale-protection Snapshot Edit.

0
Overhead token visibile al modello

Task Progress Monitor.

Snapshot Edit ha misurato circa +1,0% di overhead token rispetto a vanilla nel proprio benchmark e ha evitato un falso stale. Reactive Diagnostics ha rilevato e corretto 1/1 errore Python introdotto con 0 falsi positivi nei test disponibili.

Architettura

Un solo entrypoint di estensione. Nessuna nuova superficie visibile al modello.

L’estensione si attiva solo quando FORGE_FOR_PI=1. I componenti sostituiscono un’implementazione host esistente oppure osservano gli eventi del ciclo di vita; una guardia impedisce registrazioni duplicate.

Pi model
  │
  ├─ read
  ├─ bash
  ├─ edit
  └─ write
      │
      ▼
Forge host layer
  ├─ Smart Read
  ├─ Safe Snapshot Edit
  ├─ Reactive Diagnostics
  ├─ Context Intelligence
  ├─ Task Progress Monitor
  └─ Optional local telemetry

No new tools · No hidden prompt · No model-facing messages
Workflow host-side di Forge for Pi mostrato in un ambiente terminale.

Task Progress Monitor

Stato osservato, senza falsa precisione.

La TUI a una sola riga evita intenzionalmente percentuali di completamento, ETA, check nascosti o contatori di recovery. Letture e ispezione restano in Understand; un edit o write diretto sposta lo stato su Work. La media finale tok/s viene mostrata solo quando Pi espone l’uso token di output finalizzato.

UnderstandWorkFinalize

Installazione

Opt-in, reversibile e locale all’utente.

L’installer copia l’estensione nella directory utente delle estensioni Pi, crea launcher gestiti da Forge in ~/.local/bin e lascia intatta la configurazione Pi non correlata.

Scarica v1.0.2
  1. Scarica forge-for-pi-v1.0.2.tar.gz.
  2. Estrai l’archivio ed esegui ./scripts/install.sh.
  3. Esegui ./scripts/verify-install.sh.
  4. Avvia con Forge; usa Forgetrace solo per la telemetry locale opzionale.

Trace opzionale

La telemetry è disattivata di default.

FORGE_FOR_PI_TRACE=1 abilita misure locali solo di metadati. In questa release Forge non raccoglie contenuto dei tool, dati CPU/RAM o liste di processi.

Salvaguardie di design

Fail open. Reversibile. Nessun prompting nascosto.

File non supportati, diagnostica non disponibile ed errori di elaborazione host preservano il comportamento nativo di Pi. Forge non aggiunge skill, system prompt, template di prompt o messaggi visibili al modello.

Licenza

Open source con licenza MIT.

Forge for Pi è rilasciato con licenza MIT. È un progetto indipendente e non è affiliato né approvato dai maintainer di Pi.

Un ambiente migliore intorno agli stessi quattro strumenti.

Forge for Pi v1.0.2 è disponibile come release pubblica e rimane intenzionalmente opt-in.