npx aix-agent "analyze this project and find bugs"

That's it. One command. No config files. No setup.

What it does

AIX is an autonomous AI agent that runs locally on your machine. Give it a task in plain English, and it will:

1. Think about what needs to be done
2. Act by reading files, running commands, searching code
3. Observe the results
4. Repeat until the task is done

Quick Start

# Uses whichever API key you have set
export ANTHROPIC_API_KEY=sk-...  # or OPENAI_API_KEY, GEMINI_API_KEY, GROQ_API_KEY

npx aix-agent "what does this project do?"

No API key? It falls back to Ollama (local LLMs).

Why AIX?

| | AIX | AutoGPT | Claude Code | |---|:---:|:---:|:---:| | One command to start | ✅ | ❌ | ❌ | | Any LLM provider | ✅ | OpenAI only | Claude only | | Local LLM support | ✅ (Ollama) | ❌ | ❌ | | Zero config | ✅ | ❌ | ❌ | | Dependencies | 0 | 50+ | N/A | | Works as library | ✅ | ❌ | ❌ |

Supported Providers

| Provider | Env Variable | Default Model | |----------|-------------|---------------| | Claude | ANTHROPIC_API_KEY | claude-sonnet-4-20250514 | | GPT | OPENAI_API_KEY | gpt-4o | | Gemini | GEMINI_API_KEY | gemini-2.0-flash | | Groq | GROQ_API_KEY | llama-3.3-70b-versatile | | Ollama | (none needed) | llama3.1 |

Built-in Tools

The agent comes with 6 built-in tools:

| Tool | What it does | |------|-------------| | read_file | Read any file | | write_file | Create or modify files | | list_dir | Browse directories | | shell | Run shell commands | | search_files | Grep through code | | web_fetch | Fetch URLs |

Usage as Library

import { runAgent } from "aix-agent";

const result = await runAgent("find security vulnerabilities in src/", {
  llm: { provider: "claude", model: "claude-sonnet-4-20250514" },
  verbose: true,
  maxTurns: 20,
});

console.log(result.output);

CLI Options

aix "your task here"              Run a task
aix --provider claude "task"      Force a specific provider
aix --model gpt-4o "task"         Force a specific model
aix --max-turns 50 "task"         Increase max iterations
aix --verbose "task"              Show thinking and tool calls
aix --help                        Show help

Examples

# Analyze a project
aix "what does this codebase do? give me a summary"

# Fix bugs
aix "the tests in src/auth.test.ts are failing. fix them"

# Refactor code
aix "refactor src/api.ts to use async/await instead of callbacks"

# Security audit
aix "find security vulnerabilities in this project"

# Write tests
aix "write unit tests for src/utils.ts"

License

MIT