@krishivpb60/aether-ai-cli 1.0.0

package/.github/workflows/ci.yml

@@ -0,0 +1,30 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [18.x, 20.x, 22.x]
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Use Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v4
+      with:
+        node-version: ${{ matrix.node-version }}
+        cache: 'npm'
+
+    - name: Install dependencies
+      run: npm ci
+
+    - name: Run tests
+      run: npm test

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Krishiv PB (@Krylo-60)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/ORIGINAL_REQUEST.md

@@ -0,0 +1,74 @@
+# Original User Request
+
+## Initial Request — 2026-06-25T09:32:46-04:00
+
+An all-in-one CLI command-line assistant called Aether AI CLI (`aether`). It features high-fidelity interactive terminal chat (using custom spinner, cyberpunk theme), multi-mode reasoning selection, file attachment parsing, secure API key configuration, and robust local offline JS mathematical fallbacks.
+
+Working directory: C:\Users\naina\.gemini\antigravity\scratch\aether-ai-cli
+Integrity mode: benchmark
+
+## Requirements
+
+### R1. High-Fidelity Cyberpunk Interactive Terminal Chat
+- Provide a CLI tool (`aether`) that starts a continuous, interactive terminal chat.
+- Display a stylized cyberpunk banner and colors, spinner indicators during API requests, and render assistant responses in formatted markdown.
+- Support key CLI flags and commands (such as `--help`, `/quit`, `/exit`, `/clear`, `/modes`, `/providers`, etc.).
+
+### R2. Dual Secure Configuration Management
+- Allow users to store API keys and models locally in `~/.aether/config.json` via a CLI setup/config command.
+- Support reading from environment variables (e.g., from `.env` or system variables) as a fallback/alternative so no API key errors occur.
+- Mask all sensitive configuration values (like API keys) when listed/viewed.
+
+### R3. File Attachment & Context Parsing
+- Support passing files to the CLI or during chat (e.g. via syntax like `/attach <path>` or a CLI parameter).
+- Parse the content of common file types (text, code, json, csv) and inject it into the prompt context.
+
+### R4. Multi-Mode Reasoning & Routing
+- Route user queries dynamically based on model availability and reasoning modes (e.g., Fast, Standard, Deep/Thinking reasoning).
+- Support standard free and paid AI provider models (Gemini, Grok, etc.).
+
+### R5. Offline Mathematical Fallback
+- When no internet connection is available or API calls fail, fallback to a local JavaScript-based math/logic evaluation engine to solve equations or execute simple logic locally.
+
+### R6. Git Initialization & GitHub Actions CI
+- Initialize a local git repository in the workspace folder.
+- Add all code files and create an initial commit.
+- Define a GitHub Actions workflow `.github/workflows/ci.yml` to automatically run tests/linting.
+
+### R7. Programmatic Test Suite
+- Create automated unit tests (using Node's test runner) under the `test/` directory to verify:
+  - Configuration loading (priority order: file vs. environment variables).
+  - Context parsing of files.
+  - Multi-mode routing.
+  - Offline math fallback logic.
+
+## Acceptance Criteria
+
+### Installation & Help
+- [ ] Running `npm link` or global install allows starting the CLI using `aether`.
+- [ ] Running `aether --help` outputs comprehensive usage instructions and options.
+
+### Interactive Chat & UI
+- [ ] The CLI starts with a cyberpunk banner and colored interface.
+- [ ] Spinning indicators are displayed while waiting for an API response.
+- [ ] File attachments can be specified using a CLI argument or dynamic chat command (e.g., `/attach`).
+
+### Key Management
+- [ ] Interactive configuration command successfully creates/updates `~/.aether/config.json`.
+- [ ] A fallback mechanism works when `~/.aether/config.json` is absent but environment variables are set.
+- [ ] Listing the configuration masks keys (showing only prefix/suffix with dots).
+
+### Math Fallback
+- [ ] Running a math query when offline or with simulated network failure returns correct evaluation outputs from the local JS fallback engine.
+
+### CI/CD and Tests
+- [ ] Running `npm test` executes the unit test suite and passes successfully.
+- [ ] A `.github/workflows/ci.yml` workflow file exists and defines linting and testing steps.
+- [ ] Git repository is initialized in the working directory and a clean initial commit has been made.
+
+## Follow-up — 2026-06-25T13:33:56Z
+
+The user has specified an additional critical requirement:
+"and also it should fell better then clude code and codex so it will be opensorce and free so it will blow i guess"
+
+Ensure the CLI UX is absolutely premium, responsive, and visually stunning—outperforming tools like Claude Code and Codex CLI. It must feel extremely polished, fast, and feature-rich (cyberpunk ASCII art, interactive autocomplete/menu helpers, smooth animations, and perfect markdown rendering). Focus heavily on the UI polish and usability so that it stands out as a top-tier open-source tool.

package/README.md

@@ -0,0 +1,271 @@
+# Aether AI CLI
+
+> ⚡ **Universal AI Gateway** — 13+ providers, free & paid models, cyberpunk terminal
+
+[![npm version](https://img.shields.io/npm/v/@krylo-60/aether-ai-cli.svg)](https://www.npmjs.com/package/@krylo-60/aether-ai-cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-cyan.svg)](LICENSE)
+[![Node.js](https://img.shields.io/badge/Node.js-≥18.0.0-green.svg)](https://nodejs.org)
+
+```
+  ╔═══════════════════════════════════════════════════════════╗
+  ║     █████╗ ███████╗████████╗██╗  ██╗███████╗██████╗    ║
+  ║    ██╔══██╗██╔════╝╚══██╔══╝██║  ██║██╔════╝██╔══██╗   ║
+  ║    ███████║█████╗     ██║   ████████║█████╗  ██████╔╝   ║
+  ║    ██╔══██║██╔══╝     ██║   ██╔══██║██╔══╝  ██╔══██╗   ║
+  ║    ██║  ██║███████╗   ██║   ██║  ██║███████╗██║  ██║   ║
+  ║    ╚═╝  ╚═╝╚══════╝   ╚═╝   ╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝   ║
+  ╚═══════════════════════════════════════════════════════════╝
+```
+
+**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
+- 🔄 **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
+
+---
+
+## 🚀 Quick Start
+
+### Install globally
+
+```bash
+npm install -g @krylo-60/aether-ai-cli
+```
+
+### Or run directly with npx
+
+```bash
+npx @krylo-60/aether-ai-cli chat
+```
+
+### Setup (Interactive Wizard)
+
+```bash
+aether setup
+```
+
+The wizard walks you through configuring providers — **start with free ones!**
+
+### Or set keys manually
+
+```bash
+# 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
+
+```bash
+aether chat
+```
+
+### Quick one-shot query
+
+```bash
+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
+
+```bash
+aether chat                    # Interactive chat session
+aether ask "your question"     # Single-shot query
+aether setup                   # Guided provider setup wizard
+```
+
+### Configuration
+
+```bash
+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
+
+```bash
+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
+
+```bash
+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 |
+| `/modes` | List all modes with signal bars |
+| `/attach <file>` | Attach a file for context |
+| `/files` | List attached files |
+| `/clear` | Remove attached files |
+| `/providers` | Show active providers |
+| `/export` | Export chat to Markdown |
+| `/status` | Session status |
+| `/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:
+
+```bash
+# 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
+
+```bash
+# 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](LICENSE) for details.
+
+---
+
+## 👨‍💻 Author
+
+**Krishiv PB** ([@Krylo-60](https://github.com/Krylo-60))
+
+> *"Stay cyberpunk. ⚡"*
+
+---
+
+<p align="center">
+  <b>⚡ Aether Core AI v110 — Fusion Command Station ⚡</b><br>
+  <i>Universal AI Gateway for the Terminal</i>
+</p>

package/aether_pip/__init__.py

@@ -0,0 +1 @@
+# Aether AI CLI Pip Package Wrapper

package/aether_pip/cli.py

@@ -0,0 +1,49 @@
+import sys
+import os
+import subprocess
+import shutil
+
+def main():
+    # Find the Node.js entry point absolute path inside aether_pip/node_project
+    script_dir = os.path.dirname(os.path.abspath(__file__))
+    node_project_dir = os.path.join(script_dir, "node_project")
+    aether_js = os.path.join(node_project_dir, "bin", "aether.js")
+    
+    # If not found globally, check dev layout relative to current working directory
+    if not os.path.exists(aether_js):
+        aether_js = os.path.join(os.getcwd(), "bin", "aether.js")
+        node_project_dir = os.getcwd()
+
+    if not shutil.which("node"):
+        print("Error: Node.js is required to run Aether AI CLI.", file=sys.stderr)
+        print("Please install Node.js (https://nodejs.org) and try again.", file=sys.stderr)
+        sys.exit(1)
+
+    # Check if node_modules exists in the node_project directory.
+    # If not, automatically run npm install inside that directory!
+    node_modules_dir = os.path.join(node_project_dir, "node_modules")
+    if not os.path.exists(node_modules_dir):
+        print("First-time launch check: Installing node dependencies via npm...")
+        npm_cmd = shutil.which("npm")
+        if not npm_cmd:
+            print("Error: npm is required to install Node dependencies.", file=sys.stderr)
+            print("Please install Node.js/npm and try again.", file=sys.stderr)
+            sys.exit(1)
+        
+        # On Windows, run npm using shell=True to handle cmd/bat resolution
+        subprocess.run([npm_cmd, "install", "--no-audit", "--no-fund"], cwd=node_project_dir, shell=(os.name == "nt"))
+
+    try:
+        # Run node aether.js passing all command line arguments
+        cmd = ["node", aether_js] + sys.argv[1:]
+        result = subprocess.run(cmd, check=False)
+        sys.exit(result.returncode)
+    except KeyboardInterrupt:
+        print("\nSession terminated by user.")
+        sys.exit(0)
+    except Exception as e:
+        print(f"Error running Aether: {e}", file=sys.stderr)
+        sys.exit(1)
+
+if __name__ == "__main__":
+    main()

package/bin/aether.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+
+// ═══════════════════════════════════════════════════════════
+// AETHER AI CLI — Entry Point
+// Universal AI Gateway — 13+ Providers, Free & Paid
+// ═══════════════════════════════════════════════════════════
+
+import { createCLI } from "../src/cli.js";
+
+createCLI(process.argv);

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@krishivpb60/aether-ai-cli",
+  "version": "1.0.0",
+  "description": "Aether Core AI — A cyberpunk command-line AI assistant with multi-mode reasoning, 12-node failover mesh, file context injection, and offline fallbacks.",
+  "main": "src/cli.js",
+  "bin": {
+    "aether": "bin/aether.js"
+  },
+  "type": "module",
+  "scripts": {
+    "start": "node bin/aether.js",
+    "test": "node --test"
+  },
+  "keywords": [
+    "ai",
+    "cli",
+    "gemini",
+    "grok",
+    "xai",
+    "chatbot",
+    "aether",
+    "cyberpunk",
+    "terminal",
+    "assistant"
+  ],
+  "author": "Krishiv PB <krylobloxyt@gmail.com> (https://github.com/Krylo-60)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Krylo-60/aether-ai-cli.git"
+  },
+  "homepage": "https://github.com/Krylo-60/aether-ai-cli#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "marked": "^14.0.0",
+    "marked-terminal": "^7.2.0",
+    "ora": "^8.1.0"
+  }
+}

package/setup.py

@@ -0,0 +1,51 @@
+from setuptools import setup, find_packages
+import os
+import shutil
+
+# Copy Node project files into aether_pip/node_project for clean packaging
+dest_dir = os.path.join('aether_pip', 'node_project')
+if os.path.exists(dest_dir):
+    shutil.rmtree(dest_dir)
+os.makedirs(dest_dir)
+
+# Copy directories
+shutil.copytree('bin', os.path.join(dest_dir, 'bin'))
+shutil.copytree('src', os.path.join(dest_dir, 'src'))
+shutil.copyfile('package.json', os.path.join(dest_dir, 'package.json'))
+if os.path.exists('package-lock.json'):
+    shutil.copyfile('package-lock.json', os.path.join(dest_dir, 'package-lock.json'))
+
+def package_files(directory):
+    paths = []
+    for (path, directories, filenames) in os.walk(directory):
+        for filename in filenames:
+            rel_path = os.path.relpath(os.path.join(path, filename), 'aether_pip')
+            paths.append(rel_path)
+    return paths
+
+setup(
+    name="aether-ai-cli",
+    version="1.0.0",
+    author="Krishiv PB",
+    author_email="krylobloxyt@gmail.com",
+    description="Aether Core AI v110 — Universal AI Gateway CLI (Python Wrapper)",
+    long_description=open("README.md", "r", encoding="utf-8").read() if os.path.exists("README.md") else "",
+    long_description_content_type="text/markdown",
+    url="https://github.com/Krylo-60/aether-ai-cli",
+    packages=find_packages(),
+    package_data={
+        "aether_pip": package_files(os.path.join('aether_pip', 'node_project')),
+    },
+    include_package_data=True,
+    entry_points={
+        "console_scripts": [
+            "aether-pip=aether_pip.cli:main",
+        ],
+    },
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+    python_requires=">=3.6",
+)