Bromure Agentic Coding — Manual do Utilizador

Bem-vindo ao manual do utilizador oficial do Bromure Agentic Coding, a aplicação macOS que executa agentes de programação de IA — Claude Code, Codex CLI, Grok CLI e ferramentas de shell comuns — dentro de máquinas virtuais Linux descartáveis, com uma gateway do lado do anfitrião que mantém as suas credenciais reais fora do alcance do agente.

Este manual documenta a versão 4.3.0. Requer macOS 14 (Sonoma) ou posterior em Apple Silicon. Se é novo por aqui, leia a Introdução e depois o Início Rápido; tudo o resto é material de referência a que pode recorrer conforme necessário.

Novo na aplicação? O caminho mais rápido para ter um agente em execução é a Instalação seguida do guia de Início Rápido.

Índice

Primeiros passos

Capítulo	O que abrange
1. Introdução	O que é a aplicação, o modelo de segurança de fronteira única, as funcionalidades-pilar e como se compara a outras ferramentas.
2. Instalação	Requisitos de sistema, transferência e instalação da aplicação, o fluxo de configuração no primeiro arranque, atualizações da imagem base, migração e desinstalação.
3. Início Rápido	De uma instalação nova a um agente em execução em cerca de dez minutos: criar um espaço de trabalho, escolher um agente, partilhar uma pasta, executar uma tarefa e inspecionar o rastreio.

Fundamentos

Capítulo	O que abrange
4. Conceitos e Arquitetura	Anfitrião vs. convidado, espaços de trabalho vs. sessões vs. VMs, o ciclo de vida da VM, a fronteira de transmissão, o armazenamento, as pontes vsock e a rede.
5. Espaços de trabalho	O navegador de espaços de trabalho: indicadores de estado, cartões de recursos, o resumo da configuração e a criação, duplicação, reposição e eliminação de espaços de trabalho.
6. Sessões	A janela da sessão unificada: iniciar e fechar sessões, separadores e worktrees, os painéis do navegador e de ficheiros, a transferência de ficheiros e os pontos de verificação.
O Navegador Incorporado	Utilizar o Chromium integrado do espaço de trabalho: conduzi-lo você mesmo, deixar o agente conduzi-lo através das ferramentas do navegador, manter a sessão iniciada e a privacidade.
Automatizações	Execuções de agentes agendadas e não assistidas num quadro kanban: criá-las, acionadores e agendas, automatizações encadeadas, histórico de execuções e responder aos seus pedidos.
Tarefas de código	O kanban de código: briefings, fases planejadas pelo agente com dependências, execuções autónomas em worktrees, revisão de diff com comentários por linha, e mesclagem.

Referência de definições

Capítulo	O que abrange
7. Referência de Definições	Como abrir o editor Editar espaço de trabalho e uma referência com uma página por painel para todos os dezasseis painéis.

A referência de definições tem uma página por painel: Geral, Agentes, Modelos locais, Fusion, Pastas, Credenciais, Ambiente, MCP, Rastreio, Salvaguardas, Cadeia de fornecimento, Injeção de prompt, Aparência, Navegador, Recursos e o painel Automatização de âmbito global da aplicação.

Os pilares em profundidade

Capítulo	O que abrange
8. Credenciais e a Fronteira de Transmissão	Como os segredos reais permanecem no anfitrião e o agente só recebe falsos: o proxy MITM, os ciclos de vida por credencial, as aprovações e o detetor de comprometimento.
9. Proteção da Cadeia de Fornecimento	Verificar, reescrever e bloquear instalações de pacotes antes de o agente as ver — a barreira de idade, OSV, socket.dev, Delpi e a remoção de scripts.
10. Deteção de Injeção de Prompt e Salvaguardas	Detetores no dispositivo que analisam o tráfego de IA do agente em busca de instruções injetadas, além de salvaguardas que removem operações de infraestrutura destrutivas.
11. Rastreio e Auditoria	O que um rastreio de sessão regista, o Inspetor de Rastreios, a encriptação em repouso, a retenção, a exportação e a privacidade.
12. Fusion — o Painel Multimodelo	Responder a cada prompt com vários modelos em simultâneo, avaliados e sintetizados na transmissão numa única resposta.
13. Inferência Local e Híbrida	Executar modelos no seu próprio Apple Silicon com MLX, o catálogo de modelos, o recurso híbrido nuvem/local e as métricas de inferência.

Para além de um só Mac

Capítulo	O que abrange
14. Acesso Remoto e o Cliente Nativo	Alcançar o seu sandbox a partir de qualquer lugar — o espelho do cliente nativo, a CLI, SSH, túneis, PAC e o modelo de segurança remoto.
15. Empresarial — Inscrição e Frota	Inscrever-se no Bromure Enterprise Manager, que telemetria é carregada (e qual não é), a vista de frota e o descomissionamento.

Referência

Capítulo	O que abrange
16. CLI, Automatização e MCP	A interface de linha de comandos `bromure-cli`, a API de controlo de loopback, o servidor MCP e o AppleScript.
Avançado	Ferramentas para utilizadores avançados, incluindo o navegador de ficheiros ext4 para ler a imagem de home de um espaço de trabalho parado sem o arrancar.
17. Resolução de problemas	Diagnosticar problemas de configuração, VM, autenticação, TLS, cadeia de fornecimento, espaço em disco e acesso remoto, organizados por sintoma.
18. Glossário	Definições de todos os termos técnicos utilizados neste manual.
19. Apêndice	Tabelas de referência: localizações no disco, portas de rede, variáveis de ambiente e argumentos de arranque, e o guia de referência da VM convidada.

Convenções utilizadas neste manual

O texto a negrito nomeia um controlo no ecrã exatamente como a aplicação o rotula — um botão, item de menu, comutador ou painel (por exemplo, Iniciar esta VM ao iniciar sessão).
O texto Monospace é um comando, caminho de ficheiro, variável de ambiente ou valor literal que digita ou vê (por exemplo, bromure-cli run ou ~/Library/Application Support/BromureAC).
As capturas de ecrã mostram a interface em português. A aplicação está totalmente localizada; os seus ecrãs corresponderão ao idioma do seu macOS.
As notas, dicas e avisos aparecem como destaques:

Nota: Informação de fundo que vale a pena conhecer.

Dica: Um atalho ou prática recomendada.

Aviso: Algo que pode perder dados ou enfraquecer uma proteção se o fizer mal.

Onde mais procurar

As transferências do produto, o whitepaper técnico e a matriz detalhada de funcionalidades encontram-se em bromure.io. Para questões que este manual não responde, a Resolução de problemas reúne procedimentos de diagnóstico, e o Glossário define o vocabulário.