CLI Reference — AETHER

Usage

bun run bin/aether.ts <command> [options]bash

Commands

`run`

Execute a task — routes to the best-fit agent automatically. The orchestrator (cortex-0) decomposes complex tasks, managers coordinate, and workers execute.

aether run "your task description"
aether run -p gemini -m gemini-2.0-flash "explain recursion"
aether run -p ollama -m deepseek-r1 "hello world"
aether run -a cortex-0 "decompose this project"
aether run -a react-specialist "build a todo list component"bash

Options

Flag	Description
`-p, --provider <name>`	LLM provider (claude, openai, gemini, ollama)
`-m, --model <name>`	Model name or alias
`-a, --agent <id>`	Target a specific agent by ID

`init`

Scan the workspace, detect tech stack, discover agents, create .aether/ config.

aether initbash

Creates:

.aether/config.json — auto-generated provider & server config
.aether/settings.json — user-editable runtime settings
.aether/aether.db — local SQLite database for memory & metrics

`link`

Start the Aether-Link WebSocket server.

aether linkbash

Runs on port 9999 by default. Uses the BAP-02 binary protocol. Supports token-based auth, origin validation, and rate limiting.

`status`

Show runtime status — agent counts, server health, provider status.

aether statusbash

`registry`

Display all registered agents in an ASCII table with tiers, sections, and status.

aether registrybash

`spawn`

Activate a specific agent by ID.

aether spawn react-specialistbash

`scan`

Scan workspace and display detected tech stack.

aether scanbash

`config`

View and manage settings. Supports multiple sub-commands:

aether config                        # Show all settings
aether config get <path>             # Get setting (dot-path)
aether config set <path> <value>     # Set a setting
aether config reset [section]        # Reset to defaults
aether config edit                   # Open settings.json in $EDITOR
aether config validate               # Validate current settings
aether config path                   # Print settings.json pathbash

Examples

aether config get execution.maxDepth        # → 3
aether config set execution.maxDepth 5      # Update
aether config get routing.confidenceThreshold
aether config reset escalation              # Reset escalation sectionbash

`context`

Manage agent namespace contexts.

aether context list                  # List all contexts
aether context switch <name>         # Switch active contextbash

MCP Server

AETHER includes an MCP (Model Context Protocol) server for AI assistant integration:

bun run bin/aether-mcp.ts --workspace /path/to/projectbash

MCP Tools

Tool	Description
`submit_task`	Route a task to the agent hierarchy
`query_agents`	Search agents by capability, section, or tier
`search_memory`	RAG-indexed memory search
`get_status`	System status (agents, cache, tiers)
`switch_context`	Change active namespace
`get_config`	Read settings by dot-path

MCP Resources

Resource	Description
`aether://agents`	Full agent registry
`aether://agents/{id}`	Single agent details
`aether://settings`	All settings
`aether://metrics`	System metrics

Synapse DSL

Define workflows in .syn files using the Synapse domain-specific language:

@workflow data-pipeline
  @trigger on_commit("main")

  step analyze = research-agent("Analyze the PR changes")
  step review  = code-reviewer(analyze.output)
  step report  = report-writer(review.output)

  @output report.outputsyn

Compile a workflow:

bun run compile -- workflow.synbash

What's Next?

Getting Started →

Install AETHER, set up providers, and run your first task.

Architecture →

Deep-dive into the 28 subsystems powering AETHER.

Agent Guide →

Understand the 3-tier hierarchy and agent lifecycle.

Changelog →

Version history and release notes.