Installation

Get GDT installed and configured in just a few minutes.

Requirements

Dependency	Description
Node.js 18+	nodejs.org
TaskWarrior 3.0+	Task storage backend
Anthropic API Key	GDT uses Claude models

Install TaskWarrior

GDT uses TaskWarrior to store task data. If you don't have it yet:

macOS

brew install task

Ubuntu/Debian

sudo apt install taskwarrior

Arch Linux

sudo pacman -S task

Fedora

sudo dnf install task

Verify successful installation:

task --version
# Should show 3.x.x

Install GDT

npm install -g @getdonetoday/gdt

Using Bun?

If you use Bun as your package manager: bun install -g @getdonetoday/gdt

Configure API Key

GDT needs an Anthropic API Key to call Claude. Get your key at console.anthropic.com, then:

# Add to your shell config (~/.bashrc or ~/.zshrc)
export ANTHROPIC_API_KEY=sk-ant-your-key-here

Or create a .env file in your working directory:

ANTHROPIC_API_KEY=sk-ant-your-key-here

Verify Installation

getdone --version

If it shows a version number, installation succeeded.

Choose Your Interface

GDT offers two ways to interact — pick the one that fits your workflow:

Option 1: Terminal UI

For keyboard lovers and terminal enthusiasts:

getdone

Option 2: Web UI

For visual thinkers who prefer a graphical interface:

getdone serve --open

This starts a local server and opens the Web UI in your browser.

Both interfaces share the same data

Switch between TUI and Web UI anytime. Your tasks and conversation history are available in both.

On first run, GDT will automatically configure TaskWarrior.

Data Locations

Directory	Contents
~/.task/	TaskWarrior task data
~/.gdt/	GDT config and conversation history

Next Steps

• Quick Start — Try core features in 5 minutes
• Configuration — Customize GDT behavior