Module cli 

The command line: which command to run, with its options.

• [entries]: commands that read or change entries by id, for agents and scripts.
• [mod@init]: a project’s .brain/, and the section telling its agents about it; deinit undoes it.
• [claude]: the Claude Code hooks init adds: the context at each session start, and [hook]’s checks.
• [hook]: kb hook prompt|stop, which hold an agent to describing an undescribed project first, and to commenting on the tasks it started.
• [completions]: kb completions SHELL, tab completion, and the ids, projects and tags it offers.
• update: kb update and the app’s, the latest release over this one, through the installer, once no agent is working.

Modules

update

kb update, and the app’s update: installs the latest release over this one, by running the installer the README gives, which downloads it, checks its checksum and replaces the binaries, then runs the new version’s init --all, so none of that is repeated here. Never while an agent works on a task: init --all would rewrite its instructions and a migration its data mid-session.

Structs

AddArgs

Options of add.

EntryArgs

One of the entry commands, and whether to print JSON.

ListArgs

Options of kb list.

Program

The binary running the command line, named in the usage text and --version.

ReportArgs

Options of kb report.

Enums

Command

What to do, as chosen on the command line.

EntryCommand

What to do to which entry.

ProjectChange

What project changes.

ProjectPart

What project changes in one of its texts.

Text

Text given on the command line, or - to read it from stdin (for multi-line markdown).

Functions

init

Makes root a repository of project name (else the one its card names, else one named after the folder), named repo in it (else as projects::repo_name picks): creates its .brain/ and card, registers it in central (joining the project’s other repositories if it has some), creates the project’s shared card if it’s new, and writes or refreshes the section in each agent file of root (creating CLAUDE.md if there’s none). Returns what it did, one line each.

move_repo

Moves the repository whose .brain/ is dir to project to, created if new, as kb init to there would. Links between it and its old project’s repositories are dropped on both sides: they’d name repositories of another project.

remove_project

Takes every repository of project out, as remove_repo does each, which removes the project’s card with the last.

remove_repo

Takes the repository whose .brain/ is dir out of its project, as kb deinit does, and drops its old siblings’ links to it. With purge, its .brain/ goes too: its tasks, notes and decisions.

rename_project

Renames project old to new: the registry, its shared card, and each of its repositories’ cards.

rename_repo

Renames the repository whose .brain/ is dir to new in its project, and rewrites its siblings’ links to it (old#3 becomes new#3).

usage

Printed by --help and after a command-line error. The status, period and group names come from Status, Unit and Group, so they’re only written there.