Skip to content

v1.10.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 09 Sep 00:51
· 24 commits to main since this release
Immutable release. Only release title and notes can be modified.
v1.10.0
00d136f
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

kb v1.10.0

v1.10.0 is a breaking release: kb no longer has an active project. A task's
project is named on the command that creates it, and nothing else decides
where a task lands. kb project use, kb project current, the KB_PROJECT
environment variable, the state.json file in the data directory, and the
web endpoint PUT /api/projects/active are gone. The database schema is
unchanged.

The stored default caused misfiling. Two shells or two agents sharing one data
directory filed tasks into each other's project, and switching project in the
web UI silently changed where the next kb add landed. With the project on
the command, every caller says where its task goes and no caller can change
that for another.

CLI

  • kb add "title" -p <name> names the project. --project and
    --tag project::<name> are equivalent spellings. Without one, add refuses
    with no project given: pass -p <name> or --tag project::<name>.
  • kb list -p <name> shows one project. Without -p, every project is listed.
  • Commands addressed by task number (update, done, move, cancel, rm,
    comment, link) need no project. kb update <id> -p <name> still moves a
    task to another project.
  • kb project list remains. Its table loses the ACTIVE column and its --json
    rows lose the active field. kb project use and kb project current are
    removed.
  • KB_PROJECT is no longer read, and state.json is neither read nor written.

MCP

  • The add_task tool's project argument is required.

TUI

  • The board opens on all projects unless it remembers a switcher scope in its
    own preferences file under .kb-tui/. p and P still switch the view.
  • The new-card editor requires a project when the scope is all projects.

Web UI

  • The board keeps its selected project in the browser only. Switching it no
    longer affects the CLI, the TUI, or another browser tab.
  • PUT /api/projects/active is removed.

Migration

  • Replace kb project use x with -p x on each kb add.
  • Drop KB_PROJECT from shell profiles and agent configurations; it has no
    effect.
  • Scripts that relied on the stored default must pass -p <name> to kb add.
  • state.json in the data directory is unused and can be deleted.
  • MCP clients must pass project to add_task.
  • Anything that called PUT /api/projects/active must stop; the endpoint is
    gone.

Upgrade

Make a cold backup of the data directory first. Then, with Go 1.26.5 or newer:

GOTOOLCHAIN=local go install github.com/RandomCodeSpace/kb@v1.10.0
kb version

The release provides CGO-free binaries for Linux amd64 and arm64, macOS amd64
and arm64, and Windows amd64. Each binary records Go 1.26.5 in its embedded
build metadata.

Assets 9
Loading