Commands Reference

GDT works primarily through natural language, but also supports structured commands for common operations.

CLI Options

gdt [options]

Option	Description
(none)	Start interactive mode
-p, --prompt <text>	Run single command and exit
--new	Start fresh session
--version	Show version
--help	Show help

Examples:

# Interactive mode
gdt

# Single command
gdt -p "Add task: finish report"

# View tasks
gdt -p "Show today's tasks"

# Fresh session with command
gdt --new -p "Help me plan today"

Slash Commands

In interactive mode, commands start with /:

Command	Description
/help	Show help
/new	Start new session
/exit	Exit GDT
/privacy	Privacy settings
/privacy status	Detailed privacy status
/privacy enable history	Enable conversation saving
/privacy disable history	Disable conversation saving
/privacy clear history	Delete all history
/privacy clear all	Delete all GDT data

Keyboard Shortcuts

Shortcut	Action
Ctrl+C	Exit GDT
↑ / ↓	Browse input history
Ctrl+A	Move to line start
Ctrl+E	Move to line end
Ctrl+U	Clear current input

Natural Language Patterns

GDT understands many ways to express the same intent. These are common patterns that work well.

Creating Tasks

Add task: finish report
Remind me to buy coffee tomorrow
New task: fix login bug
Create task: organize documents, high priority

Querying Tasks

Show my tasks
What do I have today?
Tasks due this week
High priority tasks
All tasks for Project A
What can I do @office?

Modifying Tasks

Set task 3 to high priority
Change task 5 due date to Friday
Add tag "work" to task 7
Update task 10 description to: update docs

Completing Tasks

Task 3 is done
Mark "buy milk" as completed
Finished today's meeting

Deleting Tasks

Delete task 8
Cancel "weekend party"
Remove task 12

Task Decomposition

Break down: develop new feature
Help me split "write thesis" into steps
How should I break down "prepare presentation"?
Make task 5 breakdown more detailed

GTD Workflow

# Capture
Inbox: check email
Add to inbox: schedule dentist

# Clarify
Process inbox
Handle inbox items

# View
Show inbox
Someday/maybe list
Waiting for tasks

# Reflect
Daily review
Weekly review
Show projects

Time Planning

Help me plan today's work
I have 2 hours, what should I do?
Afternoon task schedule
This week's plan

Command Details

/help

Shows quick reference:

> /help

📖 GDT Help

Basic commands:
  /help      Show this help
  /new       Start new session
  /exit      Exit GDT

Privacy:
  /privacy   View and manage privacy settings

Common operations:
  "Add task: <description>"     Create task
  "Show tasks"                  View tasks
  "Break down: <task>"          Decompose task
  "What should I do today"      Get suggestions

Shortcuts:
  Ctrl+C     Exit
  ↑/↓        Browse history

/new

Starts a fresh session:

> /new

⚠️ Starting new session will clear current context.
Save current session? [Yes/No/Cancel]

> Yes

✅ Session saved
✅ New session started

Welcome! How can I help you?

/privacy

Shows privacy settings and commands:

> /privacy

📋 Privacy Settings

Conversation history: Enabled
Encryption: Enabled
Data location: ~/.gdt/

Storage:
- Sessions: 2.3 MB
- Task context: 156 KB

Commands:
/privacy disable history  Stop saving
/privacy enable history   Resume saving
/privacy clear history    Delete history
/privacy clear all        Delete all data

TaskWarrior Integration

GDT uses TaskWarrior for storage. You can use both tools:

# TaskWarrior commands work directly
task list
task add "New task"
task 1 done

Changes sync automatically between GDT and TaskWarrior.

GDT-specific attributes:

Attribute	Description
gdt.complexity	Complexity score (1-10)
gdt.has_risks	Has identified risks
gdt.decomposed	Has been broken down

View a task's GDT metadata:

task 1 info

Next Steps

• Troubleshooting — Common issues
• Configuration — Customize GDT