Tasks that live
in your project.

A minimal CLI task tracker. No servers, no accounts, no context switching. Just YAML files committed alongside your code.

$ npm install -g tskrun Copied!
~/my-project
tsk init
Initialized tsk project (prefix: TSK, storage: multi-file)
tsk add "Design landing page" --priority high
Created TSK-1
tsk add "Set up CI pipeline"
Created TSK-2
tsk move TSK-1 doing
TSK-1 → doing
tsk list
doing
TSK-1 Design landing page high
todo
TSK-2 Set up CI pipeline

Why tsk

01

File-based

Tasks are stored as YAML files in your project directory. Commit them with your code.

02

Zero config

Run tsk init and start adding tasks. Sensible defaults, no setup required.

03

Git-friendly

Multi-file storage means clean diffs and conflict-free collaboration across branches.

04

Scriptable

JSON, YAML, and quiet output modes. Pipe tsk into any tool in your workflow.

05

No dependencies

No database, no server, no cloud sync. Works offline, works everywhere Node runs.

06

Activity log

Every change is tracked. Review project history with tsk log any time.

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