ggcode is an AI coding agent designed to streamline terminal-first workflows by understanding repositories, editing files, running commands, and leveraging MCP tools within a full-screen TUI interface.
Key Features:
Seamlessly integrates AI into daily coding tasks with terminal-native interactions.
Supports resumable sessions for uninterrupted work continuity.
Offers first-class integration with LSP, MCP tools, and skills for enhanced productivity.
Provides bilingual UI support and local shell mode for flexible usage.
Audience & Benefit:
Ideal for developers seeking efficient terminal-based workflows that combine AI-driven insights with traditional coding tools. ggcode helps reduce context switching, improve collaboration through structured multi-question flows, and maintain control over the AI's actions, whether supervised or automated.
ggcode can be installed via winget, making it accessible to users looking to integrate AI into their development processes without leaving the terminal environment.
An AI coding agent for the terminal. Understands your codebase, edits files, runs commands, and ships code — with a polished TUI, resumable sessions, and multi-agent support.
> All install scripts default to non-privileged (no sudo / admin required).
Quick Start
# 1. Run ggcode in your project
cd your-project
ggcode
# 2. On first launch, configure your API key (interactive prompt)
# Or set it directly:
# Or set up via the interactive wizard on first launch
# 3. Start coding — just type your request
Codebase-aware — reads, understands, and edits your entire project
Full dev toolkit — file edits, shell commands, Git, LSP, search
Semantic code search — BM25-based code_search finds conceptually related code, not just keyword matches
Code health analysis — cyclomatic complexity, function length, nesting depth metrics via code_health
Tech-debt scanner — scan_todos surfaces TODO/FIXME/HACK markers with severity ranking and git-blame staleness
Browser automation — Go-native CDP for SPA/JS testing without Node.js or Playwright
Screenshot capture — full screen, window, or region screenshots for visual debugging
Clipboard integration — read from and write to the system clipboard
Editor launcher — open_editor opens files in the user's IDE (VS Code, Cursor, JetBrains, Vim, etc.) at a specific line/column, auto-detected from env vars
Agent-accessible undo — undo_edit lets the LLM revert its own file edits via checkpoints, avoiding error-prone fix-forward when a previous change was wrong
Schema-constrained tool validation — pre-execution pipeline that validates enum values, numeric bounds (min/max), string length constraints, and strips hallucinated parameters — saving wasted iterations on weak models
Adaptive tool timeout — per-tool category-based timeout that adapts to observed latency, replacing a flat 5-minute default with sensible bounds (30–180s per category) so hung tools fail fast instead of wasting minutes
PTC (Programmatic Tool Calling) — the agent writes JavaScript in a sandboxed VM to batch-call read-only tools (read_file, grep, git_log, web_search, etc.) in a single round-trip, dramatically reducing context window consumption for multi-step analysis
MCP integration — connect external tools and data sources, with dynamic tool refresh, server logging, full capability detection, and MCP sampling (servers can request LLM completions)
gRPC plugins — extend ggcode with custom tools in Go, Python, Node.js, or any language
Multi-agent — spawn parallel workers, delegate to teammates, A2A protocol
Multi-provider — OpenAI, Anthropic, Gemini, DeepSeek, Kimi, Copilot, and more; configurable reasoning effort and tool choice across all protocols
Adaptive sampling — per-turn temperature adjustment based on task phase: low temperature for precise code edits and error recovery, higher for exploration and creative writing
LAN Chat — zero-config P2P real-time messaging between instances on your LAN
Editor integration — JetBrains, Zed, and ACP-compatible editors via ACP
WebUI — built-in web interface accessible from any browser
IM integration — control from QQ, Telegram, Discord, Slack, Feishu, DingTalk
Harness workflow — isolated task execution with review and promotion
Scheduled tasks — cron jobs, reminders, and background automation
Resumable sessions — pause and resume any conversation
Cross-session search — /search finds messages by content across all saved sessions, with snippet preview and quick-resume
Desktop + Mobile — native apps for macOS, Windows, Linux, iOS, Android
