CLI Reference

Complete command reference for Knowns CLI

4 min read

CLI Reference

Complete reference for all Knowns CLI commands.

Global Options

Option	Description
`--version`	Show version number
`--help`	Show help
`--plain`	Output in plain text (for scripts/AI)
`--json`	Output in JSON format

Task Commands

`knowns task create`

Create a new task.

knowns task create "Title" [options]

Option	Description
`-d, --description`	Task description
`--ac`	Acceptance criterion (repeatable)
`-p, --priority`	Priority: low, medium, high
`-l, --labels`	Comma-separated labels
`-a, --assignee`	Assign to user

`knowns task list`

List tasks.

knowns task list [options]

Option	Description
`-s, --status`	Filter by status
`-p, --priority`	Filter by priority
`-a, --assignee`	Filter by assignee
`-l, --label`	Filter by label
`--tree`	Show as tree hierarchy

`knowns task view`

View task details.

knowns task view [id] [options]

`knowns task edit`

Edit a task.

knowns task edit [id] [options]

Option	Description
`-t, --title`	New title
`-d, --description`	New description
`-s, --status`	New status
`-a, --assignee`	New assignee
`--ac`	Add acceptance criterion
`--check-ac`	Check criterion by index
`--uncheck-ac`	Uncheck criterion
`--remove-ac`	Remove criterion
`--plan`	Set implementation plan
`--notes`	Set implementation notes
`--append-notes`	Append to notes

Documentation Commands

`knowns doc create`

Create a new document.

knowns doc create "Title" [options]

Option	Description
`-d, --description`	Document description
`-t, --tags`	Comma-separated tags
`-f, --folder`	Folder path

`knowns doc list`

List documents.

knowns doc list [options]

Option	Description
`--tag`	Filter by tag

`knowns doc view`

View document content.

knowns doc view "name" [options]

`knowns doc edit`

Edit document.

knowns doc edit "name" [options]

Option	Description
`-t, --title`	New title
`--tags`	New tags
`-c, --content`	Replace content
`-a, --append`	Append to content

Time Tracking Commands

`knowns time start`

Start timer for a task.

knowns time start [id]

`knowns time stop`

Stop active timer.

knowns time stop

`knowns time pause`

Pause active timer.

knowns time pause

`knowns time resume`

Resume paused timer.

knowns time resume

`knowns time status`

Show timer status.

knowns time status

`knowns time add`

Add manual time entry.

knowns time add [id] [duration] [options]

Option	Description
`-n, --note`	Note for entry
`-d, --date`	Date (YYYY-MM-DD)

`knowns time report`

Generate time report.

knowns time report [options]

Option	Description
`--from`	Start date
`--to`	End date
`--by-label`	Group by label
`--csv`	Output as CSV

Search Commands

`knowns search`

Search tasks and docs.

knowns search "query" [options]

Option	Description
`--type`	Filter: task, doc
`--status`	Filter by status
`--priority`	Filter by priority

Other Commands

`knowns init`

Initialize Knowns in current directory.

knowns init [name]

`knowns browser`

Open browser UI.

knowns browser [options]

Option	Description
`-p, --port`	Port number (default: 3000)

`knowns status`

Show project status.

knowns status