Developer context journal for AI-assisted coding - maintain project context across sessions
npm install @dvc2/tasktracker-cli


Your development memory across AI sessions.
TaskTracker is a lightweight CLI tool that maintains context about your development work. It's designed for developers who use AI assistants and need to preserve project context across different sessions, tools, and time.
Every developer using AI assistants knows this pain:
- Start new chat → Explain entire project context again
- Switch AI tools → Lose all conversation history
- Take a break → Forget where you left off
- Debug an issue → Can't remember what you already tried
TaskTracker solves this by being your persistent development memory.
``bashInstall globally
npm install -g tasktracker-cli
📖 Core Features
$3
Track your progress, decisions, and blockers:
`bash
tt j "Completed user authentication flow"
tt j --type decision "Switching from MongoDB to PostgreSQL"
tt j --type blocker "CORS issues with frontend"
tt j --tags api,auth "Added rate limiting to login endpoint"
`$3
Parse and maintain your project requirements:
`bash
tt prd "Build a task management API with real-time updates"
tt prd requirements.md # Or from a file
tt prd-show # View parsed requirements
`$3
Generate rich context for any AI assistant:
`bash
tt c # Quick context (last day)
tt cf # Full context (last 7 days)
tt cf 14 # Custom timeframe
tt cf --output ctx.md # Save to file
`$3
Find and export your development history:
`bash
tt journal-search "authentication" # Search entries
tt journal-show --type decision # Filter by type
tt journal-export markdown # Export journal
`💡 Real-World Usage
$3
`bash
Get back up to speed
tt c
Copy output to your AI assistant
`$3
`bash
Track progress
tt j "Added user profile endpoints"Document decisions
tt j --type decision "Using Redis for session storage - built-in expiration"Note blockers
tt j --type blocker "WebSocket connection drops after 30 seconds"
`$3
`bash
Document the issue
tt j --type blocker "Users can't login - 401 errors"Add context
tt j "Checked: JWT secret is correct, token format is valid"
tt j "Suspecting: Token expiration or timezone issue"Get focused context for AI
tt cf 1 # Just today's context
`📚 All Commands
$3
- tt journal "text" (alias: tt j) - Add entry
- tt journal-show (alias: tt js) - Show entries
- tt journal-search "query" - Search entries
- tt journal-export [format] - Export journal$3
- tt context-quick (alias: tt c) - Quick context
- tt context-full [days] (alias: tt cf) - Full context$3
- tt prd "description" - Set project requirements
- tt prd-show - View current PRD
- tt prd-context - Generate PRD context$3
- tt init - Initialize TaskTracker
- tt stats - Show project statistics
- tt help [command] - Get help🔧 Command Options
$3
`bash
tt j "text" --type [progress|decision|blocker|idea|context]
tt j "text" --tags tag1,tag2,tag3
tt j "text" --files file1.js,file2.py
`$3
`bash
tt journal-show --type decision
tt journal-show --tag architecture
tt journal-show --date 2024-01-15
`$3
`bash
tt cf --output context.md
tt journal-export json --output backup.json
`🎨 What Makes TaskTracker Different
1. Not Another Task Manager - It's a context journal, not a todo list
2. AI-First Design - Built specifically for AI-assisted development
3. Zero Friction - Simple commands that fit your workflow
4. Local & Private - Your data stays in your project
🤝 Integration Guide
See AI Integration Guide for detailed patterns and workflows with:
- Cursor
- ChatGPT / Claude
- GitHub Copilot
- Custom integrations
📈 Best Practices
1. Be Specific: "Fixed null check in auth middleware" > "fixed bug"
2. Document Why: Include reasoning in decisions
3. Tag Consistently: Use tags to group related work
4. Regular Context: Regenerate context at session start
🚧 Current Status
Version 3.0 - Recently refactored from a task manager to a focused developer context journal.
$3
- ✅ All journal functionality (add, show, search, export)
- ✅ PRD parsing and management
- ✅ AI context generation (quick & full)
- ✅ Proper CLI argument parsing
- ✅ Clean, maintainable codebase
- ✅ Comprehensive test coverage$3
- No cloud sync (by design - local only)
- No team features (focused on individual developers)
- Basic search (no fuzzy matching yet)
- Limited to CLI (no GUI planned)🛠️ Development
`bash
Clone and install
git clone https://github.com/tasktracker-cli/tasktracker.git
cd tasktracker
npm installRun tests
npm testLint code
npm run lint:check
npm run lint:fix
``See CONTRIBUTING.md for detailed development guidelines.
We welcome contributions! Please see our Contributing Guide for details.
- Bug Reports: GitHub Issues
- Feature Requests: GitHub Discussions
- Documentation: docs/ directory
MIT License - see LICENSE file for details.
Built by developers, for developers who use AI assistants.
Special thanks to all contributors who help make TaskTracker better.
---
Stop re-explaining your project. Start preserving context.