Metadata-Version: 2.4
Name: aiiware-cli
Version: 0.6.2
Summary: AI-powered terminal assistant: natural language commands for git commits, code generation, translation, content writing, shell automation, and analysis. Supports multiple LLM providers (Claude, GPT, Gemini, and more). Includes 25 ready-to-use content prompts and professional MCP server management!
Project-URL: Homepage, https://aiiware.com
Project-URL: Twitter, https://x.com/aii_dev
Project-URL: PyPI, https://pypi.org/project/aiiware-cli/
Author-email: Aii Dev <aii-dev@aiiware.com>
Maintainer-email: aii Dev <aii-dev@aiiware.com>
License: Apache-2.0
Keywords: ai,ai-assistant,ai-cli,ai-code-review,ai-commands,ai-git-commit,ai-translation,ai-writing,automation,chatgpt-cli,claude-alternative,cli,code-analysis,code-assistant,code-explainer,code-generation,coding-assistant,command-line,commit-message-generator,content-generation,conversational-ai,copilot-alternative,cross-platform,developer-tools,devtools,git-assistant,git-commit,gpt,llm,llm-cli,mcp,model-context-protocol,natural-language,productivity,pydantic-ai,python,python-cli,shell-automation,terminal,terminal-assistant,translation,translator,workflow-automation,writing-assistant
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: English
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: OS Independent
Classifier: Operating System :: POSIX
Classifier: Operating System :: Unix
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: User Interfaces
Classifier: Topic :: Software Development :: Version Control :: Git
Classifier: Topic :: System :: Shells
Classifier: Topic :: System :: System Shells
Classifier: Topic :: Text Processing
Classifier: Topic :: Text Processing :: Linguistic
Classifier: Topic :: Utilities
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: aiohttp>=3.9.0
Requires-Dist: aiosqlite>=0.19.0
Requires-Dist: click>=8.1.0
Requires-Dist: duckduckgo-search>=7.0.0
Requires-Dist: fastapi>=0.115.0
Requires-Dist: google-genai>=1.0.0
Requires-Dist: google-generativeai>=0.8.5
Requires-Dist: httpx>=0.28.0
Requires-Dist: importlib-metadata>=1.0; python_version < '3.8'
Requires-Dist: keyring>=24.0.0
Requires-Dist: mcp[cli]==1.18.0
Requires-Dist: psutil>=7.1.0
Requires-Dist: pydantic-ai>=1.0.6
Requires-Dist: pydantic>=2.10.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: pyyaml>=6.0.1
Requires-Dist: rich>=13.0.0
Requires-Dist: setproctitle>=1.3.0
Requires-Dist: types-pyyaml>=6.0.12.20250915
Requires-Dist: typing-extensions>=4.0.0; python_version < '3.11'
Requires-Dist: uvicorn>=0.32.0
Provides-Extra: dev
Requires-Dist: black>=25.1.0; extra == 'dev'
Requires-Dist: isort>=5.13.2; extra == 'dev'
Requires-Dist: mypy>=1.10.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.25.0; extra == 'dev'
Requires-Dist: pytest-cov>=5.0.0; extra == 'dev'
Requires-Dist: pytest>=8.4.2; extra == 'dev'
Requires-Dist: ruff>=0.6.0; extra == 'dev'
Requires-Dist: types-psutil>=5.9.5.20240502; extra == 'dev'
Description-Content-Type: text/markdown

# 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. 39 AI Functions + 25 Content Prompts. Multiple LLM Providers.**

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.

[![PyPI version](https://badge.fury.io/py/aiiware-cli.svg)](https://pypi.org/project/aiiware-cli/)
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)

> **What's New in v0.6.2:** Enhanced prompt creation wizard with beautiful YAML formatting, improved shell command previews, and better custom prompt adherence. [See CHANGELOG](CHANGELOG.md)

---

## ✨ What Can Aii Do?

```bash
# 🔀 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 v0.6.2"
# → Engaging product launch tweet ready to post

aii prompt use daily-standup "yesterday: fixed bugs, today: features, blockers: none"
# → Professional standup update formatted

# 🐚 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 web research

aii "summarize the README.md file"
# → Key points extracted from file
```

---

## 🚀 Quick Start

### Installation

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

# Or with pip
pip install aiiware-cli

# Verify
aii --version
```

### Setup (2 minutes)

```bash
# 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)

# Verify
aii doctor
```

**Get API Keys:**
- **Claude**: [console.anthropic.com](https://console.anthropic.com/)
- **OpenAI**: [platform.openai.com](https://platform.openai.com/)
- **Gemini**: [aistudio.google.com/apikey](https://aistudio.google.com/apikey)

### First Command

```bash
aii translate "hello" to french
# → bonjour

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

aii                 # Interactive mode
```

---

## 📋 Key Features

### 🎯 Natural Language Interface
- **39 AI Functions** across 8 categories (git, code, shell, content, translation, analysis)
- **25 Ready-to-Use Prompts** (business, social, development, marketing, productivity)
- **Multiple LLM Providers**: Claude, GPT-4, Gemini (switch anytime)
- **Smart Confirmations**: Asks only when needed (dangerous operations)

### 📚 Prompt Library (v0.6.1+)

Generate professional content in seconds:

```bash
# 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:**
```bash
aii stats  # View function usage, token counts, and costs
```

See [full pricing table](https://github.com/aiiware/aii-cli/wiki/Pricing) for all 20+ models.

---

## 🔌 Using with VSCode

Install the [Aii VSCode Extension](https://marketplace.visualstudio.com/items?itemName=aiiware.aii) 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:**
```bash
aii serve start --daemon  # Start background server
aii serve status          # Check health
aii serve stop            # Stop server
```

---

## 📚 Documentation

- **[CHANGELOG](CHANGELOG.md)** - Version history and release notes
- **[GitHub Wiki](https://github.com/aiiware/aii-cli/wiki)** - Full documentation (coming soon)
- **Command Help**: `aii --help` or `aii <command> --help`

**Common Commands:**
```bash
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](CHANGELOG.md) 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)

---

## 📄 License

Apache License 2.0 - See [LICENSE](LICENSE) for details.

---

## 🔗 Links

- **PyPI**: <https://pypi.org/project/aiiware-cli/>
- **VSCode Extension**: <https://marketplace.visualstudio.com/items?itemName=aiiware.aii>
- **Twitter**: [@aii_dev](https://x.com/aii_dev)

---

**Made with ❤️ by the AiiWare team**

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