aether-ai-agent-cli

Aether AI CLI

⚡ Universal AI Gateway — 13+ providers, free & paid models, cyberpunk terminal

  ╔═══════════════════════════════════════════════════════════╗
  ║     █████╗ ███████╗████████╗██╗  ██╗███████╗██████╗    ║
  ║    ██╔══██╗██╔════╝╚══██╔══╝██║  ██║██╔════╝██╔══██╗   ║
  ║    ███████║█████╗     ██║   ████████║█████╗  ██████╔╝   ║
  ║    ██╔══██║██╔══╝     ██║   ██╔══██║██╔══╝  ██╔══██╗   ║
  ║    ██║  ██║███████╗   ██║   ██║  ██║███████╗██║  ██║   ║
  ║    ╚═╝  ╚═╝╚══════╝   ╚═╝   ╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝   ║
  ╚═══════════════════════════════════════════════════════════╝

Aether Core AI v110 is a production-ready, globally installable command-line AI assistant that connects to any AI provider in the world — both free and paid. Chat with GPT-4o, Claude, Gemini, Llama, Mixtral, DeepSeek, and 50+ more models, all from one terminal.

---

✨ Features

• 🌐 13+ AI Providers — OpenAI, Anthropic, Google, Groq, Together, Mistral, OpenRouter, DeepSeek, Cerebras, Cohere, Perplexity, Fireworks, xAI
• 🆓 Free Models Included — Groq, Together AI, Cerebras, OpenRouter, and Cohere all offer generous free tiers
• 💬 Interactive Chat — Full terminal chat with slash commands, mode switching, and file attachments
• ⚡ Single-Shot Queries — Quick one-off questions directly from the CLI
• 🧠 4 Reasoning Modes — Synthesis, Research, Architect, Titan Fusion — each with unique system prompts
• 📎 File Context Injection — Attach code files, logs, or documents for context-aware AI responses
• 🤖 Autopilot Debug Loop — Automatically correct build/test failures using AI self-correcting feedback loop
• 🌿 Interactive Git TUI — Beautiful cyberpunk ASCII branch tree commit history & interactive file staging checkbox menu
• 📊 Web HUD Dashboard — Companion local zero-dependency telemetry dashboard displaying real-time latencies & provider status
• 🎤 Voice Microphone Input — Record voice input directly from your terminal and transcribe it to text using Google Gemini or Whisper
• 🔄 Failover Mesh — Automatic failback across all configured providers
• 🔢 Local Math Solver — Evaluates mathematical expressions without an API call
• 🤖 Krylo Companion — Offline cyberpunk companion bot when no API keys are configured
• 🔐 Your Keys, Your Control — API keys stored locally on YOUR machine, never transmitted anywhere
• 📤 Export Conversations — Save full chat history as Markdown files
• 🎨 Cyberpunk UI — Neon colors, ASCII art, signal bars, and mode badges
• 🎭 4 Color Themes — Cyberpunk, Matrix, Synthwave, Crimson — switch with /theme
• ⌨️ Custom Commands — Create reusable prompt shortcuts with /cmd add
• 📝 File Creation — AI can create files on your system with path override prompts
• 📊 Live Telemetry — Real-time response latency & tokens/sec in the status bar
• 🎮 Mini-Game — Built-in mainframe hacking game (/game)
• 📋 Clipboard Copy — Copy last response to clipboard with /copy

---

🚀 Quick Start

Install globally via npm

npm install -g @krishivpb60/aether-ai-cli

Or run directly with npx

npx @krishivpb60/aether-ai-cli chat

Or install via pip (Python wrapper)

pip install aether-ai-agent-cli
# Run via terminal:
aether-pip chat

Setup (Interactive Wizard)

aether setup

The wizard walks you through configuring providers — start with free ones!

Or set keys manually

# Free providers (recommended to start)
aether config set GROQ_API_KEY gsk_your_key_here
aether config set GOOGLE_API_KEY AIza_your_key_here
aether config set OPENROUTER_API_KEY sk-or-your_key_here

# Paid providers
aether config set OPENAI_API_KEY sk-your_key_here
aether config set ANTHROPIC_API_KEY sk-ant-your_key_here

Start chatting

aether chat

Quick one-shot query

aether ask "Explain quantum computing in simple terms"

---

📦 Supported Providers

💡 Tip: Start with Groq (fastest, free) or Google Gemini (most capable free tier). You can configure multiple providers and Aether will automatically failover between them!

---

🎮 Commands

Core Commands

aether chat                    # Interactive chat session
aether ask "your question"     # Single-shot query
aether setup                   # Guided provider setup wizard

Configuration

aether config set <KEY> <value>   # Set a config value
aether config get <KEY>           # Get a config value
aether config list                # List all config (keys masked)
aether config delete <KEY>        # Delete a config key
aether config reset               # Delete all config
aether config path                # Show config file location

Discovery

aether providers               # List all 13+ supported providers
aether providers --free        # Show only free-tier providers
aether models                  # List all available models
aether models groq             # Models for a specific provider
aether modes                   # List reasoning modes
aether status                  # System status & active providers

Flags

aether ask "prompt" --mode research     # Use specific reasoning mode
aether ask "prompt" --file error.log    # Attach file context
aether ask "prompt" --model gpt-4o      # Override model
aether ask "prompt" --raw               # Raw text output (for piping)
aether chat --mode architect            # Start chat in specific mode

---

💬 Chat Commands

Inside interactive chat mode, use these slash commands:

---

🧠 Reasoning Modes

---

🔐 Security

• Your keys stay on YOUR machine — stored at ~/.aether/config.json
• No keys are bundled in the package
• No telemetry — zero data collection
• Keys are masked when displayed (aether config list)
• Environment variables also supported as fallback

---

🔄 Failover Mesh

Aether routes your prompt through all configured providers automatically:

Your Prompt
    ↓
[Provider 1] → Success? → Response ✓
    ↓ (fail)
[Provider 2] → Success? → Response ✓
    ↓ (fail)
[Provider N] → Success? → Response ✓
    ↓ (all fail)
[Krylo Companion] → Local Response ✓

If a provider returns an error (rate limit, quota, etc.), Aether automatically tries the next one. Configure multiple free providers for maximum resilience!

---

📁 File Attachment

Attach code files, logs, configs, or documents for context-aware responses:

# From CLI
aether ask "What's wrong with this code?" --file buggy.js

# In chat mode
/attach error.log
What errors are in this file?

Supported file types: .js, .ts, .py, .html, .css, .json, .md, .txt, .log, .yaml, .xml, .toml, .sql, .go, .rs, .java, .c, .cpp, .rb, .php, .swift, .kt, .dart, .vue, .svelte, .sh, .bat, .ps1, .env, .csv

---

🏗️ Development

# Clone the repo
git clone https://github.com/Krylo-60/aether-ai-cli.git
cd aether-ai-cli

# Install dependencies
npm install

# Link for local development
npm link

# Test
aether --help
aether status
aether ask "hello"

---

📄 License

MIT License — see LICENSE for details.

---

👨‍💻 Author

Krishiv PB (@Krylo-60)

"Stay cyberpunk. ⚡"

---

⚡ Aether Core AI v110 — Fusion Command Station ⚡
Universal AI Gateway for the Terminal