Bromure Agentic Coding — Manual do Utilizador

Bem-vindo ao manual oficial do Bromure Agentic Coding, a aplicação macOS que corre agentes de código com IA — Claude Code, Codex, Grok, Kimi Code, Oh My Pi, e as ferramentas de shell comuns — dentro de máquinas virtuais Linux isoladas no seu Mac, com uma passagem do lado do anfitrião que mantém as suas credenciais verdadeiras fora do alcance do agente.

Este manual documenta a versão 5.0.0. Exige macOS 14 (Sonoma) ou posterior em Apple Silicon.

A versão 5.0.0 está organizada em torno das sessões: cada conversa com um agente é uma linha na barra lateral, e você fala com ela num chat. As VMs Linux em que as sessões correm chamam-se máquinas na janela principal. O editor de definições ainda lhes chama espaços de trabalho; as duas palavras querem dizer o mesmo.

Novo na aplicação? Comece por Instalação e primeira execução, e depois siga o Início rápido. Leia Conceitos e Arquitetura quando quiser o retrato completo. Use tudo o resto como referência.

Índice

Para começar

Capítulo	O que cobre
1. Introdução	O que é a aplicação, o modelo de segurança de fronteira única, as grandes funcionalidades, e como se compara a outras ferramentas.
2. Instalação e primeira execução	Requisitos de sistema, instalar a aplicação, o assistente de arranque em seis passos, as atualizações da imagem base, a ferramenta de linha de comandos, o armazenamento, mudar para um Mac novo, e desinstalar.
3. Início rápido	Do assistente a uma tarefa terminada: iniciar uma sessão, responder à pergunta do agente, ver os ficheiros alterados, inspecionar o rastreio, e depois arquivar a sessão e trazê-la de volta.
4. Conceitos e Arquitetura	Sessões, máquinas, salas e ramos; estados de sessão; anfitrião e convidado; a fronteira de transmissão; o que persiste; as portas vsock e MCP; a rede.

No dia a dia

Capítulo	O que cobre
5. O início das sessões	A janela principal: a barra lateral e o seu carril recolhido, as linhas de sessão e os seus menus, o cabeçalho da sessão, o menu de máquinas, a cápsula Linux, a palete de comandos ⌘K, e arquivar, terminar, eliminar e desfazer.
6. Iniciar uma sessão	O ecrã de nova sessão: escolher o agente, a máquina e onde ela trabalha (uma pasta nova, uma das suas, ou um repositório), anexar ficheiros, os arranques recentes, e perguntar a outra sessão com @.
6.1 O chat	Falar com um agente: a caixa de composição, os anexos, os comandos com barra e o terminal em linha, os cartões de pergunta, as linhas de atividade, os resumos de ficheiros alterados, os cartões de início de sessão, parar, editar e reenviar, e a busca.
6.2 Salas	Agrupar sessões relacionadas numa sala: a grelha de chats ao vivo, as disposições e os separadores, ampliar uma célula, a Central própria da sala, e enviar para a sala toda.
6.3 Ramos e revisão	Sessões de ramo na sua própria worktree git, voltar a fundi-las, a janela Ramos, e a janela de revisão com comentários de linha.
6.4 Agentes a trabalhar em conjunto	Delegação a sessões filhas, pedidos a outras sessões por @alcunha, o painel Delegações, a passagem de ficheiros, os limites, e pedidos entre máquinas.
6.5 Central e mensagens	A sessão Central que segue todas as outras sessões, as suas regras de segurança, e o Conetor de mensagens para o Signal, o WhatsApp e o Slack.
6.6 Máquinas	A secção Máquinas virtuais: criar, arrancar, suspender e eliminar máquinas, Rebobinar a pasta pessoal e Redefinir disco, os terminais e a Grelha, o painel Ficheiros, e a área de transferência.
6.7 O Navegador Incorporado	O navegador Chromium ao lado de uma sessão: conduzi-lo você mesmo, deixar o agente conduzi-lo pelas ferramentas de navegador, manter a sessão iniciada, e a privacidade.
Aceleração Metal no Bromure Web	A aplicação web autónoma: requisitos do Metal, controlos globais e por perfil, renderizador ativo e suporte de vídeo.
6.8 Automatizações	Execuções de agente agendadas e sem vigilância num quadro kanban: gatilhos, horários, cadeias, histórico, responder às suas perguntas, e o servidor MCP das automatizações.
6.9 Tarefas de código	O kanban do código: tarefas, fases planeadas pelo agente, execuções autónomas em worktrees, revisão com comentários de linha, e fusão.

Referência de definições

Capítulo	O que cobre
7. Referência de Definições	Como abrir o editor de definições e as Preferências, a lista agrupada de painéis e o Procurar nas definições, o modelo Predefinições, e o que grava quando.

A referência de definições tem uma página por painel, na ordem do editor:

Espaço de trabalho: Geral, Aparência
Modelos: Modelos, Fusion, Squelch
Máquina: Pastas, Ambiente, MCP, Navegador, Recursos
Segurança: Credenciais, Rastreio, Salvaguardas, Cadeia de fornecimento, Injeção de prompt, Proteção de dados pessoais
Aplicação (só nas Preferências): Automatização

Segurança e a fronteira de transmissão

Capítulo	O que cobre
8. Credenciais e a fronteira de transmissão	Como os segredos verdadeiros ficam no anfitrião enquanto o agente só recebe falsos: o proxy MITM, inícios de sessão e chaves de API, aprovações por credencial, e o alerta 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, o OSV, o socket.dev, o Depi, e o despojamento dos guiões de instalação.
10. Deteção de injeção de prompt e salvaguardas	Os detetores no dispositivo que examinam o tráfego de IA do agente à procura de instruções injetadas, o firewall de saída, e as salvaguardas sobre operações destrutivas.
10.5 Proteção de dados pessoais	Trocar dados pessoais por substitutos coerentes antes de uma conversa sair do seu Mac, e restaurá-los nas respostas.
11. Rastreio e Auditoria	O que um rastreio de sessão registra, o Inspetor de rastreio, a cifra em repouso, a retenção, a exportação, e a privacidade.
11.5 Visão geral e linha do tempo de segurança	A janela Linha do tempo de segurança: a Visão geral de 24 horas, as proteções por máquina, e a Linha do tempo filtrável e exportável de todas as decisões de segurança.

Modelos e infraestrutura

Capítulo	O que cobre
12. Fusion — o Painel Multimodelo	Responder a cada prompt com vários modelos ao mesmo tempo, julgados e combinados numa única resposta na transmissão.
12.5 Squelch — Menos Ruído, Menos Tokens	Retirar testes bem-sucedidos, progresso e outro ruído da saída dos comandos antes de o modelo a ler (inspirado no rtk), e os tokens poupados por sessão.
13. Modelos e fornecedores	O quadro Modelos global: fornecedores (inícios de sessão, chaves de API, Amazon Bedrock, OpenRouter, servidores personalizados, modelos no dispositivo), escolhas de modelo por agente, substituições por espaço de trabalho, e alterações ao vivo.
13.5 Clusters Kubernetes e registos	Correr clusters k3s e um registo de contentores privado nas suas próprias VMs ao lado das suas máquinas: armazenamento, balanceamento de carga, extras, acesso, e o servidor MCP de infraestrutura.

Além de um só Mac

Capítulo	O que cobre
14. Acesso remoto e o cliente nativo	Espelhar um Bromure remoto de outro Mac, iPhone, iPad ou Apple Vision Pro; as Preferências remotas; a CLI sobre SSH, túneis e PAC; e o modelo de segurança remoto.
15. Empresa — Inscrição e frota	Inscrever-se no bromure.io, o que a telemetria envia (e o que não envia), a vista da frota, e a saída.

Referência

Capítulo	O que cobre
16. CLI, API e MCP	A ferramenta de linha de comandos `bromure-cli`, a API de controlo em loopback, os servidores MCP, e o AppleScript.
16.5 Avançado	Ferramentas para utilizadores avançados: o explorador de ficheiros ext4 e a verificação do sistema de ficheiros, e restaurar ou rebobinar a pasta pessoal de uma máquina.
17. Resolução de problemas	Diagnosticar problemas de instalação, de máquina, de início de sessão, de TLS, de cadeia de fornecimento, de espaço em disco e de acesso remoto, organizados por sintoma.
18. Glossário	Definições de todos os termos usados neste manual.
19. Apêndice — Localizações de ficheiros, portas e ambiente	Tabelas de referência: localizações no disco, portas de rede e vsock, variáveis de ambiente, predefinições, atalhos de teclado, e a folha de consulta do convidado.

Convenções deste manual

O texto em negrito nomeia um controlo ou uma etiqueta no ecrã exatamente como a aplicação a mostra em inglês — um botão, um item de menu, um interruptor, um painel ou uma secção da barra lateral (por exemplo, New session ou Start this VM at login).
O texto em monoespaçado é um comando, um caminho de ficheiro, uma variável de ambiente ou um valor literal que você escreve ou vê (por exemplo, bromure-cli vm ls ou ~/Library/Application Support/BromureAC).
Um caminho como Workspaces › Infrastructure › Messaging Connector… é um caminho de menu: o menu, e depois cada submenu ou item pela ordem. Preferências › Modelos quer dizer o painel Modelos da janela das Preferências.
Máquina e espaço de trabalho querem dizer o mesmo: uma VM Linux isolada com as suas definições. A janela principal diz máquina; o editor de definições, menus como New Workspace… e a CLI dizem espaço de trabalho (ou perfil).
Uma sessão é uma conversa com um agente, numa pasta, numa máquina. Não é uma execução de uma máquina; ver Conceitos e Arquitetura.
Os atalhos de teclado usam os símbolos do macOS: ⌘ Command, ⌥ Option, ⌃ Control, ⇧ Shift, ⏎ Return, ⎋ Escape.
As capturas de ecrã mostram a interface em inglês com conteúdo de demonstração sintético. A aplicação está traduzida, pelo que os seus ecrãs seguem o idioma do seu macOS.
Notas, dicas e avisos aparecem como destaques:

Nota: informação de fundo que vale a pena saber.

Dica: um atalho ou uma boa prática.

Aviso: algo que pode perder dados ou enfraquecer uma proteção se errar.

Onde mais procurar

As transferências do produto, o livro branco técnico e a matriz de funcionalidades detalhada estão em bromure.io. Para as perguntas a que este manual não responde, a Resolução de problemas reúne os procedimentos de diagnóstico, e o Glossário define o vocabulário.