# RA.Aid

> RA.Aid is an open-source autonomous coding agent built on LangGraph that researches, plans, and implements multi-step software development tasks via the command line.

RA.Aid (pronounced "raid") is an open-source, standalone coding agent created by AI Christianson and released under the Apache License 2.0. It runs from the command line and handles complex software development tasks by autonomously executing shell commands, editing files, and conducting web research. The project is currently in Beta status and hosted on GitHub, where it has accumulated over 2,200 stars as of mid-2025.

## What It Is

RA.Aid is a CLI-based autonomous software development agent built on top of LangGraph's agent-based task execution framework. Unlike single-shot code generators, it breaks work into three sequential stages — Research, Planning, and Implementation — each powered by dedicated AI agents. The result, as the project describes it, is "near-fully-autonomous software development." It can optionally integrate with `aider` via a `--use-aider` flag to leverage aider's specialized code editing capabilities.

## Three-Stage Architecture

The core workflow that distinguishes RA.Aid from simpler coding assistants is its structured pipeline:

- **Research** 🔍 — Analyzes the codebase, gathers context, and optionally performs web searches via the Tavily API to pull in real-world documentation and best practices.
- **Planning** 📋 — Breaks the task into discrete, actionable steps and identifies potential challenges before any code is written.
- **Implementation** ⚡ — Executes each planned step sequentially, running shell commands, modifying files, and validating changes.

This pipeline allows RA.Aid to handle tasks that span multiple files and require architectural reasoning, not just localized edits.

## Model Support and Configuration

RA.Aid supports multiple LLM providers through environment variables and CLI flags. The default model is Anthropic's Claude 3 Sonnet (`claude-3-7-sonnet-20250219`), which the README notes currently provides the best and most reliable results. Additional supported providers include:

- OpenAI (e.g., GPT-4o)
- OpenRouter (e.g., Mistral Large)
- Google Gemini
- DeepSeek
- Makehub (with a price-performance ratio parameter)
- Any OpenAI-compatible endpoint

A separate `--expert-provider` flag lets users route complex reasoning subtasks — like debugging or architectural planning — to a different, potentially more capable model than the one handling routine steps.

## Setup Path

RA.Aid installs via `pip install ra-aid` on Unix/Linux/Windows, or via Homebrew on macOS (`brew tap ai-christianson/homebrew-ra-aid && brew install ra-aid`). It requires Python 3.8+ and at minimum one LLM provider API key. Web research requires a Tavily API key. The `aider` integration is optional and must be installed separately.

Key CLI flags include:
- `--research-only` to skip implementation and just analyze a codebase
- `--hil` / `--chat` for human-in-the-loop and interactive conversation modes
- `--cowboy-mode` to skip shell command approval prompts (useful in CI/CD)
- `--server` to launch an alpha web interface with a dark-themed chat UI and real-time agent trajectory streaming
- `--auto-test` and `--test-cmd` for automated test execution after code changes
- `--show-cost` / `--max-cost` for cost tracking and budget limits (Claude models only)

## Update: Release v0.30.2

The latest release is **v0.30.2**, published on May 7, 2025. The repository was last pushed to in January 2026, indicating active ongoing development. The project has been under continuous development since its creation in December 2024, with 209 forks and 60 open issues reflecting an active contributor community. The README explicitly welcomes pull requests and maintains a Discord community for support and discussion.

## Features
- Three-stage Research-Planning-Implementation architecture
- Autonomous shell command execution
- Multi-file codebase analysis and refactoring
- Web research via Tavily API integration
- Human-in-the-loop interactive mode
- Chat mode for conversational task guidance
- Optional aider integration for code editing
- Support for multiple LLM providers (Anthropic, OpenAI, OpenRouter, Gemini, DeepSeek, Makehub)
- Separate expert model configuration for complex reasoning tasks
- Cowboy mode for unattended CI/CD execution
- Automated test execution with retry logic
- Cost tracking and budget limits (Claude models)
- Alpha web server interface with real-time streaming
- Git integration and repository management
- Memory management system
- Ctrl-C interrupt with feedback injection

## Integrations
Anthropic Claude, OpenAI GPT, OpenRouter, Google Gemini, DeepSeek, Makehub, Tavily (web research), aider (code editing), LangChain, LangGraph, Git, ripgrep

## Platforms
WINDOWS, MACOS, LINUX, WEB, API, CLI

## Pricing
Open Source

## Version
v0.30.2

## Links
- Website: https://ra-aid.ai/
- Documentation: https://docs.ra-aid.ai
- Repository: https://github.com/ai-christianson/RA.Aid
- EveryDev.ai: https://www.everydev.ai/tools/ra-aid