aiiware-cli

Aii — AI-Powered Terminal Assistant

Aii (pronounced "eye") is your intelligent command-line companion that brings AI directly into your terminal through natural language.

One CLI. 5 LLM Providers. Zero Config.

Stop context-switching between your terminal and ChatGPT. Get instant AI assistance for git commits, code generation, translation, content writing, shell automation, and analysis—all without leaving your terminal.

What's New in v0.12.0: Pipe support (cat file | aii "summarize"), auto-confirm (--yes), and automatic server management. See CHANGELOG

✨ What Can Aii Do?

# ⚡ Pipe Anything (v0.12.0)
cat README.md | aii "summarize this"
git diff | aii "review these changes"
tail -100 app.log | aii "what errors do you see?"

# 🤖 Auto-Confirm for CI/CD (v0.12.0)
aii "delete all .pyc files" --yes
aii run git commit --yes

# 🔀 Smart Git Workflows
aii run git commit                    # → Analyzes changes, generates conventional commit
aii run git pr                        # → Creates PR with smart description

# 💻 Code Generation
aii create a python function to validate emails
# → Complete function with typing, docstrings, tests

# 🌍 Translation (100+ languages)
aii translate "hello world" to spanish
# → hola mundo

# 📝 Content Writing
aii prompt use tweet-launch "launching Aii CLI"
# → Engaging product launch tweet ready to post

# 🐚 Shell Automation (Safe by Default)
aii find files larger than 100MB
# → Shows command + explanation → Asks confirmation

# 🧠 Analysis & Research
aii explain "how do transformers work"
# → Clear explanation with examples

🚀 Quick Start

Installation

# With uv (recommended)
uv tool install aiiware-cli

# Or with pip
pip install aiiware-cli

# Verify
aii --version

Setup (2 minutes)

# Interactive setup wizard
aii config init

# Choose your LLM provider:
#  1. Anthropic Claude (Sonnet, Opus, Haiku)
#  2. OpenAI GPT (GPT-4o, GPT-4 Turbo, GPT-4o-mini)
#  3. Google Gemini (2.5 Flash, 2.0 Flash, Pro)
#  4. Moonshot AI (Kimi K2, up to 256K context)
#  5. DeepSeek AI (Ultra-low-cost, 10x cheaper than GPT-4)

# Verify
aii doctor

Get API Keys:

• Claude: console.anthropic.com
• OpenAI: platform.openai.com
• Gemini: aistudio.google.com/apikey
• Moonshot: platform.moonshot.ai
• DeepSeek: platform.deepseek.com

First Command

aii translate "hello" to french
# → bonjour

aii run git commit  # (after git add .)
# → Smart commit message generated

aii                 # Interactive mode

📋 Key Features

⚡ v0.12.0 Highlights

• Stdin Pipeline: cat file | aii "summarize" — pipe anything into Aii
• Auto-Confirm: --yes flag for CI/CD automation
• Zero-Config Server: Auto-starts on first command, no manual setup

🎯 Natural Language Interface

• Core AI Functions: Git, code, shell, content, translation, analysis
• MCP Extensibility: GitHub, filesystem, databases via Model Context Protocol
• 25 Ready-to-Use Prompts: Business, social, development, marketing
• 5 LLM Providers: Claude, GPT-4, Gemini, Moonshot, DeepSeek
• Smart Confirmations: Asks only for dangerous operations

📚 Prompt Library (v0.6.1+)

Generate professional content in seconds:

# Discover prompts
aii prompt list                    # Browse all 25 prompts
aii prompt list --category social  # Filter by category
aii prompt show tweet-launch       # View details

# Use prompts
aii prompt use pr-description "add user authentication with JWT"
aii prompt use email-professional "decline meeting, suggest async update"
aii prompt use blog-intro "Getting Started with AI CLI tools"

# Create custom prompts (v0.6.2)
aii prompt create
# → Interactive wizard with beautiful YAML formatting
# → Unlimited custom categories
# → Inline examples at every step

25 Prompts by Category:

• Business (4): Daily standups, incident reports, meeting notes, professional emails
• Content (4): Blog outlines/intros, newsletters, landing pages
• Development (7): PR descriptions, release notes, commits, code reviews, bug reports, API/architecture docs
• Social (5): Tweet launches, LinkedIn posts, Instagram captions, thread builders
• Marketing (2): Product announcements, feature highlights
• Productivity (3): Task lists, brainstorming, definitions

🛠️ Developer Productivity

• Git Integration: Smart commits, PR creation, branch naming
• Code Generation: Language-agnostic with best practices
• Shell Safety: Previews commands before execution (v0.6.2 improved)
• MCP Support: Extend with Model Context Protocol servers (GitHub, filesystem, etc.)

⚙️ Platform Features

• Unified Server: One AI instance shared across terminal windows and VSCode
• Real-Time Streaming: 60-80% faster perceived speed (token-by-token)
• Cost Tracking: Transparent pricing per request (aii stats)
• Smart Output Modes: CLEAN (just answer) / STANDARD (+ metrics) / THINKING (+ reasoning)
• Interactive Mode: Type aii for multi-turn conversations

💰 Pricing

Aii uses your own API keys—pay only for LLM usage. No subscriptions.

Top 5 Cost-Efficient Models (per 10k input + 5k output tokens):

Provider	Model	Cost/10k Tokens	Notes
Google	gemini-2.0-flash-lite-001	$0.0023	Cheapest 🥇
Google	gemini-2.5-flash-lite	$0.0030	Very efficient 🥈
Google	gemini-2.0-flash-001	$0.0030	Fast 🥉
OpenAI	gpt-4o-mini	$0.0045	Recommended for most tasks ⭐
Anthropic	claude-haiku-4-5	$0.0350	Near-frontier quality ⭐

Premium Models:

• Claude Sonnet 4.5 (claude-sonnet-4-5-20250929): $0.1050 per 10k tokens - Best quality ⭐
• GPT-4o (gpt-4o): $0.1250 per 10k tokens
• Claude Opus 4.1 (claude-opus-4-1-20250805): $0.5250 per 10k tokens - Most capable

Track your usage:

aii stats  # View function usage, token counts, and costs

See full pricing table for all 20+ models.

🔌 Using with VSCode

Install the Aii VSCode Extension to use AI in your editor:

• Code Generation (Cmd+Shift+G)
• Smart Git Commits (Cmd+Shift+C)
• Interactive Chat (Cmd+Shift+A)
• Code Explanation & Translation

CLI and VSCode share the same AI server—seamlessly switch between terminal and editor.

Server Management:

aii serve start --daemon  # Start background server (binds to localhost by default)
aii serve status          # Check health
aii serve stop            # Stop server

# Optional: Bind to all interfaces for remote access
aii serve start --host 0.0.0.0

📚 Documentation

• CHANGELOG - Version history and release notes
• GitHub Wiki - Full documentation (coming soon)
• Command Help: aii --help or aii <command> --help

Common Commands:

aii doctor               # Diagnose configuration issues
aii config init          # Re-run setup wizard
aii config provider      # Switch LLM provider
aii mcp catalog          # Browse available MCP servers
aii stats                # View usage analytics

🤝 Support

Need Help?

• 🩺 Run aii doctor to diagnose issues
• 📖 Check CHANGELOG for updates
• 💡 Report bugs or suggest features via GitHub issues

Common Issues:

• "No LLM provider configured" → Run aii config init
• "API key invalid" → Check key at provider console, re-run aii config provider
• "Command not found: aii" → Add ~/.local/bin to PATH (uv tool install location)
• "Server started but not responding" → System HTTP proxy is interfering with localhost connections (fixed in v0.9.4). If using older version, disable proxy: export NO_PROXY="localhost,127.0.0.1"

📄 License

Apache License 2.0 - See LICENSE for details.

🔗 Links

• PyPI: https://pypi.org/project/aiiware-cli/
• VSCode Extension: https://marketplace.visualstudio.com/items?itemName=aiiware.aii
• Twitter: @aii_dev

Made with ❤️ by the AiiWare team

Stay in your terminal. Get AI assistance. Maintain flow state.