Quick Start

Zero to working agent in 30 seconds

Five steps. No config required for the first run.

1

Install

Installs gdm into an isolated environment — no dependency conflicts.

pipx install gdmcode

Don't have pipx? pip install pipx first.

2

Add an API key

Get a free key at gdmcode.com, or bring your own from xAI, Google, or OpenAI. Credentials are stored in the OS keychain — never written to disk in plain text.

gdm login grok      # xAI Grok — recommended
gdm login gemini    # Google Gemini — free tier
gdm login codex     # OpenAI Codex
3

Run a health check

Confirms DB, API connectivity, and budget state before first use. Fix any fail items before proceeding.

gdm health
4

Navigate to your project

gdm uses the current directory as project root and discovers .gdm/config.toml automatically.

cd my-project
5

Run the agent

Describe the task in plain English. At default autonomy it will ask before writing files or running shell commands.

gdm "fix the login bug"

One-shot (non-interactive):

gdm code --prompt "add input validation to the register form" --yes

Next steps