todo

todo

Eén to-do lijst voor al je Claude Code sessies. Persistent, lokaal, zonder cloud.

Voor developers die meerdere sessies parallel draaien — per branch, per feature, per worktree — en die versplinterd werk willen centraliseren zonder Linear, Jira, Trello of Notion te openen.

---

Het probleem

Als je serieus met Claude Code werkt heb je al snel meerdere sessies tegelijk open:

• Eén sessie refactort de auth module
• Een andere debugt een flaky test op feat/billing-v2
• Een derde staat in een worktree te wachten op review-feedback
• En in een vierde zit je vandaag's plan-document

De ingebouwde TodoWrite tool van Claude verdwijnt zodra je /clear doet of de sessie sluit. Je eigen todo's — "dit moet ik morgen nog testen", "vergeet niet PR #1234 te reviewen" — leven dan op post-its, in een markdown ergens, of in je hoofd.

Resultaat: je start maandag een sessie, ziet lege context, en vraagt je af waar je vrijdag was gebleven in die ándere sessie.

De oplossing

Eén globale to-do lijst (~/.claude-todo/todos.json) die elke sessie deelt. Taken worden automatisch getagd met de branch, het plan-bestand en de PR waarin ze zijn ontstaan — zodat je later precies weet waar iets bij hoorde.

flowchart LR
    S1[Sessie A<br/>feat/auth]:::sess --> L[(~/.claude-todo/<br/>todos.json)]:::data
    S2[Sessie B<br/>feat/billing]:::sess --> L
    S3[Sessie C<br/>worktree/review]:::sess --> L
    S4[Sessie D<br/>plan-mode]:::sess --> L
    L --> UI[HTML UI<br/>localhost:3737]:::ui
    L --> CLI["/todo, /todo-add<br/>!todo-done, …"]:::cli

    classDef sess fill:#eff6ff,stroke:#1d4ed8,color:#1e3a8a
    classDef data fill:#fef3c7,stroke:#92400e,color:#78350f,stroke-width:2px
    classDef ui fill:#d1fae5,stroke:#047857,color:#064e3b
    classDef cli fill:#e0e7ff,stroke:#4338ca,color:#312e81

Simpel en licht

Geen database, geen auth, geen cloud, geen dependencies. Eén JSON-bestand en twee Node-scripts.

Wat	Waarom licht
Data	Plain JSON op disk — jq en cat werken out of the box
CLI	Pure Node.js, geen node_modules
Server	Inline HTML + http module — 0 npm packages
UI	Vanilla JS + contenteditable — geen React, geen build step
Distributie	Claude Code plugin via GitHub, één /plugin install

Totale codebase: ~1500 regels. Bootet in milliseconden. Geen background processes.

Installatie

/plugin marketplace add Michieldejongh/todo-plugin
/plugin install todo@todo-marketplace

Herstart je sessie. Klaar.

De SessionStart hook maakt bij eerste run ~/.claude-todo/todos.json aan en symlinkt de shell-wrappers naar ~/.local/bin/ (als die op je PATH staat). Volledig idempotent — volgende sessies doen niks.

Een typische flow

sequenceDiagram
    autonumber
    participant Dev as Developer
    participant CC as Claude Code
    participant P as Plugin
    participant D as ~/.claude-todo/<br/>todos.json
    participant GH as GitHub

    Dev->>CC: Start sessie op feat/auth
    Dev->>CC: /todo-session
    CC->>P: session-prepare
    P->>D: lees
    P->>GH: gh pr view feat/auth
    GH-->>P: PR-URL
    P-->>CC: auto-titel + plan + PR
    Dev->>CC: Kies titel (Enter)
    CC->>D: schrijf taak (in_progress)
    Note over Dev,CC: Werken werken werken…
    Dev->>CC: /todo-note <id> test faalt nog op Safari
    CC->>D: append notitie
    Dev->>CC: !todo-ui
    P-->>Dev: browser opent op :3737<br/>edit inline, klik ↗ naar PR
    Dev->>CC: /todo-session-done
    CC->>D: status = done + completedAt

Commands

Tab na /todo in Claude Code opent een picker met alle varianten.

Command	Shortcut (bash !)	Doet
/todo	!todo	Interactief overzicht + actie-keuze
/todo-add <titel>	!todo-add <titel>	Nieuwe taak (auto branch/plan/PR)
/todo-start <id>	!todo-start <id>	Op "bezig" zetten
/todo-done <id>	!todo-done <id>	Afronden
/todo-note <id> [tekst]	!todo-note <id> …	Notitie toevoegen
/todo-edit <id> <titel>	!todo-edit <id> …	Titel aanpassen
/todo-due <id> <YYYY-MM-DD>	!todo-due <id> …	Deadline (of clear)
/todo-rm <id>	!todo-rm <id>	Verwijderen (bevestigt bij actief)
/todo-session	!todo-session	Huidige Claude-sessie als taak
/todo-session-done	!todo-session-done	Sessie-taak afronden
/todo-ids	!todo-ids	Compacte ID-lijst (kopieerhulp)
/todo-ui	!todo-ui	HTML frontend op http://localhost:3737

ID-matching: prefix of 5-char suffix volstaat. t_2026 werkt als het uniek is, anders zie je kandidaten.

Wat je krijgt

Automatisch gekoppeld aan je werk:

• gitBranch — automatisch uit git branch --show-current
• planSlug — recent gewijzigd ~/.claude/plans/*.md wordt gedetecteerd
• prUrl — gh pr view <branch> wordt silent aangeroepen
• sessionId + sessionTitle — via de huidige ~/.claude/projects/ transcript