Seus segredos ficam no chaveiro do sistema,
não em um prompt nem no seu repositório
O AgentsRoom armazena chaves de API, tokens e senhas de banco de dados em um cofre local à máquina, criptografado pelo chaveiro do seu sistema operacional. Você os referencia pelo nome, e o aplicativo resolve o valor quando um comando ou um agente é iniciado.
Pare de colar um token em um prompt só porque era o jeito mais rápido de destravar um agente. Nomeie o segredo uma vez, use {{secret:NAME}} em todo o resto e deixe o valor onde ele deve ficar.
Como o AgentsRoom mantém um segredo utilizável pelos seus comandos e ilegível para o agente que o pede.
Todo projeto acaba com um punhado de valores que não podem ser divulgados: uma chave de pagamento, uma senha de banco de dados, um token de deploy, uma chave de API do ambiente de staging. No momento em que os agentes de IA de programação entram em cena, esses valores começam a circular da pior forma possível. São colados em um prompt para destravar um agente, escritos direto em um script que o próprio agente criou, ou jogados em um arquivo que acaba commitado três commits depois.
O gerenciador de segredos do AgentsRoom dá a eles um único lugar para viver. Um segredo é um nome e um valor: você o adiciona uma vez, e o AgentsRoom o criptografa pelo chaveiro do seu sistema operacional antes que ele toque o disco. O cofre inteiro é um único arquivo na sua pasta pessoal, gravado com permissões apenas para o proprietário, e nunca sai da máquina onde foi criado.
Daí em diante você nunca mais lida com o valor. Você escreve {{secret:NAME}} em um comando de dev ou no ambiente de um agente, e o AgentsRoom substitui pelo valor real quando esse comando ou esse agente é iniciado. Seus agentes podem listar os nomes e pedir que um deles seja injetado, o que basta para fazerem o trabalho, e nunca recebem o valor em si.
Um cofre feito para uma máquina cheia de agentes de IA
Criptografado pelo sistema operacional, referenciado pelo nome, resolvido no último momento possível.
Criptografado pelo chaveiro do seu sistema
Cada valor é criptografado pelo safeStorage do Electron, o que significa que a chave de criptografia fica no chaveiro do seu sistema operacional e não no AgentsRoom. O aplicativo armazena o texto cifrado e pede ao sistema para descriptografá-lo, exatamente como os outros aplicativos aos quais você já confia credenciais.
Um único arquivo de cofre, só do proprietário
Todos os seus segredos ficam em um único cofre em ~/.agentsroom/secrets.json, gravado com permissões apenas para o proprietário (0600) e substituído de forma atômica a cada alteração. Nada de arquivo pela metade depois de um crash, e nenhuma outra conta de usuário da máquina consegue abri-lo.
Referencie pelo nome, nunca pelo valor
Um segredo salvo é usado como {{secret:NAME}}: na linha de comando de um terminal de dev, no ambiente entregue a um agente, em qualquer lugar onde você teria digitado a credencial. O que você lê na tela, e o que poderia mostrar a um colega, é o nome.
Resolvido na inicialização, no processo principal
A substituição acontece quando o processo é iniciado, dentro do processo principal do Electron. O valor resolvido entra no ambiente do comando que está subindo e em nenhum outro lugar: não em um log, não na interface, não em um arquivo no disco.
Os agentes veem nomes, não valores
Um agente de IA pode listar os nomes dos seus segredos e pedir que um deles seja injetado em algo que está prestes a executar. Não existe caminho no código que devolva um valor a um agente, à camada de interface ou por MCP. O agente trabalha com a referência, o aplicativo trabalha com o segredo.
Sem chaveiro, sem armazenamento
Se a máquina não puder oferecer um chaveiro do sistema funcional, o AgentsRoom se recusa a salvar o segredo em vez de cair para texto puro. Um cofre que degrada em silêncio para um arquivo comum é pior do que nenhum cofre, então essa alternativa simplesmente não existe.
Local à máquina por design, não por uma configuração padrão
Seus segredos nunca são enviados aos servidores do AgentsRoom. Não há um botão de sincronização para conferir, nenhum cofre na nuvem do qual você precise sair, e nenhum backup das suas chaves em outro lugar além do seu próprio disco. O cofre é criado na máquina, criptografado com uma chave que o chaveiro do sistema operacional guarda para aquela máquina, e fica ali. Uma cópia do arquivo, sozinha, não é algo que outra máquina consiga abrir.
A separação entre usar um segredo e ler um segredo é garantida no código, não por uma instrução escrita em um prompt. A camada de interface, as ferramentas MCP e todos os agentes falam dos segredos pelo nome. Só o processo principal do Electron transforma uma referência em um valor, e só enquanto monta o ambiente de um processo que você mandou iniciar. Pedir a um agente que tome cuidado com credenciais é uma esperança. Não existir uma função que devolva a credencial é uma garantia.
É isso que torna razoável deixar um agente trabalhar contra uma API paga ou um banco de dados real. O agente sabe que existe um segredo chamado STRIPE_SECRET_KEY e pode pedir que ele seja injetado no comando que quer executar. Ele não consegue imprimi-lo, não consegue copiá-lo para um arquivo que está escrevendo e não consegue vazá-lo em uma conversa armazenada em outro lugar.
De um token colado a um segredo com nome
Três passos, e o valor nunca mais aparece.
Adicione o segredo uma vez
Dê um nome a ele e cole o valor uma última vez. O AgentsRoom o criptografa pelo chaveiro do sistema operacional e o grava no cofre em ~/.agentsroom/secrets.json, apenas para o proprietário e de forma atômica. Se a máquina não tiver um chaveiro utilizável, o aplicativo avisa e se recusa, em vez de gravar texto puro.
Referencie como {{secret:NAME}}
Use a referência onde o valor ia antes: no comando que inicia o seu servidor de dev, ou no ambiente de um agente que precisa de um token de API. O que fica salvo nas suas configurações é a referência, e é seguro olhar para ela.
Deixe o AgentsRoom resolver na inicialização
Quando o comando ou o agente é iniciado, o processo principal troca a referência pelo valor real no ambiente daquele processo. Suas ferramentas recebem o que precisam, e o agente que as comanda continua tendo conhecido apenas o nome.
Quando um gerenciador de segredos deixa de ser opcional
As situações em que uma credencial colada vira um incidente de verdade.
Servidores de dev que precisam de chaves reais
Seu servidor de dev não sobe sem uma chave de pagamento e uma senha de banco de dados. Coloque {{secret:NAME}} no comando de inicialização em vez da credencial, e o comando vira algo que você pode deixar na tela durante uma reunião sem nenhum momento de pânico.
Agentes que chamam uma API paga
Um agente precisa de um token para alcançar uma API de terceiros enquanto trabalha. Adicione o segredo ao ambiente dele pelo nome: o agente recebe um ambiente funcional, e o token não está no prompt, não está na conversa e não está no que o agente escrever em seguida.
Chaves que param de cair no repositório
O acidente de sempre é uma credencial escrita em um arquivo de configuração que um commit posterior acaba levando junto. Referenciar os segredos pelo nome faz com que o arquivo versionado no repositório guarde um nome, então não há nada para vazar quando a branch é enviada.
Uma máquina, muitos projetos
Um único cofre, protegido pelo chaveiro do seu sistema operacional e legível apenas pela sua conta de usuário, atende todos os projetos que você abre. Cada projeto referencia os nomes de que precisa, e nenhum deles mantém a própria cópia espalhada de uma credencial.
Como um agente usa um segredo que não consegue ler?
Porque usar uma credencial e ler uma credencial são duas operações diferentes, e o AgentsRoom só implementa a primeira para os agentes. O cofre é exposto por MCP por exatamente uma ferramenta, secrets_list, e ela devolve nomes. A partir daí, o agente escreve {{secret:NAME}} no comando ou no ambiente de que precisa, e a substituição é feita pelo aplicativo, não pelo agente.
O que falta de propósito é o outro sentido. Nenhuma ferramenta MCP devolve o valor de um segredo, a camada de interface nunca recebe um, e nada o exibe de volta em uma conversa. Transformar uma referência em um valor real acontece dentro do processo principal do Electron, no momento em que um processo é iniciado, e o resultado vai para o ambiente desse processo e para nenhum outro lugar.
O efeito prático é que um agente pode rodar a sua suíte de testes contra um banco de dados real, chamar uma API paga ou fazer deploy em staging sem que uma única credencial entre no contexto dele. Nada para censurar depois, porque nada foi exposto.
Descubra o AgentsRoom MCPPerguntas frequentes
Onde ficam armazenados os meus segredos?
Em um único arquivo de cofre em ~/.agentsroom/secrets.json, na sua pasta pessoal. Cada valor é criptografado pelo safeStorage do Electron, então a chave de criptografia fica no chaveiro do seu sistema operacional. O arquivo é gravado com permissões apenas para o proprietário (0600) e substituído de forma atômica, então um crash nunca o deixa pela metade.
Meu agente de IA consegue ler os meus segredos?
Não. Um agente pode listar os nomes dos seus segredos e pedir que um deles seja injetado em um comando ou em um ambiente, que é tudo de que ele precisa para trabalhar. Não existe caminho no código que devolva um valor a um agente, à camada de interface ou por MCP. A resolução acontece somente no processo principal do Electron.
Meus segredos são sincronizados com os servidores do AgentsRoom?
Nunca. O cofre é local à máquina por design. Os segredos não são enviados aos servidores do AgentsRoom, não têm backup na nuvem e não são retransmitidos para o aplicativo mobile. Eles são criados na sua máquina, criptografados para a sua máquina, e ficam ali.
Como uso um segredo em um comando?
Escreva {{secret:NAME}} onde o valor iria: em um comando de terminal de dev, ou no ambiente de um agente. O AgentsRoom substitui pelo valor real quando esse processo é iniciado, e a referência é o que permanece nas suas configurações.
O que acontece se a minha máquina não tiver um chaveiro do sistema?
O AgentsRoom se recusa a armazenar o segredo. Deliberadamente não existe uma alternativa que grave o valor em texto puro no disco, porque um cofre que degrada em silêncio para um arquivo comum dá a você a confiança da criptografia sem a criptografia.
Isso substitui os arquivos de ambiente do meu projeto?
Isso resolve a parte do problema que dói quando há agentes de IA envolvidos: manter a credencial fora dos arquivos, dos prompts e das conversas. Seu projeto continua com o que precisa em tempo de execução, e o valor em si fica no cofre e é injetado na inicialização, em vez de ficar parado em um arquivo que um agente pode ler e um commit pode levar junto.
Se alguém copiar o arquivo do cofre, consegue lê-lo?
Em outra máquina, não. Os valores são criptografados com uma chave mantida pelo chaveiro do seu sistema operacional, então o arquivo isolado é texto cifrado. Além disso, o cofre é gravado com permissões apenas para o proprietário, então outra conta de usuário na mesma máquina também não consegue abri-lo.
Qual ferramenta MCP os meus agentes usam para os segredos?
secrets_list, e é a única. Ela devolve os nomes dos segredos armazenados nesta máquina, então um agente consegue descobrir o que existe e depois referenciar um deles como {{secret:NAME}} em um comando de dev ou no ambiente de um processo que ele inicia. Nenhuma ferramenta devolve um valor, então não há nada para o agente imprimir, copiar para um arquivo que está escrevendo ou vazar em uma conversa. Quando falta um segredo de que ele precisa, ele pede que você o adicione no aplicativo, em vez de pedir que você cole no chat.
Você também pode gostar
Conexões de banco de dados
Salve suas conexões MySQL e MariaDB, alcance um banco de dados em uma sub-rede privada por um túnel SSH ou uma sessão AWS SSM, e deixe seus agentes de IA consultá-lo por MCP. Somente leitura por padrão, uma instrução por chamada, resultados limitados, e a senha nunca chega ao agente.
Conexões SSH
Salve suas conexões SSH, abra um terminal integrado via SSH e execute o Claude Code, o Codex ou o Antigravity CLI diretamente no seu servidor remoto ou VPS. Autenticação por chave SSH ou senha, perfis de conexão por projeto, sem precisar de um cliente SSH separado.
Dev Terminals
Gerenciador de terminais e inicializador de processos por projeto. Inicie backend, frontend e workers com um clique, com os seus segredos injetados na inicialização em vez de digitados.
AgentsRoom MCP
O servidor MCP que deixa os seus agentes pilotarem o próprio AgentsRoom: projetos, terminais, backlog e conexões, com as travas que vêm junto.
Dê acesso aos seus agentes, não as suas chaves
Baixe o AgentsRoom, mova as suas chaves de API e senhas para um cofre criptografado pelo chaveiro do seu sistema operacional, e referencie-as pelo nome em todo o resto.
App complementar: acompanhe seus agentes em qualquer lugar
Use Claude, Codex, Antigravity CLI ou outro provedor de IA.
Envie bugs e pedidos direto para o seu backlog público.
Uma visão do AgentsRoom em ação.