Coloque seu time de agentes pra rodar

Instale o HiveTerm, defina suas bees num hive.yml e comece a orquestrar. Tudo aqui funciona em macOS, Windows e Linux.

Início rápido

1

Instale

Baixe o app pro seu OS e abra — a instalação é só isso.

2

Adicione um projeto

Abra uma pasta de projeto. O HiveTerm detecta sua stack e oferece um hive.yml inicial.

3

Inicie

Abra o projeto — toda bee de auto-start sobe e se coordena pela Queen.

Reuniões

Coloque seus agentes numa sala. Um agente orquestra os outros por um bus de mensagens estruturado — eles debatem, planejam, revisam ou constroem, você lê cada mensagem em threads de chat no painel de Reuniões (⌘J), e o resultado chega num card de resumo destacado.

Sua primeira reunião com 3 agentes

1

Abra o modal de Nova reunião

Aperte ⌘⇧J em qualquer lugar (ou o botão + no painel de Reuniões). Você precisa de pelo menos um projeto aberto.

2

Escolha o template e escreva a pauta

Comece com Decisão e uma escolha real sua — "Fila no Postgres ou Redis pros jobs em background?". Quanto mais concreta a pauta, melhor a reunião.

3

Monte o time

Escolha o orquestrador (quem conduz) e 2–3 participantes — qualquer combinação de Claude, Codex e Gemini. Deixe o Modo autônomo ligado pra ninguém travar esperando prompt de permissão.

4

Inicie e assista

O orquestrador cria os participantes, distribui os lados, e a conversa vai rolando ao vivo no thread. No final você recebe o card de resumo — e o orquestrador desliga o próprio time.

Os seis templates

Decisão Dois agentes defendem lados opostos de uma escolha que você precisa fazer. Termina com um veredito.
Brainstorm Perspectivas diferentes sobre uma pergunta, reunidas numa síntese.
Review Um defensor contra atacantes em cima do seu código ou abordagem, antes de subir.
Plano Visões de produto e engenharia rascunham e consolidam um plano acionável.
Squad dev Divide uma feature entre agentes que constroem em paralelo no seu repo — cada um dono dos próprios arquivos, review cruzado, relatório de entrega.
Custom Escreva seu próprio brief — papéis, rodadas e fluxo do seu jeito.

Reuniões persistem entre reinícios e carregam recolhidas — expanda as que quiser reler. Apague uma reunião pelo cabeçalho do thread, ou limpe o histórico inteiro pelo painel. Reunião que começa com o painel aberto expande sozinha pra você acompanhar ao vivo.

O hive.yml

Um arquivo por projeto define seus agentes e processos. Comite o arquivo pra que o time inteiro compartilhe o mesmo workspace.

hive.yml
name: My App
bees:
  claude:
    type: agent
    command: claude
    instructions: "Senior engineer. Ship clean PRs."
  api:
    command: npm run dev
    cwd: ./server
    auto_start: true
    restart_on_change: ["src/**"]
    env:
      PORT: 5173
Campo O que faz
name Nome do projeto exibido na sidebar.
command O comando de shell que essa bee roda. Obrigatório.
type "agent" pra CLIs de IA, "command" pro resto.
cwd Diretório de trabalho da bee (padrão: raiz do projeto).
env Variáveis de ambiente injetadas quando a bee sobe.
auto_start Sobe essa bee automaticamente quando o projeto abre.
auto_restart Reinicia a bee quando ela sai com código não-zero.
restart_on_change Reinicia a bee quando algum arquivo que casa com esses globs muda.
instructions Instruções de system prompt injetadas no agente quando ele sobe.

A Queen (servidor MCP)

Um servidor MCP local numa porta escolhida automaticamente. Seus agentes chamam essas 20 ferramentas pra criar sub-agentes, trocar mensagens pelo bus de agentes, ler output, gerenciar pins e notas e te notificar — tudo isolado por projeto.

spawn_bee Cria novos processos e agentes na hora
kill_bee Para qualquer processo rodando
restart_bee Reinicia processos travados ou parados
list_bees Lista todos os processos de todos os projetos
get_bee_status Checa status e uptime de qualquer bee
read_output Lê o output do terminal de qualquer processo
write_input Manda input pra processos rodando
notify Manda notificações nativas pro desktop
list_pins Lista os pins do board de qualquer projeto
create_pin Fixa uma mensagem ou o próprio plano no board
update_pin Edita o título ou o corpo de um pin
set_pin_done Marca um pin como feito quando termina
delete_pin Remove um pin do board
get_notes Lê o scratchpad de notas de um projeto
set_notes Substitui as notas de um projeto
append_notes Adiciona uma linha às notas de um projeto
send_message Envia uma mensagem estruturada pra outro agente
read_inbox Recebe mensagens de outros agentes, sem scraping
reply Responde uma mensagem, correlacionada ao thread
await_reply Bloqueia até outro agente responder

Como os agentes conversam (o bus de mensagens)

Mensagem entre agentes nunca passa pelo terminal: send_message entrega na inbox do destinatário, read_inbox recebe como JSON limpo (passe wait_s pra bloquear até chegar algo — é assim que participantes esperam a tarefa), reply responde uma mensagem específica, e await_reply bloqueia o remetente até a resposta chegar. Conversas são agrupadas por conversation_id, e mensagem enviada com kind:"summary" vira o card destacado no painel de Reuniões.

Controles de spawn

spawn_bee aceita dois opt-ins: model fixa o modelo do agente criado (omita pra deixar o orquestrador decidir), e skip_permissions inicia o agente pulando os prompts de permissão — cada CLI recebe a própria flag (Claude, Codex e Gemini suportados). read_output também aceita encoding:"screen" pra reproduzir o terminal como tela VT100 renderizada em vez de bytes crus.

Splits e arquivos

Grupos de split colocam seus agentes lado a lado — crie pela sidebar (precisa de dois agentes fora de grupo), arraste painéis pela alça pra reposicionar ou trocar, e salve layouts com nome. Selecionar qualquer membro traz o split inteiro de volta.

O explorador de arquivos abre qualquer coisa: código com syntax highlighting, busca estilo VSCode e edição direta (⌘S, salvamento atômico), arquivos gigantes caem num visualizador virtualizado com busca, e imagens, markdown e binários têm cada um sua visualização.

Precisa de mais?

Veja o changelog pras novidades, ou só baixe e explore — dá pra descobrir quase tudo do HiveTerm dentro do próprio app.