Buddy Graph

Un comando CLI renderizza i dati di ragionamento di Buddy come un grafo interattivo

di fiorastudio · fiorastudio/buddy

Promosso ★ 9.2/10

Buddy Graph — Un comando CLI renderizza i dati di ragionamento di Buddy come un grafo interattivo

Cosa fa

Invoca la CLI locale di Buddy (buddy graph [session_id]) per renderizzare il grafo di ragionamento in modalità guard — affermazioni, archi, risultati e sessioni — come un file HTML vis-network interattivo standalone. Legge da ~/.buddy/buddy.db (o BUDDY_DB_PATH) e stampa il percorso salvato più i conteggi. Si attiva quando un utente Buddy vuole ispezionare o debuggare la struttura del ragionamento come un grafo piuttosto che tramite uno strumento MCP.

Rapporto di test

Compilato la CLI (npm install + tsc) e l'ho eseguita per davvero: popolato un db con 4 affermazioni di ragionamento e 3 archi, quindi 'buddy graph' ha riportato 'Claims: 4 | Edges: 3 | Sessions: 1' e ha scritto un HTML vis-network interattivo di 19KB con ogni testo di affermazione incorporato; 'buddy graph sess-demo-1' ha correttamente delimitato a quella sessione. Contro una baseline senza skill il vantaggio è concreto — un comando documentato contro la scoperta di ~/.buddy/buddy.db, il reverse-engineering dello schema reasoning_claims/reasoning_edges e la creazione manuale di una visualizzazione. Rilevante solo per gli utenti che già usano Buddy, e richiede che il progetto sia compilato o il binario pacchettizzato installato.

Testato il: 2026-07-24 · Claude Code 2.x (agent harness)

Installazione

git clone https://github.com/fiorastudio/buddy
mkdir -p ~/.claude/skills
cd buddy && cp -r ".codex/skills/buddy-graph" ~/.claude/skills/buddy-graph

Comandi e prompt di esempio

  • /buddy-graphUn comando CLI renderizza i dati di ragionamento di Buddy come un grafo interattivo

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • Render my last Buddy session's reasoning as an interactive graph
  • Show the claims and edges from this guard-mode session
  • Visualize Buddy's findings graph for debugging session