Warning
AGH is now CompozyOS. Development continues at github.com/compozy/compozy.
This repository is frozen and no longer accepts issues, pull requests, or releases.
What happened. AGH and Compozy were two projects solving the same problem from opposite ends. Instead of maintaining both, the AGH codebase — the daemon, the autonomy kernel, the network, the web UI — became the engine of Compozy, and Compozy keeps its name, its history, and its community. The merged product ships as CompozyOS v0.3.0 — "The OS Release".
What that means for you.
| Before (AGH) | After (CompozyOS) |
|---|---|
agh binary |
compozy binary |
github.com/compozy/agh |
github.com/compozy/compozy |
@compozy/agh (npm) |
@compozy/cli (npm) |
.agh/ home |
.compozy/ home |
AGH_* env vars |
COMPOZY_* env vars |
agh-network/v0 |
compozy-network/v0 |
agh__* native tools |
compozy__* native tools |
| agh.network | compozy.com |
This is an intentional breaking change with no compatibility shims. A migration guide ships with v0.3.0, covering the old-to-new command map, an automatic configuration migrator, and what changed and why. Existing installs upgrade in place through the same Homebrew and npm channels.
Where to go now: github.com/compozy/compozy for the code, issues, and releases. The last AGH release remains downloadable here, unsupported.
AGH is a local-first agent operating system. It runs the agent CLIs you already use — Claude Code, OpenClaw, Hermes, and others — as durable, inspectable sessions managed by a single background daemon, and connects them on the open agh-network/v0 so sessions can discover peers, share capabilities, and close work with receipts.
The complete documentation lives at agh.network.
- AGH Network. Active sessions become peers — they discover each other, exchange typed envelopes on
agh-network/v0channels, and close work with receipts. - Local-first durable runtime. One Go binary and a background daemon keep sessions, events, and state in local SQLite — durable, resumable, and inspectable long after the terminal closes.
- Agent-manageable surfaces. The same runtime state is exposed through CLI, HTTP/SSE, UDS, and a web UI, so agents operate AGH through structured controls instead of UI-only paths.
- Autonomy kernel. Task runs, claim tokens, leases, and safe spawn keep multi-agent work observable and bounded.
- Extensible runtime. Native Go tools, MCP, extensions, hooks, skills, and bridges plug into one daemon-owned tool registry.
curl -fsSL https://agh.network/install.sh | shHomebrew:
brew install compozy/compozy/agh
npm:
npm install -g @compozy/agh
Go:
go install github.com/compozy/agh@latest
The full Installation guide covers the verified binary installer, Linux packages, and source builds.
agh install
agh daemon start
agh workspace add "$PWD" --name current
agh session new --workspace current --agent generalSee the Quick Start for the full walkthrough.
- Runtime overview
- Installation
- Quick Start
- CLI reference
- Extensions
- AGH Network protocol
- GitHub releases
AGH is a Go and Bun monorepo. Start the daemon with automatic Go rebuilds and the web UI with Vite HMR:
make dev
The first successful build stops any daemon using the active AGH_HOME and takes over its lifecycle. A failed Go rebuild keeps the last successful daemon running; the next successful build replaces it. Vite uses the first available port starting at 3000, and the daemon's web routes redirect to that live UI while API traffic stays on the daemon. Set AGH_WEB_PORT to require a specific web port. Press Ctrl-C to stop the owned daemon and both development processes, or use make dev-daemon when you only need the backend.
Run the full verification gate before sending changes:
make verify
Contributions are welcome. Open an issue or pull request, and run make verify before sending changes.
Thanks to everyone who has contributed to AGH.
AGH is released under the MIT License.