ariacode

# @ariacode/cli

<p align="center">
  <img src="./media/aria.jpg" alt="Aria Code" />
</p>

[![Node.js >=20](https://img.shields.io/node/v/@ariacode/cli.svg)](https://nodejs.org)
[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
[![npm](https://img.shields.io/npm/v/@ariacode/cli)](https://www.npmjs.com/package/@ariacode/cli)

A predictable, terminal-native coding agent for Next.js, Nest.js, Prisma and Node.js projects.

Aria reads your repository, generates safe diffs with preview, understands your Prisma schema, upgrades dependencies with risk analysis, and tracks every mutation in a local SQLite history — no surprises.

## Requirements

- Node.js 20+
- `git` (for `review` command)
- `ripgrep` (for `search_code` tool — fast code search)

## Installation

```bash
npm install -g @ariacode/cli
```

After installation the `aria` binary is available globally.

## Quick Start

```bash
# Ask a question about your codebase
aria ask "How is authentication handled in this project?"

# Use a different provider for a single command
aria ask "Explain the data model" --provider openrouter --model deepseek/deepseek-chat

# Generate an implementation plan (read-only, no changes)
aria plan "Add rate limiting to the API routes"

# Preview a patch before applying
aria patch "Rename GeoPage to LandingPage" --dry-run

# Apply a patch with confirmation prompt
aria patch "Add error boundary to the root layout"

# Review staged git changes
aria review

# Explore an unfamiliar codebase
aria explore

# Prisma schema inspection (instant, no LLM)
aria db schema

# Ask about your database schema
aria db ask "users with more than 5 orders in the last 30 days"

# Upgrade outdated dependencies
aria upgrade deps

# Upgrade Prisma with migration guidance
aria upgrade prisma

# Check your environment
aria doctor
```

## Commands

### `aria ask <question>`

Ask a read-only question about the repository. The agent uses `read_file`, `list_directory`, and `search_code` to ex