Commands Reference

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

CLI Options

bash

getdone [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:

bash

# Interactive mode
getdone

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

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

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

Server Command (Web UI)

bash

getdone serve [options]

Option	Description
`--port <n>`	Port number (default: 3000)
`--host`	Allow LAN access (default: localhost only)
`--open`	Open browser automatically

Examples:

bash

# Start Web UI on default port
getdone serve

# Start and open browser
getdone serve --open

# Use custom port
getdone serve --port 8080

# Allow access from other devices on LAN
getdone serve --host

# Combine options
getdone serve --port 8080 --host --open

Web UI Features:

Visual task management with filters, sorting, and project grouping
Real-time AI chat with streaming responses and tool call visualization
Calendar view for scheduling tasks
Dark/Light/System theme modes
Project progress overview

Slash Commands

In interactive mode, commands start with /:

Basic Commands

Command	Aliases	Description
`/help`	`/h`, `/?`	Show help
`/new`	`/n`	Start new session
`/exit`	`/quit`, `/q`	Exit GDT
`/clear`		Clear conversation (preserves long-term memory)

Task Commands

Command	Aliases	Description
`/tasks`	`/t`	Show pending tasks (top 10)
`/context`		Show current context info
`/status`		Show GDT status (TaskWarrior availability, etc.)
`/refresh`		Refresh task cache

Calendar Commands

Command	Aliases	Description
`/calendar`	`/cal`	Show smart calendar view (month + today's tasks)
`/calendar month`	`/cal m`	Show month calendar only
`/calendar today`	`/cal t`	Show today's schedule
`/calendar week`	`/cal w`	Show weekly schedule
`/calendar next [n]`	`/cal n`	Show upcoming n days (default 7)
`/today`		Shortcut for `/calendar today`
`/week`	`/w`	Shortcut for `/calendar week`

Memory Commands

Command	Description
`/history [today\|week\|month]`	Show conversation history summary
`/forget [today\|week\|all]`	Clear specified memory range
`/memory`	Show memory status (debug)

Privacy Commands

Command	Description
`/privacy`	View 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

Analytics Commands

Command	Description
`/analytics`	View analytics status
`/analytics status`	Show detailed analytics status
`/analytics enable`	Enable anonymous usage statistics
`/analytics disable`	Disable usage statistics
`/analytics show`	View pending data to be sent
`/analytics clear`	Delete all analytics data
`/analytics help`	Show analytics help

Data Management Commands

Command	Description
`/backup`	Create a full backup of tasks, sessions, and preferences
`/backup list`	Show available backups
`/backup restore [file]`	Restore from a backup file
`/import`	Start interactive import wizard
`/import [source]`	Import from specific source (todoist, apple, ticktick, google, microsoft, omnifocus, notion, csv, json)

Document Generation Commands

Command	Description
`/prd [feature description]`	Generate Product Requirements Document
`/product-marketing [product name]`	Generate product marketing document (positioning, messaging)
`/tech-review`	Technical design review

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, /h, /?     - 显示此帮助信息
  /new              - 开始新会话
  /exit, /quit, /q  - 退出 GDT
  /status           - 显示当前状态
  /tasks [filter]   - 显示任务列表
  /refresh          - 刷新任务缓存
  /privacy [cmd]    - 隐私设置

使用方式:
  直接输入问题或任务描述，GDT 会帮助您规划和管理时间。

示例:
  "今天有什么安排？"
  "帮我把这个项目拆解成可执行的任务"
  "这周应该优先完成什么？"

/tasks

Shows pending tasks from TaskWarrior:

> /tasks

Pending tasks:
- Review PR feedback
- Update documentation
- Fix login bug
- ...

/context

Shows current context information:

> /context

Context:
  Messages: 12
  Active Task: Yes
  Topics: 3 tracked

/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?

/calendar

Shows calendar views with task integration:

> /calendar

📅 2026年1月
┌────┬────┬────┬────┬────┬────┬────┐
│ 日 │ 一 │ 二 │ 三 │ 四 │ 五 │ 六 │
├────┼────┼────┼────┼────┼────┼────┤
│    │    │    │  1 │  2 │  3 │  4 │
│  5 │  6 │  7 │  8 │  9 │ 10 │ 11 │
│ 12 │ 13 │ 14 │ 15 │ 16 │ 17 │ 18 │
│[19]│ 20 │ 21 │ 22 │ 23 │ 24 │ 25 │
│ 26 │ 27 │ 28 │ 29 │ 30 │ 31 │    │
└────┴────┴────┴────┴────┴────┴────┘

📋 今日任务
● Review PR feedback          due: today   #a1b2c3d4
● Update documentation        due: today   #e5f6g7h8

Sub-commands:

Command	Description
`/cal`	Smart view (month + today's tasks)
`/cal month` or `/cal m`	Month calendar only
`/cal today` or `/cal t`	Today's schedule
`/cal week` or `/cal w`	Weekly schedule with horizontal grid
`/cal next [n]`	Upcoming n days (default 7)
`/cal help`	Show calendar help

Color indicators:

Highlighted background = Today
Green dates = Days with tasks
Gray dates = Weekends
Red/Yellow/Green dots = High/Medium/Low priority
Purple #ID = Task reference

/history

Shows conversation history summary:

> /history today

📝 Today's Conversation Summary

You discussed 3 tasks:
- Reviewed PR #53 feedback
- Fixed migration issues
- Updated documentation

Key decisions:
- Added file size validation
- Implemented debouncing for resize events

/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

/analytics

Manages anonymous usage statistics (opt-in):

> /analytics

📊 Analytics Status

Status: Enabled
Device ID: a1b2c3d4-...
Last reported: 2026-01-21

Today's stats:
• Launches: 3
• Messages: 15
• Tasks: created=5, completed=2

Sub-commands:

Command	Description
`/analytics status`	Show detailed status
`/analytics enable`	Enable analytics
`/analytics disable`	Disable analytics
`/analytics show`	View pending data
`/analytics clear`	Delete all analytics data
`/analytics help`	Show help

What gets collected:

Daily launch and message counts
Task operation counts (created/completed/deleted)
Command usage frequency (command names only)
Anonymous device ID, version, OS type

What's never collected:

Task content or descriptions
Conversation messages
Personal information

TaskWarrior Integration

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

bash

# 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:

bash

task 1 info

Next Steps

Troubleshooting — Common issues
Configuration — Customize GDT

Commands Reference ​

CLI Options ​

Server Command (Web UI) ​

Slash Commands ​

Basic Commands ​

Task Commands ​

Calendar Commands ​

Memory Commands ​

Privacy Commands ​

Analytics Commands ​

Data Management Commands ​

Document Generation Commands ​

Keyboard Shortcuts ​

Natural Language Patterns ​

Creating Tasks ​

Querying Tasks ​

Modifying Tasks ​

Completing Tasks ​

Deleting Tasks ​

Task Decomposition ​

GTD Workflow ​

Time Planning ​

Command Details ​

/help ​

/tasks ​

/context ​

/new ​

/calendar ​

/history ​

/privacy ​

/analytics ​

TaskWarrior Integration ​

Next Steps ​

Commands Reference

CLI Options

Server Command (Web UI)

Slash Commands

Basic Commands

Task Commands

Calendar Commands

Memory Commands

Privacy Commands

Analytics Commands

Data Management Commands

Document Generation Commands

Keyboard Shortcuts

Natural Language Patterns

Creating Tasks

Querying Tasks

Modifying Tasks

Completing Tasks

Deleting Tasks

Task Decomposition

GTD Workflow

Time Planning

Command Details

/help

/tasks

/context

/new

/calendar

/history

/privacy

/analytics

TaskWarrior Integration

Next Steps