TLTD - Terminal Todo List

A terminal-based todo application with hierarchical tasks, inspired by Workflowy.

Features

• Multiple Baskets: Organize tasks into Inbox, Monday-Sunday, and Later
• Hierarchical Tasks: Nest tasks infinitely for better organization
• Inline Editing: Create and edit tasks directly in the list without popups
• Collapsible Trees: Collapse/expand task groups
• Task Completion: Complete tasks with 5-second strikethrough grace period
• Undo: Full undo support (up to 50 actions)
• Persistent Storage: Data saved to ~/.tltd/tasks.json

Installation

Using pipx (recommended)

pipx install git+https://github.com/rsedykh/tltd.git

Then run with:

tltd

Development setup

1. Clone and create a virtual environment:

git clone https://github.com/rsedykh/tltd.git
cd tltd
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

2. Install in editable mode:

pip install -e ".[dev]"

3. Run tests:

pytest tests/ -v

Usage

tltd

Quick Add from Command Line

Add tasks directly from your terminal without opening the app:

td "Buy groceries"                    # Add task to Inbox
td "Buy groceries \\ milk, eggs"      # Add task with description

Raycast Integration (macOS)

TLTD includes Raycast script commands for quick access.

Setup

1. Copy scripts to Raycast:

   cp raycast/*.sh ~/.config/raycast/script-commands/

2. Open Raycast Settings (Cmd+,) → Extensions → Script Commands → Add the directory if needed

Commands

• td: Quick-add task to Inbox. Type td then enter task title \\ optional description
• tltd: Opens Terminal and launches the app

Using a Different Terminal

The tltd.sh script uses macOS Terminal by default. To use a different terminal, edit the script:

iTerm2:

osascript -e 'tell application "iTerm"
    create window with default profile command "~/.local/bin/tltd"
    activate
end tell'

Warp:

open -a Warp && sleep 0.5 && osascript -e 'tell application "System Events" to keystroke "~/.local/bin/tltd\n"'

Kitty:

kitty --single-instance ~/.local/bin/tltd

Keyboard Shortcuts

Panel Switching

• ←/→: Switch between baskets and tasks panels

Navigation

• ↑/↓: Navigate in current panel (baskets or tasks)

Task Actions

• c: Create new task below current (inline editor, same nesting level)
• Enter: Edit selected task (inline editor)
• v: Edit task details (Ctrl+S to save, ESC to cancel)
• x: Toggle task completion
• Backspace: Delete task and all children
• r: Move task to different basket
• z: Toggle "show completed tasks"
• Esc: Cancel inline editing

Collapsing

• a: Collapse task (hide children)
• d: Expand task (show children)

Nesting (children move with task)

• e: Nest task under previous sibling
• q: Unnest task one level up

Reordering

• w: Move task up in list
• s: Move task down in list

Undo

• \: Undo last action (up to 50 actions)

Multi-Select

• b: Mark/unmark current task
• Esc: Clear all marks
• When tasks are marked, x/r/Backspace apply to all marked tasks

Quick Basket Jump

• `: Jump to Inbox
• 1-7: Jump to Monday through Sunday
• 0: Jump to Later

Application

• ?: Show help screen
• Ctrl+c: Quit application

License

MIT