tm — SQLite CLI Task Manager (for humans + agents)

A simple, agent-friendly CLI task manager.

• Projects identified by stable key
• Tasks with arbitrary-depth subtasks (parent_id)
• Optional strict JSON output for automation (--json)

Quickstart

npm install
npm run dev -- --help

# create a project
npm run dev -- project add demo "Demo"

# add tasks
npm run dev -- task add -p demo "Parent"
npm run dev -- task add -p demo --parent 1 "Child"

# list tree
npm run dev -- task ls -p demo

# machine-readable output
npm run dev -- task ls -p demo --json

Database location

Default: ~/.tm/tasks.db

Override:

• --db <path>
• TM_DB_PATH=/path/to/db

Design

See docs/DESIGN.md.