A.R.I.A - Agentic Reasoning and Implementation Assistant

Aria is a lightweight agentic codegen assistant that runs in your terminal (for now).

Demo

aria-cli-demo.mp4

Features

• CLI-based interface with both interactive and command execution modes
• Built with Rust for performance and reliability
• Integrated tool functions for file operations and command execution:
  • Reading and writing files
  • Listing files and directory structures
  • Executing shell commands

Supported Providers

Currently supported:

• Anthropic (Claude)

Coming soon (maybe):

• OpenAI
• Ollama
• OpenRouter

Installation

Note

This is a "toy" project, not intended for distribution, if you wish to use it locally, you will need to install it from source.

Install from the project root directory:

cargo install --path cli

Configuration

Aria is configured via an aria.yml file, which can be placed in:

• The current project directory
• ~/.config/aria/ directory

Reference Configuration

provider: Anthropic
api_key: "your_api_key_here"  # Optional (default: None) — some providers may require it
model: "claude-3-7-sonnet-20250219"
max_tokens: 8192  # Optional (default: 4096)
temperature: 0.7  # Optional (default: 0.7)
provider_base_url: "https://api.anthropic.com"  # Optional — a default is provided for each provider

Usage

# Start an interactive session
# You will enter a "chat" like experience
aria

# Non-interactive mode
# Aria will run in a "one-shot" mode, and exit after actioning your request
aria "refactor this function to be more efficient"

# Work in a specific directory
aria interactive --dir /path/to/your/project

Status

This project is still under active development. The current focus is on improving the core functionality and adding more provider support.

Roadmap

• API for integration with other tools
• UI interface for easier interaction
• Additional provider support

License

MIT