dragonked2/alphacode

**A terminal-first AI coding agent that understands your codebase, edits files, runs commands and tests, automates Firefox, controls desktop applications, and verifies its own work.**
**Get started** · Documentation · Releases · Report a bug · Firefox Browser Agent
---
At a glance
| I want to… | Go to |
| --- | --- |
| Try AlphaCode in under two minutes | Quick start |
| See what it can do | Demo · 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 |
| Fix an install or setup problem | Troubleshooting |
| Remove AlphaCode | Uninstall |
| Help improve the project | Contributing |
Demo
Preview AlphaCode in action, from installation to a first task. Click the image to open the original SVG at full size.
The image links to the original SVG. If it does not render in a third-party viewer, open the SVG directly .
Contents
Show or hide the table of contents
- At a glance
- Demo
- What is AlphaCode?
- Quick start
- Features
- Coding and repository work
- Web workflows and quality assurance
- 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
- Documentation and project links
- Security reporting
- Contributing
- Support AlphaCode
---
What is AlphaCode?
AlphaCode is an **open-source AI coding agent built in Rust**. Instead of only suggesting code in a chat, it works directly in your development environment: it can inspect a repository, plan a task, edit files, run commands and tests, use web tools, operate a real Firefox session, interact with desktop applications, and report what it verified.
The workflow follows **understand → plan → execute → observe → verify**, and ends with a report of what changed, what was checked, and what remains.
Example tasks
You can use plain-English instructions or precise technical tasks. Here are three typical requests.
Debug and fix a regression
Test a web application
Investigate a security issue
Advanced workflows can combine multiple agents, reusable skills, and MCP-connected tools.
Back to top
Quick start
Four steps from zero to your first task.
1. Install AlphaCode
**macOS / Linux**
**Windows (PowerShell)**
> [!TIP]
> In security-conscious environments, download and inspect the installer before running it. See Installation options for version pinning, PATH options, and source builds.
> [!IMPORTANT]
> On Windows, run AlphaCode from **Windows Terminal or PowerShell**. Do not double-click alphacode.exe; the temporary console closes as soon as the process exits.
2. Check your setup and launch
alphacode doctor checks your environment and reports common setup issues. The built-in free AI lane lets you start without configuring an API key; connected providers may require their own credentials and may incur charges.
The first launch includes a short onboarding flow for preferences such as telemetry, model defaults, and key bindings. You can skip any step with Esc.
3. Give AlphaCode a task
Type a request such as:
Or ask it to investigate and repair a failing test:
To run a task directly, without opening the interactive terminal UI:
4. Optional: connect Firefox
Install the AlphaCode Browser Agent extension, then run:
The status command reports whether the browser bridge is available and responding.
Back to top
Features
| Capability | What it does |
| --- | --- |
| **AI coding agent** | Understands natural-language tasks, plans multi-step work, edits code, and checks results |
| **Code and file tools** | Reads and writes files, applies targeted edits and patches, and searches code |
| **Terminal execution** | Runs commands, batches operations, and supports background jobs with safety controls |
| **Web tools** | Searches, fetches, and analyzes web content and HTTP flows |
| **Firefox automation** | Works with pages, DOM, forms, tabs, frames, screenshots, downloads, and existing sessions |
| **Desktop automation** | Uses platform accessibility APIs to interact with native applications |
| **Swarm mode** | Coordinates multiple agents on work that can be split into independent tasks |
| **Persistent sessions** | Resumes work across terminal restarts |
| **Project memory** | Supports continuity during longer workflows |