gdc-tui¶
Connection¶
| Flag | Environment | Default | Effect |
|---|---|---|---|
--bind ADDRESS |
GDC_TUI_BIND |
Unset | Connect to a server; accepts host:port or full URL |
Local server options¶
Apply only when --bind is unset.
| Flag | Environment | Default | Effect |
|---|---|---|---|
--db-path PATH |
GDC_TUI_DB_PATH |
~/.gdc/projects/<slug>/sessions.db |
Local session database |
--config PATH |
GDC_TUI_CONFIG |
Standard file cascade | Explicit TOML configuration |
--profile NAME |
GDC_TUI_PROFILE |
default |
Initial agent profile |
--cwd PATH |
GDC_TUI_CWD |
Current directory | Project directory |
Logging¶
| Flag | Environment | Default | Effect |
|---|---|---|---|
--log-dir PATH |
GDC_TUI_LOG_DIR |
Disabled | Write gdc-tui.log in this directory |
Two ways it runs¶
Without --bind, the app starts a local server with a per-project database.
With --bind, it uses the remote server's settings and database.
Set GDC_DISABLE_MOUSE=1 to disable mouse capture.
See Terminal guide,
keyboard shortcuts and
server setup.