Aetheria CLI

AI-powered game development CLI with a local embedded LLM, 45+ tools, autonomous agent mode, and 50+ slash commands. Works fully offline by default using a local GGUF model.

Installation

npm install -g aetheria-cli

Requirements: Node.js 18+ · Windows 10/11, macOS, Linux

On first launch Aetheria automatically downloads the local AI model (~4.5 GB, Qwen3-VL-8B Q4_K_M) from HuggingFace. An NVIDIA GPU is recommended but not required.

Quick start

aetheria          # Interactive REPL (chat mode)
aetheria yolo -p "create a jump mechanic in TypeScript" -s 5   # Autonomous agent

Key features

• Local LLM by default — Qwen3-VL-8B GGUF, ~35 tok/s with an RTX 4060
• Cloud providers — OpenAI, Anthropic, Groq, Gemini, Mistral, Ollama and more
• 45+ built-in tools — file I/O, Git, web search, system info, code parsing
• Autonomous agent (yolo) — multi-step tasks with doom-loop detection
• 50+ slash commands — /model, /memory, /agents, /architect, /voice, /stats, /sessions…
• GameDev commands — balance, prototype, gdd, shader, level, mechanic, asset
• MCP support — connect any Model Context Protocol server
• Permission modes — bypass · default · acceptEdits · plan · delegate · dontAsk
• Memory Bank — structured project documentation that persists across sessions

Switching AI provider

# Use OpenAI instead of local model
aetheria config set provider openai
aetheria config set apiKey sk-...

# Use Anthropic
aetheria config set provider anthropic
aetheria config set apiKey sk-ant-...

# Use Ollama (local server)
aetheria config set provider ollama
aetheria config set model llama3.2

Autonomous agent examples

aetheria yolo -p "create a complete Phaser 3 platformer with player movement and enemies" -s 10
aetheria yolo -p "refactor all TypeScript files to use strict mode" -s 5
aetheria yolo -p "analyze the codebase and generate a GDD" -m design -s 8

GameDev commands

aetheria balance stats player.json
aetheria prototype mechanic "dash ability with cooldown"
aetheria gdd create
aetheria shader create "water ripple effect"
aetheria level design "procedural dungeon with traps"

All commands

aetheria               Interactive REPL
aetheria yolo          Autonomous agent
aetheria design        Generate Game Design Document
aetheria generate      Generate code from description
aetheria analyze       Analyze code file
aetheria refactor      Refactor code
aetheria review        Code review
aetheria search        Semantic search in codebase
aetheria sessions      Manage sessions
aetheria memory        Persistent project memory
aetheria skills        Custom skills
aetheria config        Configuration
aetheria ollama        Ollama management
aetheria mcp           MCP servers
aetheria watch         File watcher (AI! / AI? triggers)
aetheria stats         Session statistics
aetheria check         System check

License

MIT © SwonDev