Tiny command-line task tracker. Stores tasks in ~/.pulse/tasks.json (override with PULSE_HOME). TypeScript, Node 20+, tested with vitest.
pulse add "review PR #482" --due tomorrow --tag work --tag urgent
pulse list
pulse complete 1
pulse search "review"
pulse stats| Command | What it does |
|---|---|
pulse add <title> [--due <date>] [--tag <t...>] |
Add a task. <date> is today, tomorrow, +Nd, or YYYY-MM-DD. |
pulse complete <id> |
Mark a task done. |
pulse list [--due-soon] [--tag <tag>] |
List tasks; sort by due date or filter to a tag. |
pulse search <query> |
Search titles and tags. |
pulse stats |
Totals, completion, overdue count, and per-tag counts. |
npm install
npm run start -- add "first task" # run via tsx
npm test # vitest
npm run typecheck # tsc --noEmit
npm run build # emit dist/This repo is a fixture for the 42n-bot automated implementer. It ships with deliberately-seeded bugs across four difficulty tiers — they are the test surface and should not be "helpfully" fixed outside of the bot workflow. See the seed issues in the project tracker.