█████╗ ██████╗ ███╗ ██╗███████╗███████╗ ██████╗ ██████╗ ██████╗ ███████╗ ██╔══██╗██╔════╝ ████╗ ██║██╔════╝██╔════╝██╔════╝██╔═══██╗██╔══██╗██╔════╝ ███████║██║ ███╗██╔██╗ ██║█████╗ ███████╗██║ ██║ ██║██║ ██║█████╗ ██╔══██║██║ ██║██║╚██╗██║██╔══╝ ╚════██║██║ ██║ ██║██║ ██║██╔══╝ ██║ ██║╚██████╔╝██║ ╚████║███████╗███████║╚██████╗╚██████╔╝██████╔╝███████╗ ╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚═══╝╚══════╝╚══════╝ ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝
AgnesCode — Terminal-native AI coding agent. Built-in Agnes AI, free multimodal API. Powered by OpenCode.
简体中文 | English
AgnesCode is a terminal-native AI coding agent that comes with the Agnes AI provider built-in — free multimodal API (text, image, video), no credit card required. It supports any OpenAI-compatible provider, features a full TUI, LSP, MCP, and plugin system.
# Install via npm (recommended)
npm install -g agnescode
# Run
agnes
# Or install via curl (auto-downloads binary)
curl -fsSL https://raw.githubusercontent.com/ViviQuan/agnescode/main/install | bash
# Or clone and build from source
git clone https://github.com/ViviQuan/agnescode
cd agnescode
bun install
bun run devOn first launch, AgnesCode opens the provider connection dialog where you can enter your Agnes AI API key. Get one for free at https://agnes-ai.com.
AgnesCode ships with the Agnes AI provider configured out of the box.
| Model | Context | Pricing |
|---|---|---|
agnes-2.0-flash |
512K tokens | Free (promotional) |
agnes-1.5-flash |
256K tokens | Free (promotional) |
Both models support image input (via URL), streaming, and multi-turn conversations. agnes-2.0-flash additionally supports tool calling, reasoning mode, and agent workflows — making it the recommended default for coding tasks.
The default theme, "Agnes Purple", uses the Agnes brand colors with a pulsing ring animation on the home screen.
Beyond the built-in Agnes AI, AgnesCode supports any OpenAI-compatible provider. Use /connect to add additional providers.
| Agent | Description |
|---|---|
| build | Default. Full tool permissions for development |
| plan | Read-only analysis mode for code exploration and solution design |
Press Tab to switch between agents.
- Sidebar — session context, modified files, LSP diagnostics, MCP servers, TODO
- Diff viewer — inline code diffs with syntax highlighting
- Command palette —
/for quick commands - Custom themes — 34 built-in themes, switch via
/theme - Keybindings — fully customizable
- MCP — connect to Model Context Protocol servers for tool access
- LSP — language server protocol for code intelligence (diagnostics, hover, go-to-definition)
AgnesCode is configured via .agnescode/agnescode.json in the project directory (or ~/.config/agnescode/agnescode.json globally). Key options include:
- Provider and model selection
- Agent permissions and custom agents
- MCP server connections
- Keybindings and theme
git clone https://github.com/ViviQuan/agnescode
cd agnescode
bun install
bun run dev # Run in development mode
bun turbo typecheck # Type checkAgnesCode is built as a fork of OpenCode. It inherits OpenCode's core architecture (TUI, multi-provider, LSP, MCP, plugins) and replaces the default provider with Agnes AI. If you are building your own fork, add a note to your README to clarify the relationship.