agh

command module
v0.0.5 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: May 29, 2026 License: MIT Imports: 4 Imported by: 0

README

AGH

AGH

An open workplace for AI agents.

CI Release Go Report Card

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

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

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.

Contributors

License

AGH is released under the MIT License.

Star history

Star History Chart

Documentation

Overview

Package main is the root AGH CLI entrypoint for go install github.com/compozy/agh.

Source Files

View all Source files

Directories

Path Synopsis
cmd
agh command
Package main is the AGH CLI entrypoint.
 Package main is the AGH CLI entrypoint.
agh-codegen command
extensions
bridges/discord command
bridges/gchat command
bridges/github command
bridges/linear command
bridges/slack command
bridges/teams command
bridges/telegram command
bridges/whatsapp command
internal
acp
Package acp provides the AGH ACP client implementation.
 Package acp provides the AGH ACP client implementation.
agentidentity
Package agentidentity resolves daemon-validated caller identity for agent-facing CLI and UDS operations.
 Package agentidentity resolves daemon-validated caller identity for agent-facing CLI and UDS operations.
api/contract
Package contract defines the canonical shared daemon API request and response DTOs.
 Package contract defines the canonical shared daemon API request and response DTOs.
api/core
Package core provides the shared transport-facing API layer used by HTTP and UDS bindings.
 Package core provides the shared transport-facing API layer used by HTTP and UDS bindings.
api/httpapi
Package httpapi serves the AGH transport API over TCP HTTP/SSE.
 Package httpapi serves the AGH transport API over TCP HTTP/SSE.
api/spec
api/testutil
Package testutil provides shared helpers for API-layer tests.
 Package testutil provides shared helpers for API-layer tests.
api/udsapi
Package udsapi serves the AGH transport API over a Unix domain socket.
 Package udsapi serves the AGH transport API over a Unix domain socket.
automation
Package automation hosts the runtime automation components and re-exports the canonical automation model from `internal/automation/model`.
 Package automation hosts the runtime automation components and re-exports the canonical automation model from `internal/automation/model`.
automation/model
Package model defines the transport-agnostic automation domain model shared by configuration, persistence, runtime, and API layers.
 Package model defines the transport-agnostic automation domain model shared by configuration, persistence, runtime, and API layers.
bridges
Package bridges defines the daemon-owned bridge domain models shared by persistence, runtime, and transport layers.
 Package bridges defines the daemon-owned bridge domain models shared by persistence, runtime, and transport layers.
bridgesdk
Package bridgesdk provides the shared provider-runtime substrate for bridge adapters.
 Package bridgesdk provides the shared provider-runtime substrate for bridge adapters.
bundles
bundles/model
cli
Package cli provides the AGH Cobra command tree.
 Package cli provides the AGH Cobra command tree.
cli/docpost
Package docpost transforms raw Cobra-generated markdown into Fumadocs-compatible MDX files with YAML frontmatter.
 Package docpost transforms raw Cobra-generated markdown into Fumadocs-compatible MDX files with YAML frontmatter.
codegen/openapits
codegen/sdkts
config
Package config loads and validates AGH configuration.
 Package config loads and validates AGH configuration.
config/lifecycle
Package lifecycle owns the config-apply lifecycle matrix shared by runtime, API, CLI, web, docs, and codegen checks.
 Package lifecycle owns the config-apply lifecycle matrix shared by runtime, API, CLI, web, docs, and codegen checks.
coordinator
daemon
Package daemon wires the AGH runtime packages into a single long-lived process.
 Package daemon wires the AGH runtime packages into a single long-lived process.
diagnosticcontract
diagnostics
doctor
e2elane
events
Package events owns canonical runtime event names and metadata shared by producers, logs, notifications, and contract tests.
 Package events owns canonical runtime event names and metadata shared by producers, logs, notifications, and contract tests.
extension
Package extension enforces capability grants for extension security checks.
 Package extension enforces capability grants for extension security checks.
extension/contract
extension/protocol
extension/surfaces
Package surfaces defines the static extension resource surface policy.
 Package surfaces defines the static extension resource surface policy.
extensiontest
filesnap
fileutil
Package fileutil provides shared filesystem helpers for AGH components.
 Package fileutil provides shared filesystem helpers for AGH components.
frontmatter
heartbeat
Package heartbeat resolves optional HEARTBEAT.md wake-policy artifacts.
 Package heartbeat resolves optional HEARTBEAT.md wake-policy artifacts.
hooks
Package hooks defines the dependency-free core types for the AGH lifecycle hooks platform.
 Package hooks defines the dependency-free core types for the AGH lifecycle hooks platform.
logger
Package logger configures AGH structured logging.
 Package logger configures AGH structured logging.
mcp
mcp/auth
memory
memory/consolidation
memory/contract
Package contract defines the shared Memory v2 data contract.
 Package contract defines the shared Memory v2 data contract.
memory/controller
memory/extractor
memory/prompts
Package prompts provides explicit, versioned Memory v2 prompt assets.
 Package prompts provides explicit, versioned Memory v2 prompt assets.
memory/provider/local
memory/provider/local/memstore
memory/recall
memory/scan
Package scan provides deterministic Memory v2 pre-write content checks.
 Package scan provides deterministic Memory v2 pre-write content checks.
modelcatalog
network
Package network defines the AGH Network v0 protocol surface shared by the transport, router, and delivery layers.
 Package network defines the AGH Network v0 protocol surface shared by the transport, router, and delivery layers.
network/rules
notifications
notifications/presets
observe
Package observe records global AGH observability data derived from live sessions.
 Package observe records global AGH observability data derived from live sessions.
procutil
Package procutil provides shared process helpers for AGH runtime components.
 Package procutil provides shared process helpers for AGH runtime components.
providerauth
Package providerauth contains provider-auth diagnostics shared by CLI and daemon settings surfaces.
 Package providerauth contains provider-auth diagnostics shared by CLI and daemon settings surfaces.
providerenv
providers
Package providers owns provider authentication classification and probes.
 Package providers owns provider authentication classification and probes.
registry
registry/clawhub
Package clawhub implements the ClawHub registry adapter.
 Package clawhub implements the ClawHub registry adapter.
registry/github
Package github implements the GitHub Releases registry adapter.
 Package github implements the GitHub Releases registry adapter.
resources
Package resources provides the canonical desired-state persistence kernel and typed adapter boundary for extensibility resources.
 Package resources provides the canonical desired-state persistence kernel and typed adapter boundary for extensibility resources.
retry
Package retry provides small context-aware retry and backoff primitives.
 Package retry provides small context-aware retry and backoff primitives.
sandbox
Package sandbox defines execution-sandbox contracts shared by daemon-native providers, session orchestration, and ACP launch plumbing.
 Package sandbox defines execution-sandbox contracts shared by daemon-native providers, session orchestration, and ACP launch plumbing.
sandbox/daytona
Package daytona contains Daytona execution-sandbox provider code.
 Package daytona contains Daytona execution-sandbox provider code.
sandbox/daytona/cmd/agh-daytona-sidecar command
sandbox/local
Package local implements the daemon-host execution sandbox provider.
 Package local implements the daemon-host execution sandbox provider.
sandbox/providertest
Package providertest contains reusable provider conformance checks.
 Package providertest contains reusable provider conformance checks.
scheduler
Package scheduler implements the daemon-owned mechanical task scheduler.
 Package scheduler implements the daemon-owned mechanical task scheduler.
session
Package session orchestrates AGH session lifecycle around ACP-backed agents.
 Package session orchestrates AGH session lifecycle around ACP-backed agents.
session/inputqueue
sessions/ledger
Package ledger materializes read-only forensic session ledgers from events.db.
 Package ledger materializes read-only forensic session ledgers from events.db.
settings
Package settings provides the daemon-facing settings orchestration service.
 Package settings provides the daemon-facing settings orchestration service.
situation
Package situation assembles the bounded runtime context agents need to act.
 Package situation assembles the bounded runtime context agents need to act.
skills
Package skills provides the core types and loading primitives for AgentSkills `SKILL.md` files.
 Package skills provides the core types and loading primitives for AgentSkills `SKILL.md` files.
skills/marketplace
soul
Package soul resolves optional SOUL.md persona artifacts.
 Package soul resolves optional SOUL.md persona artifacts.
sse
Package sse provides shared server-sent event decoding helpers.
 Package sse provides shared server-sent event decoding helpers.
store
Package store provides shared persistence types, validation, and helper primitives.
 Package store provides shared persistence types, validation, and helper primitives.
store/globaldb
store/sessiondb
store/workspacedb
Package workspacedb owns per-workspace SQLite database lifecycle helpers.
 Package workspacedb owns per-workspace SQLite database lifecycle helpers.
subprocess
Package subprocess provides shared subprocess lifecycle primitives for AGH.
 Package subprocess provides shared subprocess lifecycle primitives for AGH.
support
Package support builds daemon-owned support bundles and tracks bundle operations.
 Package support builds daemon-owned support bundles and tracks bundle operations.
task
Package task defines the canonical task-domain models, interfaces, limits, and validation helpers shared by persistence, runtime, and transport layers.
 Package task defines the canonical task-domain models, interfaces, limits, and validation helpers shared by persistence, runtime, and transport layers.
testutil
Package testutil provides shared test helpers for internal packages.
 Package testutil provides shared test helpers for internal packages.
testutil/acpmock
testutil/acpmock/cmd/acpmock-driver command
testutil/e2e
Package e2e provides shared runtime and artifact helpers for daemon-level end-to-end tests.
 Package e2e provides shared runtime and artifact helpers for daemon-level end-to-end tests.
toolruntime
Package toolruntime tracks long-running tool subprocess ownership and scoped interrupts.
 Package toolruntime tracks long-running tool subprocess ownership and scoped interrupts.
tools
Package tools defines canonical Tool Registry contracts.
 Package tools defines canonical Tool Registry contracts.
tools/builtin
transcript
Package transcript assembles canonical replay messages from persisted session events.
 Package transcript assembles canonical replay messages from persisted session events.
update
vault
Package vault owns encrypted daemon-managed secret material.
 Package vault owns encrypted daemon-managed secret material.
version
Package version provides build metadata injected via ldflags.
 Package version provides build metadata injected via ldflags.
workref
Package workref provides tiny shared workspace reference value objects used to pass workspace identifiers and paths through transport and runtime helpers.
 Package workref provides tiny shared workspace reference value objects used to pass workspace identifiers and paths through transport and runtime helpers.
workspace
Package workspace defines workspace domain models, sentinel errors, and resolver contracts used across AGH runtime packages.
 Package workspace defines workspace domain models, sentinel errors, and resolver contracts used across AGH runtime packages.
sdk
examples/secret-guard command
examples/telegram-reference command
go
Package aghsdk provides the public Go SDK for AGH subprocess extensions.
 Package aghsdk provides the public Go SDK for AGH subprocess extensions.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.