@aiiware/aii-cli

v0.2.4

Published

24 days ago

AI-powered CLI assistant for terminal productivity

0High
0Medium
0Low

aiidev

ai cli assistant llm claude gpt terminal

@aiiware/aii

AI-powered CLI assistant with autonomous tool execution. An intelligent agent that can read, write, search, and execute commands in your terminal.

Installation

npm install -g @aiiware/aii

Requirements

Node.js 18+
Aii Server running (default: localhost:26169)

Quick Start

# Start interactive agent mode
aii

# Or run a single query
aii "explain what this project does"

# Pipe content for processing
cat error.log | aii "summarize the errors"

# Auto-approve tool execution
aii --auto

Agent Mode (Default)

Aii runs as an intelligent agent that can autonomously execute tools to complete tasks:

aii                    # Start interactive session
aii "your task"        # Run single task and exit

Available Tools

| Tool | Description | |---------------|--------------------------------| | Read | Read file contents | | Write | Create or overwrite files | | Edit | Make targeted edits to files | | Glob | Find files by pattern | | Grep | Search code with regex | | Bash | Execute shell commands | | WebSearch | Search the web |

Interactive Commands

In agent mode, use these commands:

/help              Show available commands
/clear             Clear conversation history
/history           Show conversation history
/stats             Show session statistics (tokens, cost)
/model <model>     Switch LLM model
/provider <name>   Switch LLM provider
/exit              Exit the session

Keyboard Shortcuts

| Key | Action | |------------|----------------------------| | Enter | Submit input | | Esc | Cancel current request | | Ctrl+C | Exit immediately | | Up/Down | Navigate input history | | Tab | Autocomplete commands |

Output Modes

aii "query" --clean        # Just the result
aii "query" --standard     # Result + metrics (default)
aii "query" --thinking     # Full reasoning chain

Prompt Templates

Use pre-built templates for common tasks:

aii prompt list                       # List available prompts
aii prompt show <name>                # Show prompt details
aii prompt use <name> --var value     # Use a prompt template

Configuration

aii config show                # Show current configuration
aii config validate            # Validate configuration
aii config set <key> <value>   # Set a configuration value
aii config model <model>       # Change LLM model
aii config provider <provider> # Change LLM provider

Config Files

Configuration is stored in ~/.aii/:

config.yaml - Main configuration:

llm:
  provider: anthropic
  model: claude-sonnet-4
  temperature: 0.7

api:
  url: http://localhost:26169

secrets.yaml - API keys:

anthropic_api_key: sk-ant-...
openai_api_key: sk-...
deepseek_api_key: sk-...

Or use environment variables: ANTHROPIC_API_KEY, OPENAI_API_KEY, DEEPSEEK_API_KEY

CLI Options

| Option | Description | |----------------------|----------------------------------| | --auto | Auto-approve all tool executions | | --clean | Clean output mode | | --standard | Standard output mode (default) | | --thinking | Show full reasoning | | --model <model> | Override LLM model | | --host <host:port> | API server host | | --no-streaming | Disable streaming output | | --quiet | Minimal output | | --verbose | Show detailed stats |

System Commands

aii doctor         # System health check
aii --help         # Show help
aii --version      # Show version

Features

Autonomous Agent: Executes multi-step tasks with tool use
Real-time Streaming: Token-by-token response display
Interactive Mode: Multi-turn conversations with full context
Tool Execution: Read, write, search, and run commands
Multiple Providers: Claude, GPT, Gemini, DeepSeek
Prompt Templates: Pre-built templates for common tasks
Input History: Navigate previous inputs with arrow keys
Cancellation: Press Esc to cancel any request