- CLI binary:
tgenie(interactive TUI planned; CLI scaffolding exists today) - Scripting:
tgenie <command>(e.g.,tgenie add,tgenie list) - Optional: add a shell alias (user preference), e.g.
alias tg=tgenieoralias taskgenie=tgenie
New to the project? Start here:
- Read Developer Quickstart for a 5-minute run-through
- Read Setup Guide for installation and configuration
- Explore Research Phase to understand project vision
- Review Design Phase for technical specifications
- Follow Implementation Plans for development roadmap
Market research, competitor analysis, and gap identification.
- MARKET_RESEARCH.md - Detailed analysis of 40+ open-source competitors
- COMPARISON_SUMMARY.md - Quick reference with market gap analysis
Technical design specifications and architecture decisions.
- DOCS_STRUCTURE.md - Documentation organization guide
- DESIGN_ARCHITECTURE.md - System architecture and service boundaries
- DESIGN_TUI.md - Interactive TUI (Textual) UX and structure
- DESIGN_CLI.md - CLI command design with examples
- DESIGN_DATA.md - Database schemas and data models
- DESIGN_CHAT.md - AI/chat flow and RAG integration
- DESIGN_WEB.md - Web UI pages and components
- DESIGN_NOTIFICATIONS.md - Notification system design
- DESIGN_BACKGROUND_JOBS.md - Scheduler/jobs approach (no queue for MVP)
- DESIGN_SUMMARY.md - Executive summary
- API_REFERENCE.md - REST/WebSocket API specification
- INTEGRATION_GUIDE.md - Integration provider protocol
- DECISIONS.md - Design decisions log
- REQUIREMENTS_AUDIT.md - Requirements and design audit
Implementation plans, pull request tracking, and development roadmap.
- PR-PLANS.md - START HERE - Detailed PR plan with roadmap
- pr-specs/INDEX.md - Specs + test scenarios for each PR
- PR specs include a "Docs Links" section pointing to the living docs (README + core guides)
- PLAN.md - Original project plan (condensed; Q&A archived)
- PLAN_ARCHIVE.md - Archived planning Q&A / early questions
- TESTING_GUIDE.md - Testing policy and examples
- Setup Guide - Installation and configuration
- Developer Quickstart - 5-minute run-through
- User Guide - Daily workflows (end-user)
- Troubleshooting - Common setup/runtime issues
- Agent Guide - AI agents & developers: Code patterns, conventions, and learnings ⭐ NEW
- PR Plans - Implementation roadmap
- Testing Guide - Testing policy and examples
- Project Status: Phase 1 - Infrastructure Setup
- Documentation Status: Spec Complete (Implementation In Progress)
- Last Reviewed: 2025-12-30
- Next Step: Review PR plans and begin implementation
Note: Documentation reflects design specifications. Implementation status tracked in PR-PLANS.md.
- Read PR Plans before starting work
- Pick a PR from the list
- Create feature branch from
main - Implement according to design documents
- Include tests
- Update status in PR-PLANS.md
- Submit PR with clear description
- Total Planned PRs: See PR-PLANS.md for current count
- Estimated Effort: ~130 hours (~16 weeks for one developer)
- Current Status: Planning phase complete, ready to implement