Task tracking
for AI agents.

No cloud. No signup. No API keys. Just YAML files your agents can read, write, and commit.

$ npm install -g tskrun Copied!
~/my-project
tsk add "Refactor auth module" --priority high --by claude
Created TSK-1
tsk add "Write unit tests" --by claude
Created TSK-2
tsk move TSK-1 doing --by claude
TSK-1 → in_progress
tsk list --json
[{"id":"TSK-1","title":"Refactor auth module","status":"in_progress"},
{"id":"TSK-2","title":"Write unit tests","status":"todo"}]

Built for agents

01

Agent-native

YAML files agents read and write directly. No API keys, no auth, no network calls.

02

Zero config

One command to start. tsk init and your agent is tracking work in seconds.

03

Attribution

Every command takes --by name. Know which agent made which change, always.

04

Pipe-friendly

JSON output by default for non-TTY. Built for automation, not just humans.

05

Git-native

Tasks commit alongside code. Multi-file storage means clean diffs across branches.

06

Audit trail

Every change is logged. Full activity history per task with tsk log.

Commands

tsk init Initialize a project in the current directory
tsk add Create a new task with title, priority, and tags
tsk list List tasks, filter by status, priority, or tag
tsk view View full details of a specific task
tsk move Move a task between statuses (todo, doing, done)
tsk edit Update task title, priority, or tags
tsk note Add a note to any task
tsk log View the activity log for a project
tsk archive Archive completed tasks to keep your board clean
tsk web Launch a local web dashboard for your board
tsk summary Quick overview of task counts by status