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: enquanto monta o ambiente de um processo que você mandou iniciar ou, se você ativou os dados em tempo real para as vistas HTML de um projeto, quando adiciona um cabeçalho a uma requisição para um endpoint que você permitiu, e a página nunca o vê. 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. A única exceção é opcional e por projeto: um cabeçalho de requisição para um endpoint que você permitiu para as suas vistas HTML, adicionado pelo processo principal e nunca mostrado à página.
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
Faça outra perguntaOnde ficam armazenados os meus segredos?
Meu agente de IA consegue ler os meus segredos?
Meus segredos são sincronizados com os servidores do AgentsRoom?
Como uso um segredo em um comando?
O que acontece se a minha máquina não tiver um chaveiro do sistema?
Isso substitui os arquivos de ambiente do meu projeto?
Se alguém copiar o arquivo do cofre, consegue lê-lo?
Qual ferramenta MCP os meus agentes usam para os segredos?
Você também pode gostar
Conexões de banco de dados
Salve suas conexões MySQL, PostgreSQL, SQL Server, MongoDB, SQLite e Google BigQuery, 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. Exportação, importação e cópia de um banco sobre outro para MySQL, PostgreSQL e MongoDB.
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 às 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.
Agentes que você lê como uma conversa
Cada agente tem uma função, um rosto e um fio que você lê como um app de mensagens.
