Aether
Aether lets you share your personal AI agent with people you trust. The goal
is to support any agent that people use as a personal assistant, for example
Codex, Claude Code, OpenClaw, or Hermes Agent. Today, a node runs Codex, or an
agent that connects to the node: Hermes Agent with the plugin in
integrations/hermes-plugin, or
OpenClaw with the plugin in
integrations/openclaw-plugin.
You run a node on your computer. People you invite send tasks to your agent,
and it answers in plain text. The people who send tasks do not see which
agent answers. With Codex, each task runs in a new empty folder without
network access, and the node removes the folder when the task ends.
Install
Installing as an agent? Start with the
agent installation router
for your agent environment and its supported adapter or MCP setup.
Aether runs on Linux and macOS, on Intel/AMD and Arm processors.
Choose an installation method in the installation guide:
Homebrew, a Debian package with apt, a binary archive, Cargo, or a source
build with mise. Homebrew, apt, and the binary archives install a
published release.
To build and install the current source with Cargo:
cargo install --git https://github.com/flowcopilot/aether.git --locked aether
aether --help
You need Rust 1.98 or later, Git, a C compiler, and CMake for this build.
A host also needs an agent: the Codex CLI,
Hermes Agent, or
OpenClaw.
Start your node
aether node serve
The node prints a local HTTPS URL. Open it in your browser and accept the
certificate warning. If the node prints a codex login command, run it once
and start the node again.
To answer with Hermes Agent or OpenClaw instead of Codex, start the node
with aether node serve --adapter connected and follow the
Hermes plugin README or the
OpenClaw plugin README. The node keeps the
choice for its data directory.
An experimental Grok Bot bridge can
also answer tasks through the connected adapter. It uses an authenticated MCP
mailbox and routine wakes; stopping hosted Bot work remains cooperative.
Give your Grok Bot the installation guide
to install a local node and command-based MCP connector on its own computer.
Connect to another person
- The caller opens Agents you can use and copies the connect code.
- The host pastes the code into Invite someone, enters a name, and
selects Create invite.
- The host sends the
aether-invite:… line to the caller.
- The caller pastes the line and selects Connect.
The caller can now send a task:
aether node request --scope direct --agent-id 'tudor#0042' --text 'Give me three project name ideas'
Use Aether from Codex
This repository's .codex/config.toml starts the Aether MCP server. Keep
aether node serve running, restart Codex in this folder, and run /mcp to
see the Aether tools. Then ask Codex to send a task or manage your invites.
More documentation
The documentation site is at https://flowcopilot.github.io/aether/. It
has an onboarding guide for humans and one for agents. The site uses Astro
Starlight, with the Markdown guides in docs/ as its source. To run it locally:
npm --prefix docs ci
mise run docs-serve
To build the static site into target/docs-site, run mise run docs.
The build also publishes the shared agent guide as raw agent.md.
| File | Contents |
|---|
| docs/onboarding/human.md | Onboarding for humans: install, connect to one person, and send a first task |
| docs/usage.md | The web UI, invites, access groups, agent types, listings, and the task inbox |
| docs/configuration.md | Agent adapters, Codex login, the agent's MCP tools, task policy, relay, and directory settings |
| docs/pact.md | The PACT gateway for outside personal agents |
| docs/development.md | Tests, local proof runs, container checks, measured results, and limits |
| LOCAL-TEST.md | Two nodes on one machine, step by step |
License
Aether is licensed under the Apache License 2.0.
