Home

TaskFlow

A fast, keyboard-driven task management application for your terminal.

TaskFlow provides a powerful TUI (Terminal User Interface) for managing tasks, projects, and time tracking—all without leaving your terminal.

---

Key Features

Feature	Description
Task Management	Create, edit, and track tasks with priorities, due dates, and subtasks
Projects	Organize tasks into projects with sidebar navigation
Tags	Flexible tagging with context support (@home, @work) for GTD workflows
Goals & OKRs	Set objectives with measurable key results and quarterly tracking
Habits	Track daily/weekly habits with streaks, check-ins, and analytics
Time Tracking	Built-in timer with start/stop, detailed logging, and work logs
Pomodoro	Focus timer with work/break cycles and automatic phase transitions
Multiple Views	Today, Upcoming, Calendar, Dashboard, Kanban, Timeline, and more
Analytics Views	Heatmap, Forecast, Network graph, and Burndown charts
Dependencies	Block tasks until prerequisites complete
Recurring Tasks	Daily, weekly, monthly, or yearly repetition
Undo/Redo	Full history support for safe experimentation
Multiple Backends	JSON, YAML, SQLite, or Markdown storage
Mouse Support	Click navigation and scroll wheel throughout the app
Customizable	Themes, keybindings, and settings via config files

---

Quick Links

Getting Started

• Installation - Build from source, install completions
• Quick-Start - 5-minute tutorial
• Interface - Learn the UI layout

Core Features

• Task-Management - Creating and managing tasks
• Quick-Add-Syntax - Create tasks with metadata in one line
• Projects - Organizing with projects
• Tags - Flexible tagging with GTD context support
• Goals-and-OKRs - Objectives with measurable key results
• Habits - Daily/weekly habit tracking with streaks
• Time-Tracking - Track time spent on tasks

Reference

• Keybindings - Complete keyboard shortcuts
• Storage-Backends - Choose the right backend
• FAQ - Common questions answered

---

System Requirements

• Operating System: Linux, macOS, or Windows
• Terminal: Any modern terminal with UTF-8 and ANSI color support
• Rust: Version 1.87+ (for building from source)

---

Quick Install

# Clone and build
git clone <repository-url>
cd taskflow
cargo build --release

# Run
./target/release/taskflow

# Or try with demo data
./target/release/taskflow --demo

See Installation for detailed instructions.

---

Interface Preview

┌─────────────────────────────────────────────────────────────┐
│ TaskFlow                                                     │
├──────────────┬──────────────────────────────────────────────┤
│ All Tasks    │ !!!! [ ] Fix critical bug         due:today  │
│ Today        │ !!!  [~] Implement feature        #backend   │
│ Upcoming     │ !!   [ ] Write tests              #testing   │
│ Overdue      │ !    [ ] Update docs                         │
│              │      [x] Initial setup            completed  │
│ ── Projects ─│                                              │
│ Backend      │                                              │
│ Frontend     │                                              │
├──────────────┴──────────────────────────────────────────────┤
│ 5 tasks (1 completed) │ showing all │ Press ? for help      │
└─────────────────────────────────────────────────────────────┘

---

Getting Help

• Press ? in the app to see all keybindings
• Browse this wiki for detailed documentation
• See FAQ and Troubleshooting for common issues