# Axel

> Agent orchestration, designed for Rex. Threads and named agents, back in the terminal. You type what you want done; a named agent (Claude Code, Codex, OpenCode, Goose, Cursor and more, run as their real CLIs) works on it in a durable thread, on this machine or another one on your tailnet.

Docs: https://axel.md/docs. Install: `curl -fsSL https://axel.md/install | sh`, then run `axel` in a Rex terminal.

## Docs

- [Introduction](https://axel.md/docs/): Agent orchestration, designed for Rex.
- [Installation](https://axel.md/docs/installation): Rex, Axel, and the harness your agents run.
- [Quick start](https://axel.md/docs/quick-start): Create an agent, give it something to do, and follow along.
- [Why Rex](https://axel.md/docs/why-rex): The foundation. What Rex changes about the terminal, and what Axel builds on it.
- [Threads](https://axel.md/docs/threads): The unit of work. An intent, and everything done in its name.
- [Agents and identity](https://axel.md/docs/agents): Named agents with their own Ed25519 keys, profiles and inboxes.
- [Agents working together](https://axel.md/docs/messaging): Messages, summons and replies between agents on a thread.
- [Permissions and budgets](https://axel.md/docs/policies): How much an agent may do alone, what it may never do, and what it may spend.
- [Tokens and cost](https://axel.md/docs/usage): What each agent spends, as it spends it, and how much of your plan is left.
- [The AXEL.md file](https://axel.md/docs/axel-md): One file at the root of a repo, for every harness: the project's context and the skills its agents use.
- [Remote hosts](https://axel.md/docs/remote-hosts): Run agents on another machine, close the laptop, find the work when you're back.
- [Getting the most out of Axel](https://axel.md/docs/tips): Habits that make agents, threads and hosts pay off.
- [Command line](https://axel.md/docs/cli): Every axel command. `axel <command> --help` has the flags.
- [Keyboard](https://axel.md/docs/keys): Keys in the launcher, the recent threads and the thread view.
- [The agent's toolkit](https://axel.md/docs/agent-toolkit): What Axel gives every agent session, the axel skill and MCP tools.

## For agents

- [SKILL.md](https://axel.md/SKILL.md): an Agent Skill that installs, sets up and runs Axel on someone's behalf. `npx skills add https://axel.md` installs it with its references from the well-known index at https://axel.md/.well-known/agent-skills/index.json.
- [llms-full.txt](https://axel.md/llms-full.txt): every docs page in one file.

## Source and design

- [Repository](https://github.com/scarce/axel): Rust workspace, Apache-2.0. Every commit on `main` that passes CI is a release.
- [Design](https://github.com/scarce/axel/blob/main/docs/DESIGN.md): the source of truth for concepts and flows.
- [Decision records](https://github.com/scarce/axel/tree/main/docs/adr): why Axel is the way it is.
- [Contracts](https://github.com/scarce/axel/blob/main/docs/CONTRACTS.md): the public API of every crate.