td

Persistent 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.

The Problem

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.

The Solution

td is a filing system for AI-assisted development. Markdown files that don't forget.

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.

How It Works

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.

Quick Start

1. Install and init

npm install -g @teedee/td
cd your-project
td init

td init auto-configures the MCP server for Claude Code.

2. Create work structure

# Create an iteration (sprint)
td iteration sprint-1 --goal "MVP" --capacity 20

# Create an epic (feature area)
td epic auth -D "User authentication"

# Create a task
td add "Implement login" -e auth -i sprint-1 -c M

3. Work on tasks

td start TSK-001          # Begin work
# ... do the work ...
td done TSK-001           # Complete it
td commit                 # Commit with task ref

4. Let AI help

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 | |---------|--------------| | td init | Initialize td in your project | | td add "title" | Create a task | | td list | List tasks | | td start <ref> | Begin work on a task | | td done <ref> | 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.

Requirements

• Node.js 18+
• Claude Code (td auto-configures MCP)

Links

• Website
• GitHub
• Issues

License

MIT