An AI-powered CLI agent built on Google's Gemini API with a beautiful Textual TUI.
Chat with an AI assistant directly from your terminal — with file operations, command execution, and more.
DANGER: This tool executes shell commands and file operations based are done on local machine. Use with caution and only check the source code.
- Python 3.10+
- A valid
GEMINI_API_KEY— get one free at aistudio.google.com
pip install androincliOr with uv:
uv tool install androincliandro{
"GEMINI_API_KEY": "your_api_key_here"
}If no API key is found, you'll be prompted in the terminal:
⚠️ No Gemini API key found.
Get your key at: https://aistudio.google.com/app/apikey
Enter your GEMINI_API_KEY: ••••••••••••••••
✅ API key saved!
Using API key: AIza****
The key is saved to ~/.cli_agent/config.json for future runs.
Linux / macOS:
export GEMINI_API_KEY="your_api_key_here"Windows (PowerShell):
$env:GEMINI_API_KEY="your_api_key_here"Once launched, you'll see a full-screen chat interface:
┌─ andro-cli ─ AI-powered CLI assistant ──────────────────────────────┐
│ │
│ 🤖 Andro │
│ Welcome! How can I help you today? │
│ │
│ 👤 You │
│ Create a file called hello.txt │
│ │
│ 🤖 Andro │
│ Creating hello.txt... │
│ │
├───────────────────────────────────────────────────────────────────────┤
│ Type a message... (Enter to send, Ctrl+q to quit) [Send ↵] │
└──────────[Ctrl+q] Quit [Ctrl+L] Clear [Esc] Focus Input────────────┘
| Key | Action |
|---|---|
Enter |
Send message |
Ctrl+q |
Quit |
Ctrl+L |
Clear chat |
Escape |
Focus input |
- 🤖 Gemini AI — powered by
gemini-2.0-flash - 🖥️ Textual TUI — beautiful full-screen terminal UI
- 💬 Chat bubbles — distinct user/bot message styling
- 🔧 Tools — file ops, shell commands, network checks
- 🔑 API key management — prompt on first run, saved locally
- 🎨 Rich formatting — styled output with Rich
MIT License. See LICENSE for details.