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 gdt

Using Bun?

If you use Bun as your package manager: bun install -g 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

gdt --version

If it shows a version number, installation succeeded. Now launch GDT:

gdt

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