amenbo

amenbo 6.0.0 — um projeto se cria com uma pasta

Criar um projeto agora pede a pasta em que ele vive, porque uma IA chega a um projeto por uma pasta. A última pasta agora pode ser desvinculada, e um projeto que fica sem nenhuma é apontado até você resolver.

Uma IA chega a um projeto por uma pasta, então um projeto sem pasta não pode ser operado de lugar nenhum. Criar um agora sempre pede uma pasta, e um projeto que acaba sem nenhuma avisa. Leia a seção de atualização antes de subir de versão.

Um projeto se cria com uma pasta

O amenbo project add agora precisa de --dir.

$ amenbo project add --name Greenhouse --actor human
error: the following required arguments were not provided:
  --dir <DIR>

$ amenbo project add --name Greenhouse --dir /work/greenhouse --actor human
✓ Created project: Greenhouse (1) — linked to /work/greenhouse

Na tela é igual — a tela de projeto novo tem um campo de pasta, e Criar fica sem poder ser apertado até uma pasta ser escolhida.

A última pasta agora pode ser desvinculada

Uma pasta tinha que ficar. Agora ela pode ser removida, e a resposta diz com o que isso te deixa.

$ amenbo unbind --actor human --yes
✓ Unbound /work/greenhouse (removed: .amenbo, AGENTS.md, CLAUDE.md). The project is kept.
  This project now has no folder. An AI reaches a project through a folder, so nothing can
  operate it until one is linked again (`amenbo bind --project <name or ID>`).

Um projeto sem pasta é apontado em dois lugares

Para não ser esquecido.

  • No quadro do projetoThis project has no folder linked, com uma ação Link a folder ao lado. Os cartões do próprio quadro continuam ali embaixo.
  • No amenbo doctor — e, se você parou de trabalhar naquele projeto, o amenbo project archive é a alternativa a vincular uma pasta de novo. De um projeto arquivado não se pede pasta.
$ amenbo doctor --actor human
doctor: 1 issue(s) (error 0 / warning 1)
  [warning] project_without_folder (1):
    Project #1 'Greenhouse' has no folder on this machine leading to it: there is nowhere to
    operate it from, and an AI cannot reach it at all.

As pastas cuja IA não começa pelo amenbo também são apontadas

Uma pasta pode estar vinculada e mesmo assim não ter nenhuma ligação com o amenbo nas configurações da ferramenta de IA de lá, e nesse caso a IA trabalha sem nunca consultar o amenbo. O amenbo doctor agora pega esses casos.

$ amenbo doctor --actor human
doctor: 1 issue(s) (error 0 / warning 1)
  [warning] unwired_folder_ambiguous (1):
    /work/worker does not start its AI on amenbo, and shows no sign of which tool is used
    there, so nothing can say which wiring is missing.
  • amenbo agent-hook snippet <tool> imprime o texto para entregar à IA que roda naquela pasta — o amenbo nunca edita esses arquivos de configuração no seu lugar.
  • A mesma lista aparece na tela de configurações do próprio projeto.

Coisas menores

  • O quadro carrega um aviso fixo só — antes vários podiam se empilhar.

Antes de atualizar

  • O formato dos dados guardados sobe — ele migra sozinho na primeira vez que uma versão mais nova o abre, e um backup é tirado antes. Versões antigas não conseguem abrir depois disso, então não deixe a GUI nem a CLI na versão antiga (o mesmo instalador atualiza as duas).
  • Acrescente --dir a todo amenbo project add — nos seus próprios scripts, e nas instruções que você entrega à sua IA.

Como obter

Abra o instalador do seu sistema na versão mais recente. Não precisa de direitos de administrador.

  • macOS — .pkg, um para Apple silicon e um para Intel (a GUI e a CLI vêm juntas; a primeira abertura mostra um aviso do Gatekeeper: clique com o botão direito → Abrir)
  • Windows — .exe de instalação (a GUI e a CLI vêm juntas)
  • Linux — a GUI é um AppImage; o comando amenbo vem do instalador da CLI

Para atualizar: na GUI, o banner de “há uma versão mais nova” aplica a atualização ali mesmo. Se você instalou só a CLI, amenbo update --apply faz a troca.

Chegou agora? Veja Começar.