Quickstart

Make a workspace and a project

A workspace is a folder holding your boards. It does not need to be a git repository.

mkdir ~/boards && cd ~/boards
primum workspace init
primum init my-app && cd my-app

workspace init writes primum.toml; init my-app makes the subfolder my-app with project.json and an empty items/, and starts its history.

Add items

primum add BUG "Empty board crashes on + new" --urgency 8
primum add TODO "Export open items as CSV" --impact 6 --effort 3
primum add DEBT "Split server.rs into routes and pages" --effort 6 --needs 2

Each prints its number: 1, 2, 3. One counter numbers every item, in any lane, and #3 is how you refer to an item. #3 waits for #2 and is blocked until that is closed.

Decide what to do

primum list      # open items, highest priority first
primum next      # the top unblocked items
primum start 1
primum done 1

Open the board

primum serve

The board opens in your browser at http://127.0.0.1:8777/. Click a row to open an item, edit its scores in place, or add one with + new.

Next

• Items, lanes and scores: how the order is computed.
• History and sync: the same board on two machines.