Getting Started

Install ARC CLI and start reasoning over your codebase in minutes.

Installation

Quick Install (Recommended)

curl -fsSL https://raw.githubusercontent.com/Ashutosh0x/arc-cli/main/install.sh | sh

irm https://raw.githubusercontent.com/Ashutosh0x/arc-cli/main/install.ps1 | iex

From Source

cargo install --git https://github.com/Ashutosh0x/arc-cli

Prerequisites

• Rust 1.89+ — Install via rustup (only for building from source)

Quick Start

1. Initialize — Run the configuration wizard to set API keys and default models:

arc setup

2. Start a session — Launch the interactive REPL:

arc chat                    # start a session
/plan "add OAuth2 login"    # generate a plan, review it
/provider groq              # switch to Groq (Llama 3.3 70B)
/model grok-4-1-fast-non-reasoning  # switch model
/checkpoint                 # snapshot current state
/rewind 3                   # undo to checkpoint 3
/compact                    # compress context window

3. Single-shot autonomous agent:

arc run "Refactor src/logging to use tracing instead of stdout"

4. AI-powered PR review:

arc review                  # PR critique via 6 specialized agents

Features

ARC delivers a comprehensive set of capabilities for AI-powered code reasoning.

Multi-Provider AI Engine

Seamlessly switch between AI providers without changing your workflow. Each provider is a first-class citizen with full streaming support.

• OpenAI — GPT-4o, GPT-4o-mini, o1, o3-mini and all chat models
• Anthropic — Claude Sonnet 4, Claude Haiku and all Claude models
• Google Gemini — Gemini 2.0 Flash, Gemini Pro and all Gemini models
• Groq — Llama, Mixtral, Gemma at blazing inference speeds
• xAI Grok — Grok-2 and Grok-beta models
• Ollama — Run any open-source model locally, fully offline
• DeepSeek — DeepSeek-R1, DeepSeek-V3 reasoning models

Knowledge Graph (RAG)

Built-in codebase understanding via a knowledge graph that maps your project's structure, dependencies, and relationships using petgraph.

• Automatic codebase indexing and graph construction
• Language-agnostic file analysis with Tree-sitter
• Dependency relationship tracking
• Context-aware code retrieval for AI queries

Interactive REPL

A rich terminal UI with full editing, history, and multi-line support powered by rustyline.

• Syntax-highlighted input
• Persistent session history
• Multi-line editing with bracket matching
• Slash commands for navigation and control
• Tab completion for commands and file paths

Security & Privacy

Enterprise-grade security built from the ground up.

• Credential Manager — Secure API key storage with OS keyring integration
• Prompt Guard — Sanitization layer for safe prompt construction
• Config Guard — Protection against configuration tampering
• Gitignore-aware — Respects .gitignore patterns, never processes excluded files

Developer Experience

• Real-time Streaming — Token-by-token responses with formatted markdown
• Rich Markdown Rendering — Beautiful terminal output with syntax highlighting
• Session Persistence — Save and resume conversations across sessions
• File Operations — Read, write, and patch files directly from the REPL
• Git Integration — Generate diffs, commit messages, and changelogs

Commands

Complete reference for all available ARC CLI commands.

CLI Commands

REPL Commands

Providers

ARC supports multiple AI providers out of the box. Configure any combination for your workflow.

Supported Providers

Configuration

Providers can be configured via environment variables or in the config.toml file:

[default]
provider = "anthropic"
model = "claude-sonnet-4-20250514"

[providers.openai]
api_key_env = "OPENAI_API_KEY"
default_model = "gpt-4o"

[providers.anthropic]
api_key_env = "ANTHROPIC_API_KEY"
default_model = "claude-sonnet-4-20250514"

[providers.ollama]
host = "http://localhost:11434"
default_model = "llama3"

Architecture

ARC is built as a modular Rust workspace with seven specialized crates working together.

Crate Structure

Data Flow

┌─────────────┐     ┌───────────────┐     ┌──────────────┐
│   arc-cli   │────▶│   arc-core    │────▶│ arc-provider │
│  (REPL UI)  │     │ (Orchestrator)│     │  (AI APIs)   │
└─────────────┘     └───────┬───────┘     └──────────────┘
                            │
              ┌─────────────┼─────────────┐
              ▼             ▼             ▼
      ┌──────────┐  ┌─────────────┐  ┌──────────┐
      │arc-config│  │arc-analyzer │  │knowledge │
      │ (Config) │  │(Tree-sitter)│  │  -graph  │
      └──────────┘  └─────────────┘  │  (RAG)   │
                                     └──────────┘

Platform Support

Changelog

All notable changes to ARC CLI.