README
¶
agentbus
Agentbus is a local generic job service for backend CLIs. It stores identified jobs, supervises their process groups, and exposes a small JSON-RPC interface.
Version 0.13.1 serves protocol version 3. The published contract is docs/protocol.md. Operator details, including the required state-root break for this release, are in docs/operations.md.
CLI
agentbus version [--json]
agentbus serve [--foreground]
agentbus status [--job <id>] [--tag <key=value>] [--state <state>] [--workspace-key <key>] [--json]
agentbus transcript --job <id> [--kind <kind>] [--since <timestamp>] [--since-ordinal <n>] [--last <n>] [--limit <n>] [--json]
agentbus result --job <id> [--json]
agentbus cancel --job <id> [--json]
Job submission uses the typed job.submit protocol method. There is no CLI submit command.
Set AGENTBUS_STATE_ROOT to select daemon state. Otherwise Agentbus uses $XDG_STATE_HOME/agentbus or ~/.local/state/agentbus.
Packages
The Go client package is github.com/charlesnpx/agentbus/client. The engine package is github.com/charlesnpx/agentbus/engine. Backend adapter requirements are documented in docs/adapters.md.
Development
go build ./...
go test ./... -count=1
Directories
¶
| Path | Synopsis |
|---|---|
|
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. |
|
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. |
|
adapter/cursorcli
Package cursorcli adapts Cursor's ACP stdio endpoint to the agentbus engine.
|
Package cursorcli adapts Cursor's ACP stdio endpoint to the agentbus engine. |
|
adapter/internal/cliadapter
Package cliadapter adapts backend CLI streams to engine sessions.
|
Package cliadapter adapts backend CLI streams to engine sessions. |
|
adapter/internal/duplex
Package duplex provides a small supervised JSONL duplex process runtime for adapter drivers.
|
Package duplex provides a small supervised JSONL duplex process runtime for adapter drivers. |
|
internal
|
|
|
daemonlaunch
Package daemonlaunch starts foreground agentbus daemon children with a private readiness handshake.
|
Package daemonlaunch starts foreground agentbus daemon children with a private readiness handshake. |
|
jcs
Package jcs renders JSON using RFC 8785.
|
Package jcs renders JSON using RFC 8785. |
|
jobstore
Package jobstore persists version-3 jobs and their immutable replay bindings.
|
Package jobstore persists version-3 jobs and their immutable replay bindings. |
|
protocol
Package protocol defines wire types and version negotiation for agentbus.
|
Package protocol defines wire types and version negotiation for agentbus. |
|
schema
Package schema validates JSON documents against optional inline JSON Schema.
|
Package schema validates JSON documents against optional inline JSON Schema. |
|
service
Package service exposes the transport and lifecycle for the version-3 agentbus daemon, including its complete job wire surface.
|
Package service exposes the transport and lifecycle for the version-3 agentbus daemon, including its complete job wire surface. |
Click to show internal directories.
Click to hide internal directories.