@agi_inc/cli

Terminal-based AI agent for desktop automation. Give it a task in plain English and watch it take control of your computer to get it done.

npx @agi_inc/cli "open calculator and compute 2+2"

Installation

Zero-install (recommended):

npx @agi_inc/cli "your task here"

Global install:

npm install -g @agi_inc/cli
agi "your task here"

Homebrew (macOS/Linux):

brew install agi-inc/tap/agi
agi "your task here"

Configuration

Set your API key before running:

export AGI_API_KEY=your_api_key
# or
export ANTHROPIC_API_KEY=your_api_key

Usage

# Basic usage
agi "Open calculator and compute 2+2"

# Use a specific model
agi "Find flights from SFO to JFK" --model claude-opus

# Verbose output (shows agent thinking)
agi "Install Node.js" --verbose

# Auto-approve confirmations
agi "Delete old files" --no-confirm

Options

| Option | Alias | Description | Default | |--------|-------|-------------|---------| | --model | -m | Model to use (claude-sonnet, claude-opus) | claude-sonnet | | --verbose | -v | Show agent thinking | false | | --no-confirm | | Auto-approve confirmations | false | | --help | -h | Show help | | | --version | -V | Show version | |

Keyboard Shortcuts

While the agent is running:

| Key | Action | |-----|--------| | Space | Pause/Resume | | Q | Stop | | Ctrl+C | Cancel |

How It Works

1. Captures screenshots of your desktop
2. Analyzes them using Claude
3. Decides on and executes actions
4. Repeats until the task is complete

Requirements

• Node.js 20.4.0 or later
• macOS, Linux, or Windows
• AGI API key or Anthropic API key

SDKs

• agi-python — Python SDK
• agi-node — Node.js SDK
• agi-csharp — C# SDK

License

MIT