Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
16 commits
Select commit Hold shift + click to select a range
d1b75ab
feat(skills): skill runtime and instruction resolver foundation
AetherAI3 Aug 19, 2026
1521199
fix(instructions): escape every glob metacharacter, not just the first
AetherAI3 Aug 19, 2026
ba7d041
feat(capabilities): capability matrix and redacted support bundle
AetherAI3 Aug 19, 2026
fd4e597
feat(doctor): skill and instruction health checks on the three-axis c…
AetherAI3 Aug 19, 2026
bb31a33
feat(cli): aether skills, capabilities and support-bundle, with packa…
AetherAI3 Aug 19, 2026
d71af73
chore: drop .aether/skills.lock.json committed by mistake
AetherAI3 Aug 19, 2026
7f55b0e
fix(repo): validate and fetch a --repo mirror instead of reusing it b…
AetherAI3 Aug 19, 2026
8e15476
fix(slash): /rollback stops accepting a count it never used, and stop…
AetherAI3 Aug 19, 2026
c214adc
fix(brain): correlate Ollama tool results by id, generate schemas, st…
AetherAI3 Aug 19, 2026
8ca821d
fix(chat): thread the abort signal into local turns so Ctrl+C works
AetherAI3 Aug 19, 2026
79e0bbc
fix(usage): make /limit a real stop boundary and stop reporting unkno…
AetherAI3 Aug 19, 2026
9de0b28
Merge remote-tracking branch 'origin/supercluster/a2-project-context'…
AetherAI3 Aug 19, 2026
b39e2c7
Merge remote-tracking branch 'origin/supercluster/a3-review-ship' int…
AetherAI3 Aug 19, 2026
79781f3
Merge remote-tracking branch 'origin/supercluster/a4-local-brain' int…
AetherAI3 Aug 19, 2026
e6e644f
Merge remote-tracking branch 'origin/supercluster/a1-tool-runtime' in…
AetherAI3 Aug 19, 2026
2b2d3cc
merge: integrate all six supercluster lanes and fix canonical reposit…
AetherAI3 Aug 19, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 45 additions & 3 deletions COMMANDS.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,9 @@ aether # no args = interactive REPL

<!-- CLI-COMMANDS:START -->
`help`, `agent`, `chat`, `resume`, `run`, `models`, `agents`, `auth`,
`github`, `vault`, `workflow`, `memory`, `image`, `video`, `output`, `audit`,
`receipt`, `doctor`, `mcp`, `config`
`github`, `vault`, `workflow`, `memory`, `skills`, `capabilities`, `image`,
`video`, `output`, `audit`, `receipt`, `doctor`, `support-bundle`, `mcp`,
`config`
<!-- CLI-COMMANDS:END -->

<!-- SLASH-COMMANDS:START -->
Expand Down Expand Up @@ -201,6 +202,47 @@ aether doctor --json # schema-versioned report for automation
`--deep` still means the read-only report it always meant; it now points at
`--live` for the end-to-end proof.

### `aether skills <subcommand>` — inspect, trust, and manage agent skills

Skills are packaged instructions the agent can load. Built-in skills ship with
the package; user skills live under your config directory; project skills live
in the repository you are working in.

```bash
aether skills list # every discovered skill, with scope and trust
aether skills show <id> # one skill: manifest, declared tools, digest
aether skills check [--all] # validate manifests and report index errors
aether skills trust <id> # approve a project skill at its current digest
aether skills lock # pin discovered project skills to a lockfile
```

**Project skills are untrusted until you approve them.** Trust is bound to the
skill's content digest, so editing a trusted skill revokes that trust until you
approve the new digest. A skill declaration narrows what the agent may do — it
never grants a tool the host would otherwise refuse.

### `aether capabilities [--available]` — what this build can actually do

Prints the capability contract: tools, their side-effect class, and the
permission each requires. `--available` additionally reports what is usable in
your current session rather than what exists in principle.

The command prefers the server manifest and falls back to a packaged snapshot
when the server cannot be reached. It says which one it used, and why, rather
than presenting stale data as live.

### `aether support-bundle` — a redacted diagnostic archive

Writes a `.tar` of metadata-only diagnostics for troubleshooting: a fast doctor
report, runtime facts, sanitized config, and skill and instruction inventories.

It carries counts, ids and digests — never prompts, file contents, tokens,
environment values or raw command text. Every entry is scanned before the
archive is finalized; if a secret is detected the bundle is refused rather than
written, and an interrupted run leaves no partial file behind.

Like `aether doctor`, it makes no network call and spends nothing.

### `aether mcp [list|doctor|repair]` — manage and diagnose MCP servers
With no subcommand (in a TTY), opens the same interactive MCP manager as the
`/mcp` slash command: an arrow-key menu over backend connections (OAuth/PAT
Expand Down Expand Up @@ -297,7 +339,7 @@ Each starts an agent loop in the REPL.
| `/snapshot list` | List saved snapshots. |
| `/limit <uvt>` | Cap UVT spend for the session (`/limit off` to remove). |
| `/audit-receipt [n]` | Verified log of tool calls + UVT (local custody + server). |
| `/rollback [n]` | Revert the last n uncommitted filesystem changes (git-backed). |
| `/rollback` | Discard uncommitted changes to tracked files (git-backed). Restores from the index, so files with staged changes come back to their staged state, not to the last commit. Untracked files are never touched. |
| `/logs-view`, `/logs` | Interactive session log browser. |

### Goals & workflows
Expand Down
4 changes: 2 additions & 2 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ to read end to end in an afternoon.
## Setup

```bash
git clone https://github.com/DBarr3/aether-agent
git clone https://github.com/AetherAI3/aether-agent
cd aether-agent
npm install
npm run build
Expand Down Expand Up @@ -58,7 +58,7 @@ Most features touch a `core/` module + a `commands/` file.

## Reporting bugs / ideas

Open an [issue](https://github.com/DBarr3/aether-agent/issues). For security
Open an [issue](https://github.com/AetherAI3/aether-agent/issues). For security
reports, **do not** open a public issue — see [`SECURITY.md`](SECURITY.md).

By contributing you agree your contributions are licensed under Apache-2.0.
10 changes: 5 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

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

[![CI](https://github.com/DBarr3/aether-agent/actions/workflows/ci.yml/badge.svg)](https://github.com/DBarr3/aether-agent/actions/workflows/ci.yml) [![License](https://img.shields.io/badge/license-Apache--2.0-06b6d4)](LICENSE) [![Node](https://img.shields.io/badge/node-%E2%89%A524-14b8a6)](https://nodejs.org) [![TypeScript](https://img.shields.io/badge/TypeScript-7-3178c6)](https://www.typescriptlang.org/) [![Release notes](https://img.shields.io/badge/release-notes-7c3aed)](RELEASE_NOTES.md)
[![CI](https://github.com/AetherAI3/aether-agent/actions/workflows/ci.yml/badge.svg)](https://github.com/AetherAI3/aether-agent/actions/workflows/ci.yml) [![License](https://img.shields.io/badge/license-Apache--2.0-06b6d4)](LICENSE) [![Node](https://img.shields.io/badge/node-%E2%89%A524-14b8a6)](https://nodejs.org) [![TypeScript](https://img.shields.io/badge/TypeScript-7-3178c6)](https://www.typescriptlang.org/) [![Release notes](https://img.shields.io/badge/release-notes-7c3aed)](RELEASE_NOTES.md)

**Aether Agent is in beta.** Updates are shipping quickly.
```bash
Expand Down Expand Up @@ -39,7 +39,7 @@ 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](https://github.com/DBarr3/Unlimited-Context-LLM)** — Aether's open-source (Apache-2.0) memory engine that gives any Ollama model a billion-token working memory.
`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](https://github.com/AetherAI3/Unlimited-Context-LLM)** — 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`](install.sh) or [`install.ps1`](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.

Expand Down Expand Up @@ -80,7 +80,7 @@ Media is 15 image models (Nano Banana Pro & 2, FLUX.2 Klein / Pro / Flex / Max,

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](https://github.com/DBarr3/aethercloud), and [Aether AI on the web](https://app.aethersystems.net/chat). Free tier to try (no card), subscription for premium models, UVT top-ups for pay-as-you-go. **Current tiers and prices: [aethersystems.net](https://aethersystems.net/)**
Usage is metered in **UVT** — one universal credit, one balance, shared across this agent, the [AetherCloud desktop](https://github.com/AetherAI3/aethercloud), and [Aether AI on the web](https://app.aethersystems.net/chat). Free tier to try (no card), subscription for premium models, UVT top-ups for pay-as-you-go. **Current tiers and prices: [aethersystems.net](https://aethersystems.net/)**

## Commands

Expand Down Expand Up @@ -129,7 +129,7 @@ npm run smoke
npm pack --dry-run
```

The verified TypeScript 7 release baseline is tagged [`v0.1.0`](https://github.com/DBarr3/aether-agent/tree/v0.1.0). Migration details and measurements are in the [TypeScript 7 upgrade design](docs/specs/2026-07-20-typescript-7-terminal-upgrade-design.md).
The verified TypeScript 7 release baseline is tagged [`v0.1.0`](https://github.com/AetherAI3/aether-agent/tree/v0.1.0). Migration details and measurements are in the [TypeScript 7 upgrade design](docs/specs/2026-07-20-typescript-7-terminal-upgrade-design.md).

## Security

Expand All @@ -149,7 +149,7 @@ Aether Agent is the **terminal** surface of Aether. Every surface below shares o
| **Aether AI on the web** | [app.aethersystems.net/chat](https://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](https://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](https://app.aethersystems.net/design) | Design Studio — canvas, creator and presets, with the agent editing the design directly. |
| **AetherCloud desktop** | [github.com/DBarr3/aethercloud](https://github.com/DBarr3/aethercloud) | The agentic desktop app — projects, workflows, the memory Vault, and local Actions runs that can open a pull request. |
| **AetherCloud desktop** | [github.com/AetherAI3/aethercloud](https://github.com/AetherAI3/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](https://aethersystems.net/terminal) | What this CLI looks like, before you install anything. |

Get the desktop at **[aethersystems.net](https://aethersystems.net/)** — installs in about a minute, no card needed. Platform-wide patch notes live at **[app.aethersystems.net/release-notes](https://app.aethersystems.net/release-notes)**; terminal-specific ones are in [RELEASE_NOTES.md](RELEASE_NOTES.md).
Expand Down
Loading