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

| Provider | Key | Free Tier | Default Model | |----------|-----|-----------|---------------| | Groq | GROQ_API_KEY | ✅ Generous | llama-3.3-70b-versatile | | Together AI | TOGETHER_API_KEY | ✅ Free credits | Meta-Llama-3.1-70B-Instruct-Turbo | | Cerebras | CEREBRAS_API_KEY | ✅ Free tier | llama-3.3-70b | | OpenRouter | OPENROUTER_API_KEY | ✅ Free models | llama-3.1-70b-instruct:free | | Google Gemini | GOOGLE_API_KEY | ✅ Free tier | gemini-2.5-flash | | Cohere | COHERE_API_KEY | ✅ Dev free | command-r-plus | | Fireworks AI | FIREWORKS_API_KEY | ✅ Free tier | llama-v3p1-70b-instruct | | OpenAI | OPENAI_API_KEY | 💳 Paid | gpt-4o | | Anthropic | ANTHROPIC_API_KEY | 💳 Paid | claude-sonnet-4 | | xAI | XAI_API_KEY | 💳 Paid | grok-2 | | Mistral | MISTRAL_API_KEY | 💳 Paid | mistral-large-latest | | DeepSeek | DEEPSEEK_API_KEY | 💳 Paid | deepseek-chat | | Perplexity | PERPLEXITY_API_KEY | 💳 Paid | sonar |

💡 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:

| Command | Description | |---------|-------------| | /help | Show all commands | | /mode <name> | Switch reasoning mode (synthesis, research, architect, titan) | | /modes | List all modes with signal bars | | /theme <name> | Switch visual theme (cyberpunk, matrix, synthwave, crimson) | | /themes | List available color themes | | /attach <file> | Attach a file for context (supports Tab autocomplete!) | | /files | List attached files | | /clear | Clear terminal screen | | /providers | Show active providers | | /export | Export chat to Markdown | | /copy | Copy last response to clipboard | | /write <file> | Extract last code block and save to file | | /cmd list | List custom command shortcuts | | /cmd add <name> <template> | Create a custom command shortcut | | /cmd remove <name> | Delete a custom command | | /game | Start the mainframe hacking mini-game | | /history | List, switch, and resume past interactive chat sessions | | /history-clear | Clear saved persistent chat history | | /autopilot <mode\|debug [cmd]> | View/switch autopilot safety level or run autonomous debug loop | | /git | Launch interactive cyberpunk Git TUI and file stager checkbox menu | | /github <status\|issues\|prs> | Git/GitHub orchestration, auto-staging, semantic AI commit generation, and remote sync | | /teamwork-preview | Render real-time multi-agent matrix status dashboard with heartbeats & tasks | | /dashboard | Spawn zero-dependency local web server and launch telemetry dashboard HUD | | /mic | Record audio voice input from microphone and transcribe to text | | /tokens | View detailed session token usage and exchanges telemetry | | /update | Force check for updates and update Aether CLI manually | | /review | Run git diff and stream an AI code review | | /diagnose [cmd] | Run build/tests and AI-debug any errors | | /explain <file> | AI-explain the design and logic of a file | | /refactor <file> | AI-refactor the code of a target file | | /bug <file> | Scan a file to detect logical edge case failures | | /doc <file> | Write documentation, inline comments, or JSDoc | | /translate <file> <lang> | AI-translate file code into another target language | | /exit | End session |

🧠 Reasoning Modes

| Mode | Layer | Style | Signal | |------|-------|-------|--------| | Synthesis | v2.5 | Balanced, clean, direct | ████████░░ 80% | | Research | v104 | Deep analysis, evidence-based | █████████░ 85% | | Architect | v55 | Systems thinking, debugging | █████████░ 90% | | Titan Fusion | v110 | Premium, maximum signal density | █████████░ 95% |

🔐 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. ⚡"