-
Notifications
You must be signed in to change notification settings - Fork 0
FAQ
Frequently asked questions about TaskFlow.
TaskFlow is a terminal-based task management application built with Rust. It provides a keyboard-driven interface for managing tasks, projects, and time tracking.
- Fast and responsive
- Works over SSH
- Low resource usage
- Keyboard-centric workflow
- No distractions
- Linux (primary)
- macOS
- Windows (via WSL)
See Installation for full instructions. Quick version:
git clone https://github.com/username/taskflow
cd taskflow
cargo build --releaseYes, to build from source. Install via rustup.
cd taskflow
git pull
cargo build --releaseDefault location:
~/.local/share/taskflow/
Override with --data-dir or config setting.
Copy the data directory:
cp -r ~/.local/share/taskflow/ ~/backup/taskflow/Yes, store data in a synced folder:
[storage]
data_dir = "~/Dropbox/taskflow"Or use Git with the Markdown backend.
| Use Case | Backend |
|---|---|
| Default / Starting out | JSON |
| Manual editing | YAML or Markdown |
| Large task lists (1000+) | SQLite |
| Git version control | Markdown |
See Storage-Backends for details.
- Export to CSV:
Ctrl+e - Change backend in config
- Restart TaskFlow
- Import from CSV:
Ctrl+i
Press n and use Quick-Add-Syntax:
Buy groceries due:tomorrow #personal !high
- When creating:
due:2025-12-25ordue:tomorrow - After creating: Press
Don the task
| Symbol | Priority |
|---|---|
!!! |
Urgent |
!! |
High |
! |
Medium |
. |
Low |
| (blank) | None |
-
Spaceto select tasks -
dto delete selected
Yes! Press u to undo. TaskFlow has full undo/redo.
Press P (capital P) in the sidebar.
Press m on the task and select the project.
Press # and select a tag, or use the tag filter in sidebar.
- Due date: When the task must be completed
- Scheduled date: When you plan to work on it
- Select a task
- Press
tto start - Press
tagain to stop
Yes! The timer continues and picks up where you left off.
Press L (capital L) to open the time log editor.
A productivity technique with 25-minute work sessions and 5-minute breaks. Press F5 to start. See Pomodoro.
| Key | View |
|---|---|
1 |
Today |
2 |
Upcoming |
3 |
All |
4 |
Overdue |
5 |
Calendar |
Press / and type your search term.
Press v to toggle completed task visibility.
Press ? to open the keybindings reference.
Add to ~/.config/taskflow/config.toml:
[keybindings]
quit = "ctrl+q"
new_task = "ctrl+n"See Keybindings for full reference.
They do! But vim-style j/k are also supported and often faster.
~/.config/taskflow/config.toml
Delete the config file:
rm ~/.config/taskflow/config.tomlYes, use --config:
taskflow --config ~/.config/taskflow/work.toml- Check terminal supports colors
- Try
TERM=xterm-256color taskflow - Check for error messages
- Ensure terminal supports 256 colors
- Check theme settings
- Try
export COLORTERM=truecolor
- Check you're using the same data directory
- Check backend setting
- Look in
~/.local/share/taskflow/
- Try SQLite backend for large datasets
- Check for runaway timers
See Troubleshooting for more solutions.
Yes! Press r on a task to set recurrence. See Recurring-Tasks.
Yes! Press a on a task to add a subtask. See Subtasks-and-Dependencies.
Yes! Press b to set "blocked by" dependencies. See Subtasks-and-Dependencies.
Yes! Press Ctrl+e to export to CSV, ICS, or other formats. See Import-Export.
No, TaskFlow is terminal-only. However, you can access it via SSH from mobile terminal apps.
- Troubleshooting - Common issues and fixes
- Quick-Start - Getting started guide
- Keybindings - All keyboard shortcuts