@kszongic/todo-cli

A simple file-based todo list manager for the command line. Zero dependencies.

Todos are stored in .todos.json in the current directory — perfect for per-project task tracking.

Install

npm install -g @kszongic/todo-cli

Usage

todo add "Fix the login bug"
todo add "Write tests"
todo list
#   ○ 1. Fix the login bug
#   ○ 2. Write tests
#   0/2 done

todo done 1
# ✓ Done: Fix the login bug

todo rm 2
# 🗑  Removed: Write tests

todo clear
# 🧹 All todos cleared

Commands

| Command | Description | |---|---| | todo add <text> | Add a new todo | | todo list | List all todos (default) | | todo done <n> | Mark todo #n as done | | todo undone <n> | Reopen todo #n | | todo rm <n> | Remove todo #n | | todo clear | Remove all todos | | todo help | Show help |

Why?

Sometimes you just need a quick checklist without leaving the terminal. No accounts, no sync, no config — just a JSON file in your project.

License

MIT © 2026 kszongic