From a049eeafbe64bab2d5b65ec8642389f730949916 Mon Sep 17 00:00:00 2001 From: Alyssa Evans Date: Mon, 26 Oct 2026 20:18:14 -0700 Subject: [PATCH] docs: fix --move reference (no board picker, bare board names, replace 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 --- docs/cli-reference.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/cli-reference.md b/docs/cli-reference.md index 77167f6..f9390f8 100644 --- a/docs/cli-reference.md +++ b/docs/cli-reference.md @@ -173,13 +173,15 @@ tb --move @ tb -m @ ``` -Moves an item to a different board. Opens a board picker if the board name is omitted. +Moves an item to one or more boards. The listed boards replace the item's current boards; omitting the board name is an error. ```bash tb --move @3 work -tb --move @3 @personal # @ prefix is optional for board name +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". + ## Deleting and Restoring ### Delete Item