LLM-powered task management system that sits on top of TickTick to auto-prioritize, schedule, and protect your wellbeing.
Stop losing time to endless meetings and manual planning. Context intelligently manages your tasks across work, your wife's dental clinic, and personal life - all while ensuring you don't burn out.
- Smart Task Intake: Automatically analyzes tasks from TickTick, extracts urgency/importance, assigns to Eisenhower matrix
- Workload Intelligence: Tracks your capacity and warns when you're over-committed
- Rest Reminders: Actually tells you to take breaks based on work intensity
- Email Drafts: Generates context-aware emails for your tasks
- Weekly Planning: AI-powered weekly reviews and priority suggestions
- Voice Capture: Speak your tasks, they're transcribed and intelligently processed
- Azure DevOps Sync: Auto-creates work items from your tasks
- Python 3.11+
- Node.js 18+
- PostgreSQL 15+
- Redis 7+
- TickTick account
- Claude API key (Anthropic)
git clone https://github.com/yourusername/context.git
cd context
# Backend setup
cd backend
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
pip install -r requirements.txt
# Frontend setup
cd ../frontend
npm installCreate .env files in both backend and frontend:
backend/.env:
# Database
DATABASE_URL=postgresql://user:password@localhost:5432/context
REDIS_URL=redis://localhost:6379
# APIs
TICKTICK_CLIENT_ID=your_client_id
TICKTICK_CLIENT_SECRET=your_client_secret
TICKTICK_REDIRECT_URI=http://localhost:8000/auth/callback
ANTHROPIC_API_KEY=your_claude_api_key
GMAIL_CLIENT_ID=your_gmail_client_id
GMAIL_CLIENT_SECRET=your_gmail_client_secret
AZURE_DEVOPS_ORG=your_org
AZURE_DEVOPS_PAT=your_personal_access_token
# App
SECRET_KEY=your_secret_key_min_32_chars
FRONTEND_URL=http://localhost:3000frontend/.env.local:
NEXT_PUBLIC_API_URL=http://localhost:8000cd backend
alembic upgrade headTerminal 1 - Backend:
cd backend
uvicorn app.main:app --reload --port 8000Terminal 2 - Celery Worker:
cd backend
celery -A app.workers.celery_app worker --loglevel=infoTerminal 3 - Frontend:
cd frontend
npm run devTerminal 4 - Redis:
redis-serverNavigate to http://localhost:3000
context/
├── backend/
│ ├── app/
│ │ ├── api/ # API routes
│ │ │ ├── auth.py # OAuth flows
│ │ │ ├── tasks.py # Task CRUD
│ │ │ ├── calendar.py # Calendar operations
│ │ │ ├── analytics.py # Workload intelligence
│ │ │ └── sync.py # Webhook handlers
│ │ ├── services/ # Business logic
│ │ │ ├── ticktick.py # TickTick integration
│ │ │ ├── llm.py # Claude API calls
│ │ │ ├── scheduler.py # Calendar blocking
│ │ │ ├── email.py # Email draft generation
│ │ │ └── azure.py # Azure DevOps integration
│ │ ├── models/ # SQLAlchemy models
│ │ │ ├── user.py
│ │ │ ├── task.py
│ │ │ ├── calendar_event.py
│ │ │ └── sync_log.py
│ │ ├── workers/ # Celery tasks
│ │ │ ├── celery_app.py
│ │ │ ├── sync_tasks.py
│ │ │ └── analysis.py
│ │ ├── core/ # Config & utilities
│ │ │ ├── config.py
│ │ │ ├── database.py
│ │ │ └── security.py
│ │ └── main.py # FastAPI app
│ ├── alembic/ # Database migrations
│ ├── tests/
│ └── requirements.txt
│
├── frontend/
│ ├── src/
│ │ ├── app/ # Next.js 13+ app directory
│ │ │ ├── page.tsx # Dashboard
│ │ │ ├── tasks/
│ │ │ └── settings/
│ │ ├── components/
│ │ │ ├── TaskBoard.tsx # Eisenhower matrix
│ │ │ ├── TaskCard.tsx
│ │ │ ├── WeeklyView.tsx
│ │ │ ├── WorkloadChart.tsx
│ │ │ └── EmailDraftModal.tsx
│ │ ├── lib/
│ │ │ ├── api.ts # Backend API client
│ │ │ ├── hooks.ts # React hooks
│ │ │ └── utils.ts
│ │ └── styles/
│ ├── public/
│ └── package.json
│
└── docs/ # Documentation (you are here)
├── README.md
├── ARCHITECTURE.md
├── FEATURES.md
├── TECH_STACK.md
├── API_INTEGRATION.md
├── MVP_ROADMAP.md
├── DATABASE_SCHEMA.md
├── BACKEND_STRUCTURE.md
├── FRONTEND_STRUCTURE.md
└── DEVELOPMENT_GUIDE.md
Color Scheme: Dark Mode
- Background:
#1f2937(gray-800) - Cards:
#374151(gray-700) - Accents:
#60a5fa(blue-400) - Text:
#f9fafb(gray-50)
Button Style: Minimal - clean, flat buttons with subtle hover states
Layout: Compact - maximize information density, minimal whitespace
Dashboard: Matrix First - Eisenhower matrix is the primary view
- ✅ Smart Task Intake
- ✅ Basic Dashboard
- ✅ Manual Overrides
- ✅ Contextual Email Drafts
- ✅ Workload Intelligence
- ✅ Rest Reminders
- ✅ Auto Azure DevOps Creation
- ✅ Weekly Planning Assistant
- ✅ Voice Note Capture
Estimated Timeline: 10.5 weeks
Average Complexity: Medium
- Feature Branch: Create from
main
git checkout -b feature/task-intake- Develop: Write code + tests
- Test Locally: Run test suite
# Backend
pytest
# Frontend
npm test- Commit: Use conventional commits
git commit -m "feat: implement LLM priority scoring"- PR: Open pull request to
main - Deploy: Merge triggers CI/CD pipeline
# Backend tests
cd backend
pytest -v
# Frontend tests
cd frontend
npm test
# E2E tests
npm run test:e2e- Architecture - System design and data flows
- Features - Detailed feature specifications
- Tech Stack - Technology choices and rationale
- API Integration - External API setup guides
- MVP Roadmap - Week-by-week implementation plan
- Database Schema - Database design
- Backend Structure - Backend code organization
- Frontend Structure - Frontend code organization
- Development Guide - Setup and debugging
This is a personal project, but feedback and suggestions are welcome!
- Fork the repository
- Create a feature branch
- Make your changes
- Submit a pull request
MIT License - feel free to use this for your own productivity system!
- TickTick for the excellent task management API
- Anthropic for Claude API
- Motion and Reclaim.ai for inspiration