amenbo 9.0.0 — search narrows by which record, and by which part of it

Search used to make you pick task, decision or comment on a single knob. A comment hangs off both tasks and decisions, so there was no way to ask for the comments on decisions alone. Narrowing now has two independent axes, and each hit tells you where its record stands. Two changes to search break existing scripts — read the update section before you upgrade.

Two knobs: which record, and which part of it

--kind says which record the words are on, --face says which part of it. Naming both gives the product of the two.

$ amenbo search 在庫 --kind decision --face comment --actor ai
1 hit(s)
  [comment] AMB-D-… 在庫の数え方は週次にする · AMB-DC-…
      proposed
      在庫の棚卸しは倉庫の担当と一緒に行います

Each hit says where its record stands

A task shows its status, its priority and what it is filed under; a decision shows its status. It sits directly under the hit, so a hit on work that is already over says so without your opening it. The words that matched are highlighted inside the excerpt.

$ amenbo search 在庫 --actor ai
4 hit(s)
  [title] AMB-D-… 在庫の数え方は週次にする
      proposed
      在庫の数え方は週次にする
  [title] AMB-T-… 苗の在庫を数える
      todo
      苗の在庫を数える
  [comment] AMB-D-… 在庫の数え方は週次にする · AMB-DC-…
      proposed
      在庫の棚卸しは倉庫の担当と一緒に行います
  [comment] AMB-T-… 苗の在庫を数える · AMB-TC-…
      todo
      在庫は毎週月曜に数えています

Search can be scoped to one project

--project takes a project name or an ID and looks in that project alone. Scoping to a project keeps decisions in the answer.

On screen

• Target and face are separate knobs — target is tasks / decisions / both, face is title / body / comment / category / attachment.
• The project is chosen from a pull-down — right in the search row.
• A hit tells a comment on a task apart from a comment on a decision — the line says which record it is, and which part of it matched.
• Matched words are highlighted inside the excerpt — and the record’s standing sits with them.
• The structural narrowing box waits for a target — until you choose one it says to pick a target first.

Before you update

Two incompatible changes to search, both in your own scripts. The instructions you hand your AI need no editing, because amenbo agent --json returns the new form.

--kind comment is gone; it became --face comment. A comment is a face of a record, not a kind of record.

$ amenbo search 在庫 --kind comment --actor ai
Error: unknown kind 'comment' (task/decision — which record the words are on; which face of it is the other axis)

--filter now requires --kind. The two sides share spellings that mean different things — status:rejected is work decided against on a task, and a decision turned down on a decision.

$ amenbo search 在庫 --filter "status:todo" --actor ai
Error: a --filter is one side's vocabulary or the other's, so say which with --kind task or --kind decision (the same key can mean different things: `status:rejected` is work decided against on a task, and a decision turned down on a decision)

$ amenbo search 在庫 --kind task --filter "status:todo" --actor ai
2 hit(s)
  [title] AMB-T-… 苗の在庫を数える
      todo
      苗の在庫を数える
  [comment] AMB-T-… 苗の在庫を数える · AMB-TC-…
      todo
      在庫は毎週月曜に数えています

The stored data format does not change this time, so data from the previous version opens as it is.

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.