Loosely GTD inspired todo & time tracking app
A monorepo containing a React frontend, MCP server, and Telegram bot with AI agent capabilities. Built with offline-first architecture using PouchDB for data persistence.
The app is inspired by an offline/notebook based approach that has been refined over 10+ years.
| Notebook | Eddo |
|---|---|
- GTD-Style Contexts: Organize todos by context (e.g., work, home) in Kanban-style columns
- Calendar Week Navigation: View and navigate todos by calendar week
- Time Tracking: Start/pause timers for individual todos with daily summaries
- Offline-First: PouchDB provides local storage with real-time sync capabilities
- AI Integration: Telegram bot with Claude AI for natural language todo management
- MCP Server: Programmatic access via Model Context Protocol
- Data Migration: Automatic schema versioning and migration system
A monorepo with four main packages:
- Web Client: React/TypeScript frontend with offline-first PouchDB storage
- MCP Server: Model Context Protocol server for external integrations
- Core: Shared types and utilities across packages
- Telegram Bot: AI-powered bot using Anthropic Claude
Key patterns: database-centric design, offline-first architecture, and automatic data migration.
# Install dependencies
pnpm install
# Start development (client + MCP server)
pnpm dev
# Start telegram bot
pnpm dev:telegram-bot
# Run tests
pnpm test
# Build for production
pnpm buildRequirements: Node.js ≥18.11.0, pnpm ≥7.1.0
React frontend with GTD-style contexts, calendar week navigation, and time tracking. Runs offline-first with PouchDB.
AI-powered bot with agentic loop architecture that understands complex, multi-step instructions. Features:
- Natural language processing: "Add a work todo for tomorrow's meeting and set a reminder"
- Autonomous task execution: Can break down complex requests into multiple actions
- Dynamic tool selection: Chooses appropriate MCP tools based on user intent
Set TELEGRAM_BOT_TOKEN and ANTHROPIC_API_KEY environment variables to get started.
Provides programmatic access to todos via Model Context Protocol. Test with pnpm test:mcp.
See DEVELOPMENT.md for detailed setup, architecture, testing, and contribution guidelines.