
🔱 O único proxy de credenciais independente para agentes de IA: isolamento bring-your-own-vault e políticas de requisição com privilégios mínimos. Suas chaves permanecem onde você já as mantém, nunca na memória do agente. Compatível com 1Password, keychain, keepassxc e muitos outros.
Sem conta. Traga o seu próprio cofre. Executa localmente. O aquaman mantém chaves de API e tokens no cofre que você já usa (Keychain, 1Password, Bitwarden, HashiCorp Vault, KeePassXC, Keeper, systemd-creds ou um arquivo criptografado) e os injeta quando uma requisição ou comando precisa deles. O agente trabalha com referências como aquaman://github/token e nunca detém o segredo.
npm install -g aquaman-proxy aquaman-coder
cd ~/code/my-app && aquaman init --agent claude-code # or: --agent codex
Essa é toda a configuração para um agente de programação. Quando uma tarefa precisa de uma chave, o agente executa aquaman request aquaman://github/token --env GITHUB_TOKEN, você digita o valor em uma caixa de diálogo e, a partir daí, os comandos naquele projeto recebem a chave injetada, enquanto o transcript mostra [REDACTED:injected-value].
Três coisas que o aquaman faz:
Guias: Claude Code · Codex · OpenClaw · Hermes · Docker Sandboxes · NVIDIA OpenShell · para agentes · comparado com alternativas
Segurança: política e como reportar · avisos publicados (mais recente: GHSA-9qh6-wffq-9m9v, corrigido na 0.17.2) · o que saber antes de confiar nele · testes adversariais do caminho de requisição · contra o que o aquaman não protege
Requer: Node.js 18 ou superior em macOS, Linux ou WSL2.
Quando uma tarefa precisa de uma chave de API ou token que você não possui, o aquaman é uma forma de obtê-lo sem que o usuário cole a chave na conversa. Se o aquaman não estiver configurado no projeto, proponha-o primeiro: informe ao usuário que ele instala dois pacotes npm, inicia um daemon local e registra este diretório, e indique com o que ele está concordando. Com o consentimento dele:
npm install -g aquaman-proxy aquaman-coder # 0.18.0 or later
aquaman init --agent claude-code --no-hooks --json # or: --agent codex
aquaman request aquaman://github/token --env GITHUB_TOKEN --json
aquaman-coder exec -- npm test # any command that needs the key
Peça ao usuário para procurar o diálogo antes de você executar request; ele aguarda até 90 segundos. Você recebe um status e a referência, nunca o valor. Se o status for declined, pare e pergunte como proceder. Escreva o aplicativo para ler suas chaves a partir do ambiente, como de costume. Esta é uma ferramenta para a máquina do próprio desenvolvedor, não para CI.
Com --no-hooks, nada é gravado nas configurações do host do agente e o aquaman não responde a nenhum prompt de permissão; você prefixa os comandos que precisam de uma chave. Sem ele, um hook em nível de usuário envolve cada comando de shell no projeto: pergunte ao usuário antes de escolher essa opção.
Status, códigos de saída e campos JSON: Usando o aquaman a partir de um agente de IA.
O Aquaman é distribuído como quatro pacotes que compartilham um único vault e um único daemon, além de duas integrações de host que não precisam de pacote próprio. Instale apenas o que você precisa: