doodoo

A terminal-based TODO manager that works with org-mode files.

What it does

Adds and manages tasks from the command line. Tasks are stored in org-mode format, so you can edit them in Emacs, Neovim, or any text editor.

Features

• Add tasks with optional deadlines and schedules
• Interactive ncurses calendar for date selection
• List all pending tasks
• Mark tasks as done
• View tasks in a terminal UI

Requirements

• Linux
• ncurses library
• C++17 compiler

Installation

Install ncurses:

Arch:

sudo pacman -S ncurses

Debian/Ubuntu:

sudo apt install libncurses-dev

Build and install:

git clone https://github.com/tafseeriqbal/doodoo.git
cd doodoo
make
sudo make install

Setup

Create an org file and configure doodoo:

mkdir -p ~/org
touch ~/org/tasks.org
doodoo --config ~/org/tasks.org

Config is saved to ~/.config/doodoo/config.

Usage

# Add a task
doodoo "Buy groceries"

# Add with deadline (opens calendar)
doodoo "Submit assignment" --deadline

# Add with schedule (opens calendar)
doodoo "Start project" --schedule

# Add with both schedule and deadline
doodoo "Write report" --both

# List all tasks
doodoo --list

# Mark task 3 as done
doodoo --done 3

# View in terminal UI
doodoo --view

# Show help
doodoo --help

Calendar navigation

• Arrow keys or w/a/s/d to move
• n next month, p previous month
• Enter to select date
• q to cancel

File format

Tasks are written as standard org-mode entries:

* TODO Buy groceries

* TODO Submit assignment
  DEADLINE: <2025-10-15 Wed>

* TODO Start project
  SCHEDULED: <2025-10-12 Mon>

* TODO Write report
  SCHEDULED: <2025-10-10 Mon>
  DEADLINE: <2025-10-15 Wed>

License

MIT

Author

tafseeriqbal