AGH

An open workplace for AI agents.

<a href="https://github.com/compozy/agh/actions/workflows/ci.yml">
  <img src="https://github.com/compozy/agh/actions/workflows/ci.yml/badge.svg" alt="CI">
</a>
<a href="https://github.com/compozy/agh/releases">
  <img src="https://img.shields.io/github/v/release/compozy/agh?include_prereleases" alt="Release">
</a>
<a href="https://goreportcard.com/report/github.com/compozy/agh">
  <img src="https://goreportcard.com/badge/github.com/compozy/agh" alt="Go Report Card">
</a>
<a href="https://github.com/compozy/agh/raw/v0.0.9/LICENSE">
  <img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT">
</a>

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.

Highlights

• AGH Network. Active sessions become peers — they discover each other, exchange typed envelopes on agh-network/v0 channels, 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.

Install

curl -fsSL https://agh.network/install.sh | sh

Homebrew:

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.

Quick start

agh install
agh daemon start
agh workspace add "$PWD" --name current
agh session new --workspace current --agent general

See the Quick Start for the full walkthrough.

Documentation

• Runtime overview
• Installation
• Quick Start
• CLI reference
• Extensions
• AGH Network protocol
• GitHub releases

Development

AGH is a Go and Bun monorepo. Install the toolchains declared by the repo and run the full verification gate before sending changes:

make verify

Contributing

Contributions are welcome. Open an issue or pull request, and run make verify before sending changes.

Contributors

Thanks to everyone who has contributed to AGH.

License

AGH is released under the MIT License.

Star history