Skip to content

gdc

gdc is a coding agent for your terminal. You give it a task in plain language; it reads your files, edits code, runs commands, and searches your project to get the job done — while you stay in control of every action it takes.

gdc is built around three ideas:

  • Stability first. Every action is gated by permissions that fail closed, and every message and tool run is saved as it happens, so a crash never loses more than the last few words on screen. You can always resume where you left off.
  • Open models first. gdc talks to any OpenAI-compatible endpoint, so you can run it entirely against a local model (Ollama, llama.cpp, vLLM, LM Studio) and keep your code on your own machine — or point it at a hosted provider when you prefer.
  • You approve the actions. Before gdc runs a shell command or writes outside your project, it asks. You decide once, and it can remember your choice for next time.

Two ways to use it

  • Interactive terminal app

    Launch gdc-tui and work in a full-screen chat interface with a live transcript, inline approval prompts, session history, and slash commands. This is the everyday experience.

    → Interactive terminal

  • Headless command line

    Run gdc print "..." to drive the agent from a script or CI job. Output streams to your terminal and every run is recorded for later inspection.

    → Headless CLI

What you can do with it

  • Pair-program interactively: ask questions about a codebase, then have gdc implement the change.
  • Plan before it acts: ask for a plan first, review it, then let gdc carry it out.
  • Automate repetitive edits and run them unattended in CI.
  • Browse a full audit trail of what the agent did in every session.
  • Extend the agent with external tools (MCP servers), plugins, hooks, on-demand skills, and persistent memory.

See Use cases for worked examples.

Get started

  • Install gdc — build the binaries and put them on your PATH.
  • Quickstart — connect a model and run your first task in a few minutes.
  • Concepts — the handful of ideas that make everything else click.

Where to go next

If you want to… Read
Understand how gdc works at a glance Concepts overview
Learn the terminal app Interactive terminal
Configure providers, permissions, and more Configuration
Look up a command or flag CLI reference
Run gdc as a shared server Admin guide