NCurses Todo Manager

A terminal-based todo manager with an ncurses-like interface built with Node.js and the Blessed library.

Installation

Global Installation (Recommended)

npm install -g ncurses-todo

Then run from anywhere:

nurses-todo

Local Installation

npm install
npm start

Usage

The app will automatically look for todos.json in:

1. Current working directory
2. Parent directories (walking up to root)
3. Global installation directory (fallback)

This allows you to have project-specific todos or a global todo list.

Keybindings

• n - Create a new todo
• Space - Toggle todo completion status
• d / Delete - Delete selected todo
• ↑ / k - Move selection up
• ↓ / j - Move selection down
• ? - Show help dialog
• q / Ctrl+C - Quit application

Features

• ✅ Add new todos
• ✅ Mark todos as complete/incomplete
• ✅ Delete todos
• ✅ Persistent storage (saved to todos.json)
• ✅ Vi-style navigation (j/k keys)
• ✅ Visual feedback with status messages
• ✅ Todo counter showing total, completed, and pending items
• ✅ Local and global todo file support
• ✅ Built-in help dialog
• ✅ Clean interface with helpful footer

Data Storage

Todos are automatically saved to todos.json. The app searches for this file starting from your current directory and walking up through parent directories. If no local todos.json is found, it uses a global one in the installation directory.