I tuoi segreti vivono nel portachiavi del sistema operativo,
non in un prompt e non nel tuo repository
AgentsRoom conserva chiavi API, token e password di database in una cassaforte locale alla macchina, cifrata tramite il portachiavi del tuo sistema operativo. Tu li richiami per nome e l'app li risolve quando parte un comando o un agente.
Basta incollare un token in un prompt solo perché era il modo più rapido di sbloccare un agente. Dai un nome al segreto una volta, usa {{secret:NAME}} ovunque altro e lascia che il valore resti dove deve stare.
Come AgentsRoom mantiene un segreto utilizzabile dai tuoi comandi e illeggibile per l'agente che lo richiede.
Ogni progetto finisce per avere una manciata di valori che non vanno condivisi: una chiave di pagamento, una password di database, un token di deploy, una chiave API per l'ambiente di staging. Nel momento in cui entrano in gioco gli agenti di coding IA, quei valori iniziano a spostarsi nel modo peggiore possibile. Vengono incollati in un prompt per sbloccare un agente, scritti a mano in uno script generato dall'agente, oppure finiscono in un file che tre commit dopo viene committato.
Il gestore di segreti di AgentsRoom dà loro un unico posto in cui vivere. Un segreto è un nome e un valore: lo aggiungi una volta e AgentsRoom lo cifra tramite il portachiavi del tuo sistema operativo prima ancora che tocchi il disco. L'intera cassaforte è un singolo file nella tua cartella home, scritto con permessi riservati al solo proprietario, e non lascia mai la macchina su cui è stata creata.
Da quel momento non maneggi più il valore. Scrivi {{secret:NAME}} in un comando di sviluppo o nell'ambiente di un agente, e AgentsRoom sostituisce il valore reale quando quel comando o quell'agente parte. I tuoi agenti possono elencare i nomi e chiedere che uno venga iniettato, il che basta per fare il loro lavoro, e non ottengono mai il valore in sé.
Una cassaforte pensata per una macchina piena di agenti IA
Cifrata dal sistema operativo, richiamata per nome, risolta all'ultimo momento utile.
Cifrato dal portachiavi del tuo sistema operativo
Ogni valore è cifrato tramite Electron safeStorage: la chiave di cifratura è quindi custodita dal portachiavi del tuo sistema operativo e non da AgentsRoom. L'app conserva il testo cifrato e chiede al sistema di decifrarlo, esattamente come le altre applicazioni a cui affidi già le tue credenziali.
Un solo file, riservato al proprietario
Tutti i tuoi segreti vivono in un'unica cassaforte in ~/.agentsroom/secrets.json, scritta con permessi riservati al solo proprietario (0600) e sostituita in modo atomico a ogni modifica. Nessun file scritto a metà dopo un crash, e nessun altro account utente sulla macchina può aprirla.
Richiama per nome, mai per valore
Un segreto salvato si usa come {{secret:NAME}}: nella riga di comando di un terminale di sviluppo, nell'ambiente dato a un agente, ovunque avresti altrimenti digitato la credenziale. Quello che leggi a schermo, e che potresti mostrare a un collega, è il nome.
Risolto all'avvio, nel processo principale
La sostituzione avviene quando il processo parte, dentro il processo principale Electron. Il valore risolto entra nell'ambiente del comando che viene avviato e da nessun'altra parte: non in un log, non nell'interfaccia, non in un file su disco.
Gli agenti vedono i nomi, non i valori
Un agente IA può elencare i nomi dei tuoi segreti e chiedere che uno venga iniettato in qualcosa che sta per eseguire. Non esiste alcun percorso di codice che restituisca un valore a un agente, al livello di interfaccia o tramite MCP. L'agente lavora con il riferimento, l'app lavora con il segreto.
Niente portachiavi, niente archiviazione
Se la macchina non è in grado di offrire un portachiavi di sistema funzionante, AgentsRoom rifiuta di salvare il segreto invece di ripiegare sul testo in chiaro. Una cassaforte che degrada in silenzio in un file semplice è peggio di nessuna cassaforte, quindi quel ripiego semplicemente non esiste.
Locale alla macchina per costruzione, non per impostazione predefinita
I tuoi segreti non vengono mai inviati ai server di AgentsRoom. Non c'è un interruttore di sincronizzazione da controllare, nessuna cassaforte cloud da disattivare e nessun backup delle tue chiavi in un posto diverso dal tuo disco. La cassaforte viene creata sulla macchina, cifrata con una chiave che il portachiavi del sistema operativo custodisce per quella macchina, e lì resta. Una copia del file, da sola, non è qualcosa che un'altra macchina possa aprire.
La separazione tra usare un segreto e leggere un segreto è imposta nel codice, non da un'istruzione scritta in un prompt. Il livello di interfaccia, gli strumenti MCP e ogni agente parlano dei segreti per nome. Solo il processo principale Electron trasforma un riferimento in un valore, e solo mentre costruisce l'ambiente di un processo che gli hai chiesto di avviare. Dire a un agente di fare attenzione alle credenziali è una speranza. Non avere una funzione che restituisce la credenziale è una garanzia.
È questo che rende ragionevole lasciare che un agente lavori con un'API a pagamento o un database reale. L'agente sa che esiste un segreto chiamato STRIPE_SECRET_KEY e può chiedere che venga iniettato nel comando che vuole eseguire. Non può stamparlo, non può copiarlo in un file che sta scrivendo e non può farlo trapelare in una conversazione conservata altrove.
Da un token incollato a un segreto con un nome
Tre passaggi, e il valore non ricompare più.
Aggiungi il segreto una volta
Dagli un nome e incolla il valore un'ultima volta. AgentsRoom lo cifra tramite il portachiavi del sistema operativo e lo scrive nella cassaforte in ~/.agentsroom/secrets.json, riservata al proprietario e in modo atomico. Se la macchina non ha un portachiavi utilizzabile, l'app lo dice e rifiuta invece di scrivere testo in chiaro.
Richiamalo come {{secret:NAME}}
Usa il riferimento dove prima andava il valore: il comando che avvia il tuo dev server, oppure l'ambiente di un agente che ha bisogno di un token API. Quello che viene salvato nelle tue impostazioni è il riferimento, e si può guardare senza rischi.
Lascia che AgentsRoom lo risolva all'avvio
Quando il comando o l'agente parte, il processo principale scambia il riferimento con il valore reale nell'ambiente di quel processo. I tuoi strumenti ottengono ciò che serve, e l'agente che li pilota ha comunque conosciuto solo il nome.
Quando un gestore di segreti smette di essere opzionale
Le situazioni in cui una credenziale incollata diventa un incidente vero.
Dev server che hanno bisogno di chiavi vere
Il tuo dev server non parte senza una chiave di pagamento e una password di database. Metti {{secret:NAME}} nel comando di avvio al posto della credenziale, e il comando diventa qualcosa che puoi lasciare a schermo durante una call senza un attimo di panico.
Agenti che chiamano un'API a pagamento
Un agente ha bisogno di un token per raggiungere un'API di terze parti mentre lavora. Aggiungi il segreto al suo ambiente per nome: l'agente ottiene un ambiente funzionante, e il token non è nel prompt, non è nella conversazione e non è in ciò che l'agente scriverà dopo.
Chiavi che smettono di finire nel repository
L'incidente classico è una credenziale scritta in un file di configurazione che un commit successivo si porta via. Richiamare i segreti per nome significa che il file tracciato nel repository contiene un nome, quindi non c'è nulla da far trapelare quando il branch viene pushato.
Una macchina, molti progetti
Un'unica cassaforte, protetta dal portachiavi del tuo sistema operativo e leggibile solo dal tuo account utente, serve ogni progetto che apri. Ogni progetto richiama i nomi che gli servono, e nessuno di loro conserva la propria copia sparsa di una credenziale.
Come può un agente usare un segreto che non può leggere?
Perché usare una credenziale e leggere una credenziale sono due operazioni diverse, e AgentsRoom implementa per gli agenti solo la prima. La cassaforte è esposta via MCP da un solo strumento, secrets_list, e restituisce dei nomi. Da lì l'agente scrive {{secret:NAME}} nel comando o nell'ambiente che gli serve, e la sostituzione viene eseguita dall'app, non dall'agente.
Quello che manca di proposito è la direzione opposta. Nessuno strumento MCP restituisce il valore di un segreto, il livello di interfaccia non ne riceve mai uno e nulla lo riporta dentro una conversazione. La trasformazione di un riferimento in un valore reale avviene dentro il processo principale Electron, nel momento in cui un processo viene avviato, e il risultato entra nell'ambiente di quel processo e da nessun'altra parte.
L'effetto pratico è che un agente può eseguire la tua suite di test su un database reale, chiamare un'API a pagamento o fare deploy su staging senza che una sola credenziale entri nel suo contesto. Niente da oscurare dopo, perché nulla è mai stato esposto.
Scopri AgentsRoom MCPFAQ
Dove sono conservati i miei segreti?
In un unico file cassaforte in ~/.agentsroom/secrets.json nella tua cartella home. Ogni valore è cifrato tramite Electron safeStorage, quindi la chiave di cifratura è custodita dal portachiavi del tuo sistema operativo. Il file è scritto con permessi riservati al solo proprietario (0600) e sostituito in modo atomico, così un crash non lo lascia mai scritto a metà.
Il mio agente IA può leggere i miei segreti?
No. Un agente può elencare i nomi dei tuoi segreti e chiedere che uno venga iniettato in un comando o in un ambiente, che è tutto ciò che gli serve per lavorare. Non esiste alcun percorso di codice che restituisca un valore a un agente, al livello di interfaccia o tramite MCP. La risoluzione avviene solo nel processo principale Electron.
I miei segreti vengono sincronizzati sui server di AgentsRoom?
Mai. La cassaforte è locale alla macchina per costruzione. I segreti non vengono inviati ai server di AgentsRoom, non vengono salvati in un cloud e non vengono trasmessi all'app mobile. Nascono sulla tua macchina, sono cifrati per la tua macchina, e lì restano.
Come uso un segreto in un comando?
Scrivi {{secret:NAME}} dove sarebbe andato il valore: in un comando di un terminale di sviluppo, oppure nell'ambiente di un agente. AgentsRoom sostituisce il valore reale quando quel processo viene avviato, e nelle tue impostazioni resta il riferimento.
Cosa succede se la mia macchina non ha un portachiavi di sistema?
AgentsRoom rifiuta di conservare il segreto. Volutamente non esiste alcun ripiego che scriva il valore in chiaro sul disco, perché una cassaforte che degrada in silenzio in un file semplice ti dà la fiducia della cifratura senza la cifratura.
Questo sostituisce i file di ambiente del mio progetto?
Risolve la parte del problema che fa male quando entrano in gioco gli agenti IA: tenere la credenziale fuori dai file, dai prompt e dalle conversazioni. Il tuo progetto conserva ciò che gli serve a runtime, e il valore vero vive nella cassaforte e viene iniettato all'avvio invece di stare in un file che un agente può leggere e un commit può portarsi via.
Se qualcuno copia il file della cassaforte, può leggerlo?
Non su un'altra macchina. I valori sono cifrati con una chiave custodita dal portachiavi del tuo sistema operativo, quindi il file preso da solo è testo cifrato. In più, la cassaforte è scritta con permessi riservati al solo proprietario, quindi nemmeno un altro account utente sulla stessa macchina può aprirla.
Quale strumento MCP usano i miei agenti per i segreti?
secrets_list, ed è l'unico. Restituisce i nomi dei segreti conservati su questa macchina, così un agente può scoprire cosa esiste e poi richiamarne uno come {{secret:NAME}} in un comando di sviluppo o nell'ambiente di un processo che avvia. Nessuno strumento restituisce un valore, quindi non c'è nulla che un agente possa stampare, copiare in un file che sta scrivendo o far trapelare in una conversazione. Quando manca un segreto che gli serve, ti chiede di aggiungerlo nell'app invece di chiederti di incollarlo nella chat.
Potrebbe interessarti anche
Connessioni database
Salva le tue connessioni MySQL e MariaDB, raggiungi un database in una subnet privata tramite un tunnel SSH o una sessione AWS SSM, e lascia che i tuoi agenti IA lo interroghino via MCP. In sola lettura per impostazione predefinita, una sola istruzione per chiamata, risultati limitati, e la password non arriva mai all'agente.
Connessioni SSH
Salva le tue connessioni SSH, apri un terminale SSH integrato ed esegui Claude Code, Codex o Antigravity CLI direttamente sul tuo server remoto o VPS. Autenticazione con chiave SSH o password, profili di connessione per progetto, senza un client SSH separato.
Dev Terminals
Gestore di terminali e lanciatore di processi per progetto. Avvia backend, frontend e worker con un clic, con i tuoi segreti iniettati all'avvio invece che digitati a mano.
AgentsRoom MCP
Il server MCP che permette ai tuoi agenti di pilotare AgentsRoom stesso: progetti, terminali, backlog e connessioni, con le protezioni che ne fanno parte.
Dai ai tuoi agenti l'accesso, non le tue chiavi
Scarica AgentsRoom, sposta le tue chiavi API e le tue password in una cassaforte cifrata dal portachiavi del tuo sistema operativo, e richiamale per nome ovunque altro.
App companion: monitora i tuoi agenti in movimento
Usa Claude, Codex, Antigravity CLI o un altro provider IA.
Invia bug e richieste direttamente nel tuo backlog pubblico.
Uno sguardo ad AgentsRoom in azione.