Package Exports

aetheria-cli
aetheria-cli/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (aetheria-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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

aetheria-cli