> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gloo.com/llms.txt
> Use this file to discover all available pages before exploring further.
# GlooCode
> An autonomous AI coding agent that runs in your terminal — powered by cost-optimized models through Gloo AI.
GlooCode is a terminal-based AI coding agent. You describe what you want in plain English, and it handles the rest — planning the approach, writing the code, running tests, and committing the result via git.
It ships as a single binary with no runtime dependencies. Built on [OpenCode](https://opencode.ai), an open-source foundation for AI coding agents, GlooCode connects to Gloo AI for cost-optimized model routing and values-aligned AI — the same platform you use for the Completions API and SDKs.
## Why GlooCode?
**It's cheaper.** GlooCode routes requests through Gloo AI's optimized model infrastructure. Based on internal benchmarks of typical agentic coding sessions, customers can see **up to 60–70% lower cost** compared to equivalent direct-provider pricing. Actual savings vary by workload and model selection.
**It works like you do.** GlooCode doesn't just generate code — it reads your project, understands context, makes a plan, writes the implementation, runs your tests, and commits the changes. You review each step before it lands.
**It's extensible.** Four built-in agents cover most workflows out of the box. Need something specialized? Define your own agents with any Gloo AI model, custom prompts, and fine-grained permissions.
## What It Does
| Capability | How it works |
| ----------------------------- | ----------------------------------------------------------------------------------------------- |
| **Autonomous task execution** | Describe a goal and GlooCode handles planning, implementation, testing, and committing |
| **Multi-agent architecture** | Four built-in agents (`plan`, `build`, `explore`, `general`), each optimized for different work |
| **Full codebase awareness** | Reads your project files, understands git state, and maintains context across a session |
| **Built-in tool use** | File operations, shell commands, web search, LSP integration, and MCP plugins |
| **Custom agents** | Define your own agents with any Gloo AI model and tailored prompts |
| **SDK and proxy** | TypeScript SDK and Bun proxy for headless or programmatic use |
## How It Connects to Gloo AI
GlooCode authenticates with the Gloo AI platform using the same API credentials (Client ID and Client Secret) you use for the [Completions API](/api-guides/completions-v2), [SDKs](/api-guides/sdks-and-libraries), and other Gloo AI services. You create these credentials in [Gloo AI Studio](https://studio.ai.gloo.com/api-credentials).
When GlooCode sends a model request, it routes through Gloo AI — which handles provider selection, safety screening, and failover automatically. You don't need to manage API keys for individual model providers.
You need an active Gloo AI account with API credentials to use GlooCode. Without credentials, GlooCode cannot access any models. If you don't have an account yet, [sign up here](https://studio.ai.gloo.com/sign-up).
## Platform Support
GlooCode ships as a self-contained binary for macOS and Linux:
| OS | Architecture | Variant |
| ----- | --------------------- | ------- |
| macOS | ARM64 (Apple Silicon) | — |
| macOS | x64 (Intel) | — |
| Linux | ARM64 | glibc |
| Linux | x64 | glibc |
| Linux | ARM64 | musl |
| Linux | x64 | musl |
No runtime dependencies are required. The installer detects your platform and downloads the correct binary.
**Windows** is not currently supported. Windows users can run GlooCode through WSL (Windows Subsystem for Linux) using the Linux binary.
## Next Steps
Get up and running in under 5 minutes — install, connect credentials, and start coding.
Learn about the four built-in agents and how to create custom ones for your workflow.
Already using Cursor, Windsurf, Copilot, or Aider? Migrate your custom rules and agents.