amenbo 6.0.0 — a project is created with a folder

An AI reaches a project through a folder, so a project with no folder cannot be operated from anywhere. Creating one now always asks for a folder, and a project that ends up without one says so. Read the update section before you upgrade.

A project is created with a folder

amenbo project add now needs --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

On screen it is the same — the New project screen has a folder field, and Create stays unpressable until a folder is chosen.

The last folder can now be unlinked

One folder used to have to remain. It can now be removed, and the reply says what that leaves you with.

$ 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>`).

A project with no folder is reported in two places

So that it isn’t forgotten.

• On the project’s board — This project has no folder linked, with a Link a folder action next to it. The board’s own cards still stand below it.
• In amenbo doctor — and if you have stopped working on that project, amenbo project archive is the alternative to linking a folder again. An archived project is not asked for one.

$ 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.

Folders whose AI doesn’t start on amenbo are reported too

A folder can be linked and still have no amenbo wiring in the AI tool’s own settings there, in which case the AI works without ever consulting amenbo. amenbo doctor now picks those up.

$ 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> prints the text to hand to the AI running in that folder — amenbo never edits those settings files on your behalf.
• The same list appears in the project’s own settings screen.

Smaller things

• The board carries a single standing notice — several used to be able to stack up.

Before you update

• The stored data format goes up — it migrates automatically the first time a newer version opens it, and a backup is taken beforehand. Older versions cannot open it afterwards, so don’t leave either the GUI or the CLI on the old version (the same installer updates both).
• Add --dir to every amenbo project add — in your own scripts, and in the instructions you hand your AI.

Getting it

Open the installer for your OS from the latest release. No admin rights are needed.

• macOS — .pkg, one for Apple silicon and one for Intel (GUI and CLI come together; first open shows a Gatekeeper prompt: right-click → Open)
• Windows — setup .exe (GUI and CLI come together)
• Linux — the GUI is an AppImage; the amenbo command comes from the CLI installer

To update: on the GUI, the “a newer version is available” banner applies it in place. If you installed only the CLI, amenbo update --apply swaps it.

New here? See Start.