Skip to content

docs: fix --move reference (no board picker, bare board names, replace semantics) - #67

Open
alycda wants to merge 1 commit into
taskbook-sh:masterfrom
alycda:docs-move-reference
Open

alycda wants to merge 1 commit into
taskbook-sh:masterfrom
alycda:docs-move-reference

Conversation

@alycda

@alycda alycda commented Oct 27, 2026

Copy link
Copy Markdown

Two statements in the --move section of docs/cli-reference.md do not match the code in move_boards (crates/taskbook-client/src/taskbook.rs):

  • "Opens a board picker if the board name is omitted": there is no picker; an omitted board is a missing_boards error.
  • tb --move @3 @personal # @ prefix is optional for board name: every @-prefixed word is read as an item id, so this fails with "More than one ids were given". Board names must be bare.

The section also did not say that the listed boards replace the item's current set, which is what set_boards does (and what the original taskbook did). Verified on v1.5.0 by running each command against a copy of a real board. Docs only, no code change.

🤖 Generated with Claude Code

…e semantics)

The CLI reference said --move opens a board picker when the board is omitted
and that the @ prefix is optional for the board name. Neither matches the
code: move_boards in crates/taskbook-client/src/taskbook.rs treats every
@-prefixed word as an item id, so 'tb --move @3 @personal' fails with
"More than one ids were given", and an omitted board is a missing_boards
error; no picker exists. It also replaces the item's board set rather than
adding to it. Verified on v1.5.0 by running the commands.

Co-Authored-By: Claude Fable 5.1 <[email protected]>
Comment thread docs/cli-reference.md
tb --move @3 work personal # now on exactly these two boards
```

Board names are given bare. A second `@`-prefixed word is read as another item ID, so `tb --move @3 @personal` fails with "More than one ids were given".

@alycda alycda Oct 27, 2026 •

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

additionally, the original tb has (imo, wildly) inconsistent semantics for the @ character. I've gone nuts with addressing that here: alycda#4 (still hacking on it, not ready, just ideation)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant