Installation¶

Binary	Purpose
`gdc`	Headless execution, server and data commands
`gdc-tui`	Interactive terminal

A model backend is required separately. See Model providers.

Get the binaries¶

Download the release archive supplied for your operating system and architecture. Extract gdc and gdc-tui (gdc.exe and gdc-tui.exe on Windows). Installation does not require Rust or the gdc source code.

Put the binaries on your PATH¶

On Linux or macOS, run from the directory containing the extracted binaries:

mkdir -p ~/.local/bin
install -m755 gdc gdc-tui ~/.local/bin/

Ensure ~/.local/bin is on PATH. On Windows, copy the two .exe files to a directory on PATH.

Verify¶

gdc --version
gdc-tui --version
gdc --help
gdc-tui --help

Where gdc keeps its data¶

Path	Contents
`~/.gdc/config.toml`	User configuration
`~/.config/gdc/config.toml`	XDG configuration fallback
`<project>/.gdc/config.toml`	Project configuration
`~/.gdc/sessions.db`	Default CLI/server session database
`~/.gdc/projects/<slug>/sessions.db`	Local TUI session database
`~/.gdc/memory/`	User memory
`~/.gdc/plugins/`	User plugins
`~/.gdc/swarms/<id>/`	Swarm identity, membership and state

Explicit flags and configuration can override locations. Tools operate according to permissions and the selected profile.

Continue with Quickstart.