A simple and modern Terminal User Interface (TUI) todo app with progress bar and tabs. Written in Node.js, no Go required — just
npm.
- ✅ Simple todo management: Toggle tasks done/undone with spacebar.
- 📊 Progress bar: Visual progress indicator showing completion percentage.
- 🗂️ Tab filtering: Switch between All, Active/incomplete, and Completed tasks.
- 🎨 Modern Terminal Aesthetics: Clean UI with color-coded checkboxes and styled borders.
- 📂 JSON persistence: Tasks saved to
~/.todo-master/tasks.json. - 🐧🪟 Cross-Platform: Windows, Linux, macOS. Node.js 18+ required.
| Control | Key | Action |
|---|---|---|
| Navigate Up / Down | ↑ / ↓ |
Move cursor in the task list |
| Toggle Task | Space |
Mark task as done/undone |
| Add Task | a |
Create a new task |
| Edit Task | e or Enter |
Edit the selected task |
| Delete Task | d |
Delete the selected task (asks for confirmation) |
| Switch Tab | 1 / 2 / 3 |
Switch between All / Active / Completed |
| Quit App | q |
Exit application |
npm install # optional — no external dependencies needed
npm startnpm run buildnpm link
todo-tuiTasks are stored in a single JSON file:
- Windows:
C:\Users\<Username>\.todo-master\tasks.json - Linux:
/home/<username>/.todo-master/tasks.json - macOS:
/Users/<username>/.todo-master/tasks.json
Distributed under the MIT License. See LICENSE for more information.
