Commands

workspaces

List named workspaces from ~/.config/agentboard (or the platform config directory):

agentboard workspaces

Output contains one workspace name per line, sorted alphabetically.

run

Execute one Workspace Run: load config, read Sources, append item observations, render pending Actions, and execute Actions.

agentboard run work
agentboard run ./work.toml

Dry run collects and renders pending Actions without writing Store files or executing Actions:

agentboard run ./work.toml --dry-run

watch

Repeatedly run one Workspace until Ctrl-C.

agentboard watch work
agentboard watch work --interval 30s

Intervals are seconds with or without a trailing s.

watch holds the Workspace lock until it exits.

list

List latest stored items and derived Action state.

agentboard list work

Plain output:

AB-001	ready	pending	Create the first worktree

JSON output:

agentboard list work --json

show

Show one latest stored item and its Action attempts.

agentboard show work AB-001
agentboard show work AB-001 --json

If the same item id exists in multiple Store item buckets, use the qualified form shown in the ambiguity error:

agentboard show work jira-team-a-atlassian-net-abc123:AB-001

doctor

Validate a Workspace and local environment.

agentboard doctor work

Checks include:

• Workspace config validation.
• Store directory writability.
• Required Source commands, for example qmd.
• Required Action commands, for example git for agentboard/create-worktree.
• Source reachability by collecting items.

schema

Print the Workspace JSON Schema.

agentboard schema > agentboard.schema.json

Use this for editor validation and config discovery.