Rust Coding Agent

A small coding agent for the terminal, written in Rust. It sends your requests to Anthropic's Claude models and can run shell commands and read, write and edit files in the current directory.

Website: https://ravshansbox.github.io/rust-coding-agent/

Features

• Sign in with a Claude Pro or Max account
• Interactive terminal interface with streamed replies
• Built-in tools: bash, read, write, edit, ast_grep, grep, agent, web_search and web_fetch. ast_grep needs ast-grep and grep needs ripgrep on PATH
• Subagents that run tasks at the same time or one after another, with live tool calls and stats for each task, and a view of what each running agent does
• Start the interface with a prompt (rca fix the failing test) to send it at once
• Print mode (--print or standard input) to run one prompt and print the answer
• Loop mode (/loop or --loop) to run the same prompt again and again, each time in a new session
• Four models and effort levels, with pickers and thinking shown in the conversation
• Saved sessions you can resume, automatic compaction and prompt caching
• !command to run a shell command and share its output with the model, or !!command to keep it private
• Status line with tokens, context use and quota
• Scroll-to-bottom button when you scroll up
• Paste images or let the model read image files, @ file picker and prompt history search
• Drag over the conversation to quote it in your prompt
• AGENTS.md instructions and Agent Skills
• MCP servers over stdio or Streamable HTTP, with OAuth sign-in
• Retries for rate limits, overload and connection errors
• Background updates that restart into the new version when idle

Install

You need Rust, curl and unzip.

curl -fsSL https://raw.githubusercontent.com/ravshansbox/rust-coding-agent/main/install.sh | sh

Run the same command again to upgrade. rust-coding-agent also updates itself in the background. See Install for how install and updates work, and how to uninstall.

Sign in

On first run, rust-coding-agent prints a sign-in link for your Claude Pro or Max account and asks for the code. See Sign in for details.

Usage

Start the interactive interface:

rca

Start the interface and send a prompt at once:

rca fix the failing test

Run one prompt and print the answer:

rca --print "explain src/main.rs"

Show all options with --help.

Documentation

• Install: install, updates and uninstall
• Sign in: sign-in and renewal
• Usage: command line, commands, keys, input, display, sessions and images
• Configuration: settings, instructions, skills and retries
• Tools: built-in tools, ast-grep, grep, web search, web fetch and subagents
• MCP servers: setup and sign-in
• Development: checks, CI, releases and the website
• Architecture decision records

Development

Before each commit, run cargo fmt --check, cargo clippy --all-targets -- -D warnings and cargo test. Write commit messages as conventional commits. See Development for CI, releases and the website.

Licence

MIT. See LICENSE. The syntax highlighting themes use colours from github-nvim-theme, also MIT. See assets/themes/LICENSE-github-nvim-theme.