AetherAether/docs

Welcome to Aether

Author
fariazinhufariazinhu

Aether is an open-source CLI that transforms any codebase into an AI-native workspace — right from your terminal.

Why Aether?

Modern development demands more than just a code editor. You need a tool that understands your codebase — its structure, patterns, dependencies, and conventions.

Aether bridges the gap between your code and AI, giving you:

  • Instant context — Analyzes your codebase structure, patterns, and conventions automatically
  • Full-project awareness — Scans your entire project (not just a sample of files) to keep the AI from filling gaps with guesses
  • Provider agnostic — Works with OpenAI, Anthropic, Gemini, and OpenRouter (one key, many models)
  • Zero config to start — Just run aether and /config once to pick a provider

How It Works

  1. Install — Download the standalone binary or install via npm (see Installation)
  2. Run — Open a terminal in any project and type aether
  3. Configure — Run /config once to pick a provider (OpenAI, Anthropic, Gemini, or OpenRouter)
  4. Generate — Run /genesis to scan the whole project and generate docs that make sense for it

What you can do

ActionHow
Start a sessionaether
Configure your AI provider/config
Analyze & document your project/genesis
Update docs after code changes/sync
Manage global data & caches/clean
See all commands/help
Clear screen/clear
Exit/exit

Philosophy

The naming is intentional. In the Aether universe:

  • Genesis — The birth of your AI workspace. Analyzes your entire codebase and generates documentation — human guides and AI/architecture docs — picking which pages make sense for this project instead of a fixed template.
  • Context — The knowledge surrounding your code. Aether builds and maintains it for you.
  • Providers — The AI models that power analysis (OpenAI, Anthropic, Gemini, or OpenRouter as a single-key proxy to many more).

Architecture

Aether is built as a standalone binary — no Node.js, Python, or any runtime required. It ships as a single executable for Windows, macOS, and Linux.

Under the hood:

  • Interactive terminal UI with dropdown autocomplete and tab completion
  • Full-project context scanning — no arbitrary file-count cap, so genesis sees the whole codebase
  • Modular provider system (swap AI backends without changing workflow)
  • Global config (~/.aether/) — API keys and caches stay out of version control
  • Local-first: all data stays on your machine, generated docs live in .aether/docs/

Next Steps