How mohith535/taskflow works
TaskFlow is an offline, CLI-first task execution system, with a web dashboard and a Textual terminal UI. The principal workflow is capture or manage tasks, persist them, then choose a prioritized action for today and optionally enter a timed focus session with distraction blocking. Task records also support enrichment, deadlines, recovery and progress history. The README documents reminder, momentum, overdue-candidate and recovery capabilities; these are represented at the command layer because their finer implementation paths were not sampled. Edges reflect shown imports/calls or README descriptions; uncertain unsampled subsystem links are omitted.
Main entry points: commands.py Task workflows · system_detector.py Platform selection · storage.py Local task storage · server.py HTTP API
Components 20
User interfaces
- CLI commands
taskflow/cli.py - Terminal UI
taskflow/ui/cascade.py - Momentum palette
taskflow/ui/palette.py
Task execution
- Task workflows
task_manager/commands.py - Task sync
task_manager/sync.py - Recovery and overdue
task_manager/commands.py
Task state
- Task model
task_manager/models.py - Local task storage
task_manager/storage.py
Focus defense
- Platform selection
task_manager/system_detector.py - Blocker framework
task_manager/blockers/base.py - Gentle reminders
task_manager/blockers/gentle.py - Windows blocking
task_manager/blockers/windows.py - Local filter proxy
task_manager/blockers/proxy_filter.py - Distraction lists
task_manager/blockers/blocklist.py - macOS blocker
task_manager/blockers/macos.py - Linux blocker
task_manager/blockers/linux.py
Web dashboard
- HTTP API
task_manager/server.py - Web dashboard
task_manager/static/dashboard.js - Dashboard template
task_manager/web_ui.py
Other components
- User
Connections 28
- User → CLI commands: issues commands
README.md - CLI commands → Task workflows: dispatches
taskflow/cli.py - CLI commands → Local task storage: loads config
taskflow/cli.py - CLI commands → Platform selection: checks platform
taskflow/cli.py - User → Terminal UI: opens UI
README.md - Terminal UI → Local task storage: loads tasks
taskflow/ui/cascade.py - Terminal UI → Momentum palette: styles tasks
taskflow/ui/cascade.py - User → HTTP API: uses dashboard
README.md - HTTP API → Dashboard template: serves template
task_manager/server.py - Web dashboard → HTTP API: sends requests
- HTTP API → Task workflows: dispatches actions
task_manager/server.py - HTTP API → Local task storage: reads tasks
task_manager/server.py - Task workflows → Local task storage: persists tasks
task_manager/commands.py - Local task storage → Task model: deserializes
task_manager/storage.py - Task workflows → Task model: uses task records
task_manager/commands.py - Task workflows → Task sync: offers sync
task_manager/commands.py - Task workflows → Platform selection: selects blocker
task_manager/commands.py - Platform selection → Gentle reminders: selects fallback
task_manager/system_detector.py - Platform selection → Windows blocking: selects platform blocker
task_manager/system_detector.py - Platform selection → macOS blocker: selects platform blocker
task_manager/system_detector.py - Platform selection → Linux blocker: selects platform blocker
task_manager/system_detector.py - Gentle reminders → Blocker framework: extends
task_manager/blockers/gentle.py - Windows blocking → Blocker framework: extends
task_manager/blockers/windows.py - Windows blocking → Local filter proxy: starts proxy
task_manager/blockers/windows.py - Local filter proxy → Local task storage: uses data directory
task_manager/blockers/proxy_filter.py - Task workflows → Distraction lists: loads blocklist
task_manager/commands.py - Task workflows → Recovery and overdue: handles recovery
README.md - Task workflows → Recovery and overdue: surfaces candidates
README.md