ggcode is not a chat toy wrapped in a shell. It is a durable AI coding CLI for reading code, editing files, running commands, wiring in MCP, switching modes, tracking checkpoints, running harnessed task queues, and keeping long tasks moving inside one fresh, modern, geek-forward interface.
Read files, inspect diffs, watch status, manage sessions, switch providers, choose language, drop into local shell mode, and queue the next task directly in the TUI instead of turning AI-assisted development into a dozen disconnected steps.
Five modes — supervised, plan, auto, bypass, and autopilot — balance caution and speed, while `ask_user` only interrupts when the agent is truly blocked.
Checkpoints, /undo, and dirty-workspace confirmation keep file changes reversible and harness runs grounded in an explicit baseline.
MCP, skills, plugins, and project memory can all plug into the same agent loop.
Background commands, worker-backed harness runs, activity panels, and status signals keep builds, tests, and release batches from blocking the whole session.
Go, npm, pip, native packages, and in-app /update keep installs and upgrades simple across macOS, Windows, and Linux.
Start from project context, memory files, configuration, and git state instead of guessing.
Read files, search code, execute tools, and feed the results back into the model for iterative reasoning.
Language selection, permission modes, local shell mode, harness queues, review-promote-release loops, sidebar state, status, and MCP views all matter when you use the tool every day.
Best for most daily work and safer around sensitive actions.
Good for read-only exploration, architecture review, and higher-risk investigation.
Ideal for frequent small tasks and a smoother default flow.
Fits the moments when you know what you want and want fewer pauses.
Built for continuous progress and high-tempo delivery, with `ask_user` reserved for genuinely blocking gaps.
Start with the path you already trust. Upgrade later without friction, or pull native packages when you need fleet-friendly distribution.
Closest to the native release flow and fetches the right binary for your platform.
go install github.com/topcheer/ggcode/cmd/ggcode-installer@latest
ggcode-installer
Fits teams already in the Node ecosystem and installs the release-backed binary.
npm install -g @ggcode-cli/ggcode
Works well for Python environments or standardized distribution across team machines.
pip install ggcode
Latest native installers and packages are mirrored on the website, including .pkg, .msi, .deb, .rpm, .apk, .ipk, and Arch packages.
Already running ggcode? Use the built-in updater to fetch the latest release without reinstalling from scratch.
ggcode
/update
If you like living in the terminal, care about workflow integrity, and still want delivery speed, ggcode is the AI tool that belongs in your shell.