Quick Start

Requirements

Step 1 — Install

Install Uneven Agent globally using our automated network bootstrap.

# Linux / macOS
curl -fsSL https://uneven.dev/install.sh | bash

# Windows (PowerShell)
irm https://uneven.dev/install.ps1 | iex

Step 2 — Start & Interact

No project initialization or complex configuration file is required. Choose the workflow that fits your style best:

Option A — The Conversational Shell

Prefer a friendly interactive environment over typing strict CLI flags? Simply run the base command directly inside any project folder to enter the Conversational Control Room:

uneven

Inside this shell, you can ask direct questions about your codebase, or trigger project tasks using natural language prompts (e.g. "watch my app", "create src/routes/user.ts", or "explain this file").

Option B — Terminal Dev Watcher

Start the automated background dev process watcher directly to catch dev server and compiler errors in real time:

uneven watch

Or specify dev command parameters directly:

uneven watch npm run dev
uneven watch cargo run
uneven watch python app.py

What happens next

Once running, Uneven Agent:

• Indexes workspace files and local directories into the vector database
• Spawns your dev process and reads stdout/stderr in real time via high-performance async runtime
• Detects errors with file, line and column precision across multiple supported languages
• Applies surgical fixes via Retrieval-Augmented Fix (RAF) — workspace database semantic search before pattern matching
• Writes every event to .uneven/log.md with diffs and recommendations

Other useful commands

# scan for malware and compromised deps
uneven scan

# AI data analyst (natural language → SQL)
uneven analyze --db postgresql://localhost/mydb

# headless CI pipeline
uneven ci --github

# query your codebase
uneven ask "how does the auth service work?"