@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"

Authentication

Log in with your AGI account to automatically configure your API key:

agi login

This opens a browser-based device authorization flow. Once approved, your API key is saved to ~/.agi/credentials and used automatically.

agi logout   # remove stored credentials

Alternatively, set your API key via environment variable:

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

When the agent needs approval before a destructive action, it shows a confirmation dialog:

When the agent needs more information, it prompts with a question:

Commands

Command	Description
agi "task"	Run the agent with a task
agi login	Authenticate via browser-based device flow
agi logout	Remove stored credentials
agi update	Check for updates and self-update

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

Updating

agi update

Detects your install method (npm or Homebrew) and runs the appropriate upgrade command.

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