Commands

Command	Does
init	Make a project, in a workspace or here
workspace	Make a workspace, or migrate earlier boards
add	Add an item; prints its id
list	Items in priority order
show	One item: scores, needs, text and documents
next	What to work on now
set	Change an item’s fields
start, done	Mark an item in progress, or done
note	Append a dated note to an item
doc	Add or replace an item’s document
kind	Move an open item to another lane
delete	Delete an item and its documents
serve	Open the board in the browser
log	Changes to the project or one item
projects	The workspace’s projects
remote	This machine’s remote for the project
clone	Make a project from a remote
sync	Pull, merge and push now
resolve	Settle a conflict a sync left
import	Import a videre-board board, once
migrate	Bring a board made by an earlier version up to date

Choosing the project

Every command takes -p NAME (--project NAME) to pick a project of the workspace by name. Without it, primum uses the project containing the current folder, else the workspace’s only project. See workspaces.

Ids

An item’s id is its number. On the command line write 87 or #87 (quote #87 in shells that read # as a comment); output shows #87 with the item’s kind beside it.

Help

primum help, primum COMMAND --help and primum --version.