tk

Minimal task tracker. Simple, fast, git-friendly.

- Plain JSON files in .tasks/
- No daemons, no merge conflicts, no viruses

Install

Requires Bun runtime.

``bash


Install Bun first (if not installed)

curl -fsSL https://bun.sh/install | bash

Then install tk globally

bun add -g @nijaru/tk
`

Quick Start

`bash
$ cd myapp
$ tk init # project auto-derived from directory
Initialized: .tasks

$ tk add "Implement auth" -p 1
myapp-a7b3

$ tk add "Write tests" -p 2
myapp-x9k2

$ tk block x9k2 a7b3 # tests blocked by auth (just use ref)

$ tk ready # what can I work on?
ID | PRIO | STATUS | TITLE
-----------------------------------------------------------------
myapp-a7b3 | p1 | open | Implement auth

$ tk start a7b3 # just the ref works everywhere
Started: myapp-a7b3

$ tk log a7b3 "Using JWT approach"
Logged: myapp-a7b3

$ tk done a7b3
Completed: myapp-a7b3

$ tk ready # tests now unblocked
ID | PRIO | STATUS | TITLE
-----------------------------------------------------------------
myapp-x9k2 | p2 | open | Write tests
`

Commands

| Command | Description |
| --------------------------- | ------------------------------------------ |
| tk init | Initialize (project name from directory) |
| tk add