agentbus

module

v0.0.3 Latest Latest Go to latest Published: Jul 9, 2026 License: MIT

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/charlesnpx/agentbus

Links

Open Source Insights

README ¶

agentbus

A local agent-execution service: one daemon multiplexing concurrent sessions/turns/jobs across backend CLIs (Claude Code, Codex), plus an importable engine. agentbus is agent-agnostic — it has zero delegation opinions. It publishes three consumable surfaces:

Wire protocol (docs/protocol.md) — JSON-RPC 2.0, newline-delimited, over a Unix socket. Versioned, with a documented state machine, result-size semantics, and trust model.
Go client package (github.com/charlesnpx/agentbus/client) — typed wrapper over the socket, with daemon autostart and reconnect.
Go engine package (github.com/charlesnpx/agentbus/engine) — the same core, importable for embedded (daemonless) use and tests.

agentbus also defines a generic TurnPolicy mechanism (prologue, contract validation, bounded retry, compliance stamping) with no built-in policy opinions — clients such as delegate supply the concrete contracts.

This repo is currently private and pre-release. See ~/tmp/agent-server-delegate-plan.md (or the equivalent planning doc) for the full design and delivery plan.

Roadmap / v0.2

stop-review-gate: a Claude Code Stop-hook client of agentbus that gates a turn via turn.start with an ALLOW/BLOCK shape contract plus policy.validate, replacing the vendor openai-codex plugin's stop-review gate (not replicated in v1). Until this lands, delegate setup reports stop-review-gate: not available (planned v0.2).

Directories ¶

Path	Synopsis
client Package client provides the Go socket client and daemon autostart surface for agentbus.	Package client provides the Go socket client and daemon autostart surface for agentbus.
cmd
agentbus command Package main provides the agentbus command-line entry point.	Package main provides the agentbus command-line entry point.
engine Package engine provides the importable core for agentbus job state, persistence, leases, supervision, results, and logs.	Package engine provides the importable core for agentbus job state, persistence, leases, supervision, results, and logs.
adapter/claudecli Package claudecli adapts the Claude Code CLI to the agentbus engine backend interface.	Package claudecli adapts the Claude Code CLI to the agentbus engine backend interface.
adapter/codexcli Package codexcli adapts the Codex CLI to the agentbus engine backend interface.	Package codexcli adapts the Codex CLI to the agentbus engine backend interface.
internal
protocol Package protocol defines wire types and version negotiation for agentbus.	Package protocol defines wire types and version negotiation for agentbus.
served Package served exposes the JSON-RPC daemon surface over the agentbus engine.	Package served exposes the JSON-RPC daemon surface over the agentbus engine.

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL