⚡ Flash Todo

A minimal terminal task manager built to keep me on track when solving complex problems.

Why this exists

I kept losing focus. I'd be deep into a problem, branch off to fix something else, then forget what I was originally doing — or worse, forget the three things I uncovered along the way. Traditional todo apps didn't help because they're built for long-term planning, recurring schedules, and life organization. I didn't need any of that. I needed something I could pull up in a terminal, dump my current mental stack into, and get back to work.

Flash Todo is that. It's a scratchpad with structure, designed for short-term tasks, not weekly planning or habit tracking.

How it works

Tasks are organized as a tree. You start with root tasks, and when a task turns out to be more complex than expected, you branch it into subtasks. You can keep branching as deep as you need. When all branches of a task are done, the parent completes automatically.

Projects

Tasks can be grouped into projects for visual organization. Each project gets a unique color in the UI. You can assign a project with [P], or inline when creating a task using an @ tag:

buy milk @groceries
fix auth bug @backend

Controls

Instalation and Usage

pipx install flash-todo
flash-todo

Tasks are saved to ~/.branch_tasks/tasks.json.