01Output
Strutturato di default
JSON sullo standard output, diagnostica sullo standard error e una riga per stato per seguire un job.
CLI · in sviluppo
L'intera pipeline, da una sola riga di comando.
Accedi, prepara progetti e Spazi, aggiungi memoria, cerca e gestisci chiavi e policy con gb. Pensata per chi lavora al terminale e per gli script che scrive.
In sviluppo. Non ancora disponibile.
gb auth login
Accesso fatto. La sessione resta nel tuo portachiavi.
gb init --project … --space …
Il file del progetto è scritto, senza alcun segreto.
gb memories ingest --document contratto.pdf
{"jobId":"job_…","status":"Accepted"}
gb jobs get job_… --fields state
{"state":"succeeded"}
gb mcp serve
Le stesse operazioni, come strumenti per i tuoi agenti.
Fatta per gli script
Una riga di comando su cui un programma può contare.
02Codici di uscita
Errori su cui agire
Ogni tipo di rifiuto ha il suo codice di uscita e un'azione con un nome: uno script non deve mai interpretare un messaggio.
03Segreti
Mai sullo schermo
Chiavi e sessioni vanno nel portachiavi del sistema o in un file privato: mai come argomento, mai stampate.
04Sigillato
Cifrato prima di partire
Ciò che aggiungi è sigillato per il servizio di mascheramento, dopo averne verificato i certificati, e ogni richiesta è firmata.
05Nuovi tentativi
Sicura da rieseguire
Nuovi tentativi, attese crescenti e chiavi di idempotenza sono integrati: la stessa richiesta due volte è una sola operazione.
06Scoperta
Si descrive da sola
gb describe mostra di ogni comando gli argomenti, gli output e ogni errore che può restituire.
Cosa copre
Ogni operazione, un comando ciascuna.
Dal primo accesso all'ultima ricerca.
| Area | Comandi | A cosa servono |
|---|---|---|
| Accesso | gb auth | Entra ed esci, ruota la tua chiave, vedi a che punto sei. |
| Preparazione | gb projects gb spaces gb apps gb init | I progetti, gli Spazi che tengono separata la memoria e le app che li usano. |
| Controllo | gb keys gb policy | Chiavi legate al solo client che le detiene; la policy firmata che ogni richiesta rispetta. |
| Memoria | gb memories ingest gb jobs get gb search | Aggiungi documenti e note, segui ogni job fino alla fine, cerca nel tuo ambito. |
| Agenti | gb mcp serve | Un server MCP locale, perché un agente possa aggiungere alla memoria e cercarvi. |
Una sola interfaccia
Dichiarata una volta. Uguale in ogni strumento.
Ogni operazione è dichiarata una volta e generata nella CLI, negli SDK e nel server MCP, così non divergono mai.
01CLI
Per persone e script
Ogni operazione da un terminale, da un job di CI o da uno script di shell.
02SDK
TypeScript e Python
Le stesse operazioni come chiamate tipizzate nel tuo codice.
03MCP
Per gli agenti
Acquisizione, ricerca e stato dei job come strumenti che un agente può chiamare.
04HTTP
Qualsiasi linguaggio
L'API sotto tutti e tre, e il router da inserire al posto delle chiamate ai modelli.
Nessun SDK per il tuo linguaggio? Chiama gb come processo: output e codici di uscita ne fanno un ponte.