Skip to content

Repository files navigation

Aether Agent

A coding agent for your terminal — runs on hosted frontier models or fully offline on your own machine.

CI License Node TypeScript Release notes

Aether Agent is in beta. Updates are shipping quickly.

npm i -g aether-agents --ignore-scripts     # or run once: npx --ignore-scripts aether-agents

Install · Models & pricing · Commands · Security · Platform · Release notes

Aether Agent — terminal coding session

It scans, plans, edits, and runs your tests — in your repo, on your terms. Verification is ground truth: the agent re-runs your test command and reads the exit code itself, so "done" is never the model's word. And with QOPC memory it learns from what you accept, revise, or discard — measurably better the more you use it, no config, no fine-tuning.

Install in three moves

Install in three moves — drop it in, run on the fleet, or go fully offline
npm i -g aether-agents --ignore-scripts     # 01 — drop it in (Node ≥ 24)

aether auth login          # 02 — sign in once
aether agent               #      …terminal opens. Just start chatting.

ollama pull qwen2.5-coder:7b   # 03 — or go offline: no account, no network
aether agent --local           #      …same terminal, nothing leaves the machine

aether agent opens the REPL — chat with the model, slash-commands at hand, the agent edits files and runs your tests in the same session. Both brains run through the same host loop, render, tools, and commands — switching just swaps the transport. On the hosted path your code stays local and only the prompt + context you send leaves; on --local, nothing leaves at all. The local brain runs on Unlimited Context — Aether's open-source (Apache-2.0) memory engine that gives any Ollama model a billion-token working memory.

Prefer the installer UI? Download install.sh or install.ps1, inspect it, then run it locally. Set AETHER_VERSION=0.1.0 (shell) or -Version 0.1.0 (PowerShell) to pin an exact release. The canonical npm command above verifies registry integrity and disables lifecycle scripts; there are no native or runtime dependencies and no daemon.

Models & pricing

One fleet, transparent per-token pricing — Claude, GPT, DeepSeek, Kimi, Gemma and Gemini for text & code, a 32-model image / video / 3D fleet, plus the Neo · Kronus · Aether-Vision orchestrators. aether models prints what your plan can actually reach, live from the server — the tables below are the current shape of it.

Frontier — Pro / Team

Model --model key Context window
Claude Opus 5 opus5 1,000,000
GPT-5.6 Sol gpt56_sol 1,050,000
GPT-5.6 Terra gpt56_terra 1,050,000
GPT-5.6 Luna gpt56_luna 1,050,000
Kimi K3 kimi_k3 1,048,576
Gemini 3.6 Flash gemini36_flash 1,048,576

Six frontier models, every one with a million-token window. In the GPT-5.6 family, Sol takes the hardest reasoning and coding work, Terra is the balanced everyday pick, Luna is the fast, cost-sensitive one — and all three are priced through their true 1,050,000-token window, with the long-context band billed exactly rather than estimated. Opus 5 is an addition, not a replacement: --model opus still resolves to Claude Opus 4.8 and nothing you have configured changes.

The rest of the fleet

Plan What you can select
Free Claude Haiku 4.5 · DeepSeek V4 Flash · one image model as a teaser
Solo + Claude Sonnet 5 · GPT-5.4 mini · the Neo 5.1T orchestrator · the full image fleet
Pro / Team + Claude Opus 4.8 · GPT-5.5 · DeepSeek V4 Pro · Kimi K2.6 · Gemma 4 31B · the six frontier models above · video & 3D generation · the Kronus v2.4 and Aether-Vision orchestrators

Media is 15 image models (Nano Banana Pro & 2, FLUX.2 Klein / Pro / Flex / Max, Recraft V3 & V4, Seedream 4.5, Riverflow V2, GPT-5 Image), 16 video models (Seedance 2.0 & 1.5 Pro, Veo 3.1 / Fast / Lite, Kling 3.0 Standard & Pro, Kling Video O1, Sora 2 Pro, Wan 2.6 & 2.7, Hailuo 2.3, HunyuanVideo 1.5, Grok Imagine), and Hunyuan3D 2.1 for text-to-3D — all drivable from the prompt line with /photogen, /videogen and /storyboard.

On --local, none of the above applies: you run any Ollama model you have pulled, with no account, no fleet, and no metering.

Usage is metered in UVT — one universal credit, one balance, shared across this agent, the AetherCloud desktop, and Aether AI on the web. Free tier to try (no card), subscription for premium models, UVT top-ups for pay-as-you-go. Current tiers and prices: aethersystems.net

Commands

Inside the REPL, / commands control the whole session — type /help to see them in-session, or click the card above for the full reference. That includes generating images and video from the prompt line (/photogen, /videogen, /storyboard …) and connecting MCP servers with /mcp. From the shell:

aether agent                      # the main thing — open the REPL and chat
aether agent --local              # same REPL on a local Ollama brain (offline)
aether models                     # list models + orchestrators
aether resume                     # replay / continue the last session

Flags you can set when launching the REPL (or pass with an inline task aether agent "<task>" for one-shot autonomous mode):

Flag What it does
--local Local Ollama brain instead of the hosted API.
--model <id> Force a model by key (--model opus5, --model gpt56_terra, or an Ollama tag with --local).
--effort <tier> Budget ceiling: LOW · MED · MAX · ULTRA · CODEPRO.
--test-cmd <cmd> Command the verification gate runs (default pytest -q).
--worktree Fresh git worktree on an auto-named branch (isolated).
--repo <owner/name> Clone a GitHub repo via your own gh/git auth, work it in a worktree.
-y, --yes Auto-confirm prompts (non-interactive).

Full reference — every command, flag, slash command, and env var: COMMANDS.md. Dated patch notes: RELEASE_NOTES.md · docs/releases/.

Development

The application and executable test suite are fully on TypeScript 7.0.2, with Node.js 24 or newer as the supported runtime. Strict ESM compilation emits the distributable JavaScript to dist/; the published package contains dist/src and excludes compiled tests.

Run the release gates from a clean checkout:

npm ci
npm run typecheck
npm test
npm run smoke
npm pack --dry-run

The verified TypeScript 7 release baseline is tagged v0.1.0. Migration details and measurements are in the TypeScript 7 upgrade design.

Security

  • Your code stays local. Edits apply on your machine, path-guarded — the client refuses to write outside your working directory.
  • Verification is ground truth. The host runs your test command and reads the exit code itself; "done" is never the model's word.
  • Tokens are credentials. Stored chmod 600, never committed; aether auth logout clears them.
  • The server is the authority. On the API path, usage limits, model access, and signed chain-of-custody receipts are enforced server-side — the client only displays what the server reports.

Found a vulnerability? See SECURITY.md.

Part of the Aether platform

Aether Agent is the terminal surface of Aether. Every surface below shares one login, one UVT balance, one model fleet, and one memory — start a task here, pick it up on the web, finish it in the IDE.

Surface Where What it is
Aether AI on the web app.aethersystems.net/chat The Workbench — chat, agents you can launch, a work tray for everything they produce, image & video generation, your vault.
Aether Code app.aethersystems.net/code The browser IDE — the agent console docked beside your files, worktree teams and per-session transcripts, Nano compile & IR export.
Aether Design app.aethersystems.net/design Design Studio — canvas, creator and presets, with the agent editing the design directly.
AetherCloud desktop github.com/DBarr3/aethercloud The agentic desktop app — projects, workflows, the memory Vault, and local Actions runs that can open a pull request.
Aether Terminal aethersystems.net/terminal What this CLI looks like, before you install anything.

Get the desktop at aethersystems.net — installs in about a minute, no card needed. Platform-wide patch notes live at app.aethersystems.net/release-notes; terminal-specific ones are in RELEASE_NOTES.md.

License

Apache-2.0 — use it, fork it, ship it. The license covers the code, not the Aether name or hosted service (LICENSE · NOTICE.md). PRs and issues welcome — see CONTRIBUTING.md.


Built by Aether AI · aethersystems.net

One terminal. Frontier models or fully local. Your code stays yours.

About

An open-source coding agent for your terminal — hosted frontier models or fully offline via Ollama. One account with Aether AI.

Topics

Resources

Contributing

Security policy

Stars

4 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages