Nod

nod

A task manager where each task is a markdown file. Works great with git and Claude Code.


Install

Requires [Bun](https://bun.sh).

npm install -g @onmyway133/nod

How it works

Each task lives in its own `.md` file inside `.nod/tasks/`:

.nod/
  config.json
  tasks/
    epic-1-onboarding.md
    task-2-setup-database.md
    subtask-3-write-migrations.md

Tasks have a YAML header with fields like status, priority, and parent. The rest of the file is free-form markdown — description, notes, work log, anything you want.

Because tasks are plain files, you can commit them to git, review diffs, and read them in any editor.

Quick start

cd my-project
nod init

nod create epic "Build auth system"
nod create task "Design database schema" --parent epic-1 --priority high
nod create subtask "Write migrations" --parent task-2
nod create bug "Fix token expiry" --parent task-2

nod available        # what to work on
nod tree epic-1      # visual overview
nod ui               # open Kanban board in browser

Commands

`nod init`

Set up a nod project in the current directory. Creates `.nod/` with `config.json` and a `tasks/` subfolder inside it.

`nod create `

Create a task. Types: `epic`, `task`, `subtask`, `bug`.

nod create epic "Launch v2"
nod create task "Write tests" --parent epic-1 --priority high
nod create bug "Crash on logout" --parent task-3 --tags auth,crash

Options: `--parent `, `--priority

`, `--tags `

`nod list`

List tasks with optional filters.

nod list
nod list --status todo
nod list --priority high
nod list --type task --parent epic-1
nod list --json

`nod available`

Show tasks ready to work on (`todo` or `in-progress`), sorted by priority.

nod available
nod available --json

`nod get `

Show a task's full content.

nod get task-2
nod get task-2 --json

`nod update `

Change task fie