Quick Start

Set your provider key and go:

export RA_ANTHROPIC_API_KEY="sk-..."

One-shot — streams to stdout and exits

ra "Summarize the key points of this file" --file report.pdf

Pipe stdin

cat error.log | ra "Explain this error"
git diff | ra --skill code-review "Review these changes"

Interactive REPL

ra

HTTP API server

ra --http

MCP server for Cursor / Claude Desktop

ra --mcp-stdio

More examples

# Code review with a skill and file attachment
ra --skill code-review --file diff.patch "Review this diff"

# Use a different provider
ra --provider openai --model gpt-4.1 "Explain this error"

# Enable extended thinking
ra --thinking high "Design a distributed cache"

# Reference files inline
ra "explain what @src/auth.ts does"

Next steps

• The Agent Loop — understand how ra works
• Context Control — compaction, thinking, pattern resolution
• Configure a provider — set your API key
• Learn the interfaces — CLI, REPL, HTTP, MCP
• Configuration reference — all fields, env vars, CLI flags