Três modos de trabalho
plan lê e planeja; ask pede autorização para executar comandos, editar ou usar ferramentas externas; auto executa conforme a política configurada. Tab alterna entre eles.
Harness de terminal da APIcultura
beecode: sua colmeia de desenvolvimento dentro do terminal.
Planeja, edita, testa e revisa código com permissões explícitas, sessões retomáveis e as ferramentas MCP da APIcultura. Funciona localmente ou por SSH, só com o teclado.
beecode
O que vamos construir? Use @arquivo ou /comando
Ask Mel 5.5 APIcultura
Modelo APIcultura esc
*Mel 5.5Maior capacidade · padrão
Bee 5.5Equilíbrio
Favo 5.5Rápido e econômico
O que vamos construir? Use @arquivo ou /comando
Ask Mel 5.5 APIcultura
Comandos da colmeia / Commands esc
Para começar
Escolher modelo/modelos | /models ctrl+x m
Conversa
Retomar conversa/sessoes | /sessions ctrl+x l
Nova conversa/nova | /new ctrl+x n
O que vamos construir? Use @arquivo ou /comando
Ask Mel 5.5 APIcultura
!Sua permissão é necessária
→ Edit smoke.txt
1+ honey
Permitir uma vezPermitir na sessãoRecusarenter confirmar
tab modos ctrl+p comandos
beecode Mel 5.5 · askctx — 5h [░░░░░░] 0% semana [░░░░░░] 0% • mcp 0 sem branch
Instalação
Três comandos e você está dentro
Precisa de uma conta APIcultura com saldo. O login abre o navegador para confirmar um código e guarda a sua chave com acesso restrito no computador.
1Instale no seu sistema
curl -fsSL https://apicultura.app/install.sh | shx64 ou arm64. Precisa de curl ou wget, tar e sha256sum ou shasum. No Alpine, o pacote musl é escolhido sozinho; instale libstdc++ e libgcc.
irm https://apicultura.app/install.ps1 | iexRode no PowerShell. Windows x64; no ARM64 o instalador usa o pacote x64 pela emulação do Windows. Depois, reabra o terminal para atualizar o PATH.
2Entre na sua conta
beecode login3Faça o primeiro pedido
beecode "explique este repositório"Sem argumentos, beecode abre a interface interativa.
- Checksum verificado. O instalador confere o SHA256 do pacote antes de extrair e só troca o executável depois de rodar
--version. - Sem sudo, sem telemetria. Instala em
~/.local/bin(ou/usr/local/bincomo root) e avisa como ajustar o PATH, sem editar o seu shell. - Pode rodar de novo. Para atualizar, execute o instalador outra vez.
BEECODE_VERSIONfixa a versão eBEECODE_INSTALL_DIRmuda o destino. - Git é necessário para checkpoints e worktrees. Node e Bun não são necessários para executar o pacote.
Recursos
Tudo o que um agente de terminal precisa
Só o que existe no beecode hoje, do prompt à revisão.
Permissão antes de executar
Cada ação sensível abre um aviso com “Permitir uma vez”, “Permitir na sessão” ou “Recusar”. Configurações executáveis de um projeto só valem depois de beecode confiar.
Desfazer e refazer
/desfazer e /refazer revertem e reaplicam as alterações da conversa. Checkpoints e worktrees usam o Git.
Sessões retomáveis
Volte a uma conversa com /sessoes, compacte com /compactar, ramifique com /ramificar, veja o /historico e exporte localmente com /exportar.
Ferramentas MCP da APIcultura
As conexões MCP aparecem em /ferramentas e o rodapé mostra quantas estão ativas. Mídia e outras ferramentas dependem do que o MCP da APIcultura anuncia.
Mídia no terminal
/midia lista tarefas retomáveis e beecode midia imagem.png mostra a prévia em terminais com Kitty, iTerm2 ou Sixel. Sem suporte gráfico, o caminho do arquivo continua disponível.
Voz local e opcional
Segure a barra de espaço com o prompt vazio e fale. A transcrição roda no seu computador, o texto volta editável e não é enviado sozinho. O recurso só é baixado depois da sua confirmação, com hash verificado.
Arquivos, skills e AGENTS.md
Anexe arquivos com @, escreva em várias linhas e cole texto. /inicializar cria ou atualiza o AGENTS.md, /habilidades lista skills locais e /revisar revisa as alterações.
Acessível e portátil
Todos os comandos têm nome em português e em inglês. Funciona em 16 cores, 256 e truecolor, e respeita NO_COLOR, BEECODE_ASCII, BEECODE_REDUCE_MOTION e BEECODE_MOUSE=0.
Login
Entre pelo navegador, sem colar chave
O beecode login usa autorização por código de dispositivo: a aprovação acontece no painel da APIcultura e a chave vai direto para o seu terminal.
Peça o código
Ao rodar
beecode login(ou/entrarna interface), o terminal recebe um código no formatoXXXX-XXXXe abre o navegador no painel.Confirme no painel
O painel só aprova com a sua sessão ativa e, se você usa 2FA, com a verificação concluída. Você também pode negar.
A chave chega uma vez
O terminal aguarda a aprovação e recebe a chave uma única vez, por até 10 minutos. Ela nunca aparece na URL, no navegador nem no chat.
Guardada com cuidado
A chave fica no chaveiro do sistema, quando houver, ou em
~/.beecode/credentialscom acesso 0600.
Ver saldo
beecode whoami mostra a conta e o saldo.Sair
beecode logout remove a credencial local.AutomaçãoUse
BEECODE_API_KEY_FILE para apontar um arquivo com a chave.Modelos
Mel, Bee e Favo: troque quando quiser
O beecode trabalha com os três modelos da APIcultura. Mel 5.5 já vem selecionado; troque em /modelos ou com ctrl+x m.
Mel 5.5
Maior capacidade. Para tarefas longas e complexas.
Bee 5.5
O meio-termo entre capacidade e custo.
Favo 5.5
Rápido e econômico, para o dia a dia.
Uso e planos
Uma conta, um saldo em reais
O beecode usa a sua conta APIcultura. O uso dos modelos e das ferramentas sai do mesmo saldo pré-pago em R$. Os planos mensais da conta abaixo creditam mais do que o valor pago.
R$ 149 /mês
- R$ 163,90 em créditos a cada pagamento confirmado
- Saldo vale para modelos e ferramentas
R$ 399 /mês
- R$ 478,80 em créditos a cada pagamento confirmado
- Saldo vale para modelos e ferramentas
Valores publicados pela API da APIcultura em 11/11/2026. Confira sempre a versão atual no painel. Preços por uso dos modelos e das ferramentas estão em apicultura.app. O rodapé do beecode mostra o contexto e as janelas de uso de 5 horas e da semana quando a API informa esses dados.
Perguntas
Perguntas frequentes
Preciso de conta para usar?
Sim. O modo normal usa a API da APIcultura, com a sua conta e o seu saldo. Para testar a interface sem cobrança, BEECODE_MODE=mock beecode roda em modo local, com respostas de teste.
O beecode roda comandos sozinho?
Depende do modo. Em ask ele pede autorização para executar comandos, editar ou usar ferramentas externas. Em plan apenas lê e planeja. Em auto executa conforme a política configurada. Permissões não substituem o isolamento do sistema operacional.
Onde ficam minha chave e meus dados?
A chave fica no chaveiro disponível ou em ~/.beecode/credentials, com acesso 0600. As configurações do projeto ficam em .beecode/ e os dados do usuário em ~/.beecode. Veja também a Política de Privacidade da APIcultura.
O que acontece com o áudio da voz?
A voz é local e opcional. O áudio fica no seu computador, a transcrição volta como texto editável e nada é enviado automaticamente.
Funciona no Windows e no Alpine?
Sim. No Windows x64, use o instalador do PowerShell; no Windows ARM64 ele usa o pacote x64 pela emulação. No Alpine, o instalador escolhe o pacote musl e você precisa de libstdc++ e libgcc.
Como atualizo ou removo?
A atualização é explícita: rode o instalador de novo. O beecode não executa instaladores remotos sozinho. Para remover a credencial local, use beecode logout.
Posso escolher outros modelos?
O beecode oferece Mel 5.5, Bee 5.5 e Favo 5.5. Não há seletor de infraestrutura nem de outros provedores.
Tem licenças de terceiros?
Sim. As licenças integrais aparecem em /licencas na interface, em beecode licencas no shell e no arquivo LICENCAS-DE-TERCEIROS.txt incluído no pacote.
Pronto para abrir a colmeia?
Instale, confirme o código no navegador e faça o primeiro pedido.