AI-native task management for developers
npm install @teedee/tdPersistent memory for AI coding agents.
Stop re-explaining your project every session. td gives your AI the context it needs - in files that survive session resets, machine changes, and team handoffs.
AI coding assistants forget everything between sessions. Every conversation starts blank:
- "We're building a task management CLI..."
- "We decided to use markdown files because..."
- "The auth epic is blocked on..."
You waste hours re-explaining. Projects lose momentum. Knowledge lives only in your head - exactly where AI can't access it.
td is a filing system for AI-assisted development. Markdown files that don't forget.
``bash`
npm install -g @teedee/td
cd your-project
td init
That's it. Your AI now has:
- Structure - Tasks, epics, iterations. The AI always knows where to look.
- Memory - Decisions, learnings, vision docs. Survives every session restart.
- Efficiency - ~1KB manifest loaded at session start. Full details fetched on demand.
td provides two interfaces to the same data:
- CLI for you - td add, td start, td done
- MCP for your AI - Claude queries tasks directly, no copy-paste
`
You: "What should I work on?"
Claude: [calls get_context]
Claude: "TSK-042 is blocked by TSK-039. Want me to finish TSK-039 first?"
No clipboard. No "run this and paste the output". Claude just asks td directly.
`bash`
npm install -g @teedee/td
cd your-project
td init
td init auto-configures the MCP server for Claude Code.
`bashCreate an iteration (sprint)
td iteration sprint-1 --goal "MVP" --capacity 20
$3
bash
td start TSK-001 # Begin work
... do the work ...
td done TSK-001 # Complete it
td commit # Commit with task ref
`$3
Your AI reads the project state at session start. It can:
- See what's blocked and why
- Create well-scoped tasks from your ideas
- Log findings during work
- Run retrospectives at iteration end
Core Commands
| Command | What it does |
|---------|--------------|
|
| Initialize td in your project |
| td add "title" | Create a task |
| td list | List tasks |
| td start | Begin work on a task |
| td done | Complete a task |
| td board | Kanban view |
| td blocked | See what's blocked |
| td iteration | Manage sprints |
| td epic | Manage feature areas |
| td catchup | Brief your AI on project state |Context That Persists
td creates a
docs/ folder for knowledge that survives:| File | Purpose |
|------|---------|
|
vision.md | What you're building and why |
| decisions.md | Architectural choices and rationale |
| learnings.md | Discoveries from building |Your AI reads these at session start. No re-explaining.
File Structure
`
your-project/
├── tasks/ # Task markdown files
├── epics/ # Feature areas
├── iterations/ # Sprints
├── docs/ # Persistent context
│ ├── vision.md
│ ├── decisions.md
│ └── learnings.md
└── .td/ # Internal config
Everything is markdown. Git-friendly. Human-readable. Portable.
- Node.js 18+
- Claude Code (td auto-configures MCP)
MIT