Quick Start

Get up and running with AIV in 5 minutes.

Prerequisites

Make sure you have installed AIV and configured your API key.

Your First Conversation

Start AIV in interactive mode:

aiv

You'll see the prompt:

AIV v0.5.0 | anthropic/claude-sonnet-4
>

Try some commands:

> Hello! What can you do?

> Create a simple Python script that prints "Hello, World!"

> Read the file ./README.md and summarize it

One-Shot Mode

Run a single command and exit:

# Ask a question
aiv "What is the capital of Poland?"

# Generate code
aiv "Write a TypeScript function to validate email addresses"

# Process a file
aiv "Summarize this file" < document.txt

Using Agents

AIV comes with specialized agents. Use @ to mention them:

# Use the researcher agent
aiv "@researcher Find recent news about Microsoft Copilot"

# Use a custom agent
aiv "@prawnik Review this contract for risks"

List available agents:

aiv
> /agents

Tool Usage

AIV can execute tools on your behalf:

# Read files
> Read the contents of package.json

# Execute commands
> Run npm test and show me the results

# Search files
> Find all TypeScript files that contain "async function"

Thinking Modes

Switch between different AI models:

# Fast mode (Haiku) - quick responses
> !fast What time is it?

# Expert mode (Opus) - complex problems
> !expert Design a microservices architecture for an e-commerce platform

# Intensive mode - deep analysis
> !intensive Analyze this codebase and suggest improvements

Slash Commands

Useful commands available in the REPL:

Command	Description
/help	Show help
/clear	Clear conversation history
/model	Show/switch provider
/agents	List available agents
/mcp	Manage MCP servers
/usage	Show token usage and costs
/exit	Exit AIV

Example Session

Here's a complete example session:

$ aiv

AIV v0.5.0 | anthropic/claude-sonnet-4
>

> Create a new project structure for a Node.js REST API

🤖 I'll create a project structure for you...

[Creates directories and files]

✅ Created project structure:
- src/
  - index.ts
  - routes/
  - controllers/
  - middleware/
- tests/
- package.json
- tsconfig.json

> Now add a health check endpoint

🤖 Adding health check endpoint...

[Modifies files]

✅ Added GET /health endpoint to src/routes/health.ts

> Run the tests

🤖 Running tests...

⚙️ exec: npm test
✅ All tests passed (5/5)

> /usage

📊 Session Usage:
  Requests: 3
  Input tokens: 1,247
  Output tokens: 892
  Estimated cost: $0.012

> /exit
Goodbye! 👋

Next Steps

• Configuration Guide - Customize AIV
• First Agent Tutorial - Create your own agent
• Module Overview - Explore platform features