Operating modes¶

Mode	Command	Tools	Saved session
Interactive terminal	`gdc-tui`	Yes	Yes
Headless agent	`gdc print "<task>"`	Yes	Yes
Single reply	`gdc chat "<prompt>"`	No	No
Server	`gdc serve`	Via connected clients	Yes

Interactive terminal¶

gdc-tui

Starts a local server with a per-project database. Use --bind to connect to an existing server. See Terminal.

Headless command line¶

gdc print "summarise the last commit"

Replies stream to stdout; tool activity and reasoning go to stderr. Requests requiring approval are denied unless --auto-approve is set. See Headless CLI.

Single-shot check¶

gdc chat "say hello"

Checks the configured model without executing tools.

Plan mode¶

gdc print --profile plan "plan a health-check endpoint"

The plan profile permits research and writes to .gdc/plans/. Editing project code requires leaving plan mode through an approved transition. See Plan mode.

Server mode¶

gdc serve --bind 127.0.0.1:8088
gdc-tui --bind 127.0.0.1:8088

Provides HTTP endpoints and WebSocket execution for clients. See Running a server.