dragonked2 / alphacode

# AlphaCode: Open-Source AI Coding Agent for Your Terminal
**Built in Rust. Understands your codebase, edits files, runs commands and tests, drives Firefox, controls desktop apps, and verifies its own work.**
Works with **Claude, GPT, Gemini, GitHub Copilot, OpenRouter, and local models** (Ollama, LM Studio). Start free, no API key required.
**Quick start** · Demo · Features · Docs · Website · Releases · Firefox Agent · Report a bug
---
## Install in 30 seconds
**macOS / Linux**
 [code] 
**Windows (PowerShell)**
 [code] 
Then run `alphacode doctor` and `alphacode`. Full walkthrough in the Quick start.
## Find what you need
| I want to… | Go to |
| --- | --- |
| Try AlphaCode in under two minutes | Quick start |
| See it in action | Demo |
| Understand what it can do | Features |
| Use Claude, GPT, Gemini, or a local model | Models and providers |
| Automate a website in Firefox | Firefox browser automation |
| Control a desktop application | Desktop automation |
| Run several agents in parallel | Swarm mode |
| Fix an install or setup problem | Troubleshooting |
| Remove AlphaCode cleanly | Uninstall |
| Help improve the project | Contributing |
 Full table of contents 
- What is AlphaCode?
- Demo
- Quick start
- Features
- Firefox browser automation
- Desktop automation
- Swarm mode
- Sessions and memory
- Models and providers
- Built-in tools, skills, and MCP
- Security testing and bug bounty workflows
- Safety and reliability
- Benchmarks
- Installation options
- Configuration
- Commands and shortcuts
- Troubleshooting
- Uninstall
- FAQ
- Use cases
- Project links
- Security reporting
- Contributing
---
## What is AlphaCode?
**AlphaCode is an open-source AI coding agent written in Rust that runs in your terminal.** Instead of only suggesting code in a chat window, it works directly in your development environment. It can inspect a repository, plan a task, edit files, run commands and tests, search the web, operate a real Firefox session, interact with native desktop applications, and report what it verified.
It belongs to the same category as terminal coding agents such as Claude Code, Codex CLI, Aider, and OpenCode, with a focus on a small memory footprint, real-browser and desktop automation, and model freedom.
 [code] 
The workflow is **understand, plan, execute, observe, verify**, and it ends with a report of what changed, what was checked, and what remains.
### Why developers choose AlphaCode
| | |
| --- | --- |
| **Lightweight** | A native Rust binary with a small memory footprint (see Benchmarks) |
| **Model-agnostic** | Claude, GPT, Gemini, Copilot, Cursor, Bedrock, Azure, OpenRouter, or any OpenAI-compatible endpoint |
| **Beyond the editor** | Drives a real Firefox session and native desktop apps, not only files and shells |
| **Verifies its work** | Runs tests, reviews its own diff, and reports evidence |
| **Resumable** | Sessions survive terminal restarts, crashes, and dropped SSH connections |
| **Extensible** | Skills, MCP serve