axiopera 0.2.0

Orchestrate coding agents (Claude Code, Codex, Grok Build) as sub-agents of each other
# Axiopera

[简体中文](README.zh-CN.md)

Lightweight, minimally invasive collaboration for coding agents.

Bring Claude Code, Codex, and Grok Build together with a single executable. Keep your existing tools and sign-ins, and start delegating tasks with a few commands.

Ask Codex to review Claude's changes, split a task across models, or leave a longer job running after your session ends.

- Send new instructions while a task is running.
- Let agents ask questions and exchange notes.
- Give each task its own model and permissions.
- Continue a task in its original agent CLI when you want to take over.

Each agent starts with the task description you provide. Include the context it needs.

## Install

Install and sign in to the agent CLIs you want to use. Axiopera uses those existing accounts.

Download the archive for your system from [GitHub Releases](https://github.com/Victor-Quqi/Axiopera/releases), extract it, and put `axiopera` or `axiopera.exe` in a directory on your PATH.

Or install from [crates.io](https://crates.io/crates/axiopera) with Rust:

```sh
cargo install axiopera --locked
axiopera --version
```

Windows and Linux have been tested; macOS still needs validation. See the [tested versions](docs/verification.md#已测版本).

## Get started

Give your coding agent the Axiopera skill, so it knows how to delegate: copy the [`plugins/axiopera/skills/axiopera`](plugins/axiopera/skills/axiopera) folder into `~/.claude/skills/` for Claude Code, or into `~/.agents/skills/` for Codex. Grok reads both.

In Codex you can install the plugin instead. Besides the skill, it lets a busy session know when its sub-tasks have news:

```sh
codex plugin marketplace add Victor-Quqi/Axiopera
codex plugin add axiopera@axiopera
```

The [usage guide](docs/usage.md#skill-与-codex-插件) covers the hooks and uninstalling.

Or add this to your agent's project instructions instead:

> When delegating tasks through Axiopera, first run `axiopera guide --host <your harness: claude, codex or grok>`.

Or try a task from your terminal:

```sh
axiopera spawn codex --tier read --name review "Review this repository and report the issues most worth fixing."
axiopera wait review
axiopera inbox review
```

The task starts in the background. `wait` blocks until it has news, `inbox` takes its answer, and `send` lets you follow up in the same conversation.

See the [agent guide](src/guide.md) for more examples, or run `axiopera --help`. The [usage and configuration guide](docs/usage.md) is currently in Chinese.

## License

[Apache-2.0](LICENSE).