dft // depth-first-thinking

A terminal-based task manager with depth-first navigation. Break down tasks into subtasks, navigate recursively, and track progress.

Installation

bun add -g depth-first-thinking

Commands

| Command | Aliases | Description | |---------|---------|-------------| | dft new <name> | create, init, add | Create a new project | | dft list | ls, show, projects | List all projects sorted by creation date | | dft open <name> | use, start, run | Launch the interactive TUI session | | dft <name> | - | Shorthand for dft open <name> | | dft tree <name> | view | Print the tree structure to stdout | | dft delete <name> | rm, remove | Delete an existing project | | dft update | upgrade, check-update | Check for updates to dft |

Options

• dft delete <name> -y, --yes - Skip confirmation prompt when deleting
• dft tree <name> --show-status - Show status markers (default: true)
• dft tree <name> --no-status - Hide status markers

Default Behavior

Running dft without any arguments will:

• Reopen the last opened project if it still exists
• Otherwise, open the most frequently opened project if one exists
• Otherwise, list all projects

Navigation

When you open a project, Zen Mode or List Mode is restored from your last session (default is Zen). In Zen Mode, only the currently selected task is displayed, while navigation still works across the full tree:

• ↑ ↓ - Move between sibling tasks at the current level (nodes with more children appear first)
• → Space Enter - Enter task / view its subtasks (move deeper in the hierarchy)
• ← - Go back to parent task (move up in the hierarchy)
• Cmd+C - Copy the selected task title to the clipboard
• / or f - Search tasks by title and jump to a result
• m - Toggle between Zen Mode (single-task view) and List Mode (full list at current level); choice is remembered across projects
• n - New subtask
• e - Edit task title
• v - Move the current task into another task
• x - Delete task (confirmation defaults to Delete)
• d - Toggle complete status
• q - Quit

Task Display

• [N] - Total subtasks (all descendants)
• (done) - Task and all subtasks complete
• (done, partial) - Task done but some subtasks incomplete

Development

git clone https://github.com/alwalxed/dft.git
cd dft
bun install

License

MIT