Stdiobus

stdio Bus Agentic Orchestration Ecosystem

The kernel of stdio Bus is deliberately minimal: a single-threaded C daemon supervises the worker processes in which agent logic runs.

stdio Bus Portal • Docker Hub

stdio Bus kernel acts as a process supervisor and message router between external clients (IDEs, CLIs, services) and worker processes. It handles NDJSON-framed JSON-RPC messages with session-based routing, while remaining completely agnostic to protocol semantics.

Key Features

• Single-threaded: One event loop using epoll (Linux) or kqueue (macOS)
• No external dependencies: Only libc and POSIX APIs
• Protocol agnostic: Forwards messages unchanged, parsing only routing fields
• Session affinity: Messages with the same sessionId route to the same worker
• Backpressure management: Configurable limits prevent memory exhaustion

Prerequisites

• C11-compliant compiler (GCC 4.9+ or Clang 3.4+)
• Make or CMake 3.10+
• Node.js 18+ (for running example workers)

Binary Releases

Pre-compiled binaries for multiple platforms are available in the /releases directory. Each version contains ready-to-use stdio_bus binaries for different architectures:

Version 2.0.3

Available platforms:

• macOS: darwin-amd64 | darwin-arm64
• Linux: linux-amd64 | linux-arm64 | linux-armv7
• Linux (musl): linux-musl-amd64 | linux-musl-arm64

Verification: SHA256 checksums available at checksums.sha256

Download the appropriate binary for your platform and make it executable:

# Example for Linux AMD64
curl -L -o stdio_bus https://github.com/stdiobus/stdiobus/releases/v2.0.3/linux-amd64/stdio_bus
chmod +x stdio_bus

Docker

Pre-built multi-architecture images available on Docker Hub:

docker pull stdiobus/stdiobus:latest

Supported platforms: linux/amd64, linux/arm64, linux/arm/v7

Available tags: latest, v2.0.3, main, develop

See Docker Hub for complete usage examples and configuration.

Implementations

Embedded stdio_bus runtime for your application process — no external daemon, no Docker, no TCP hop.

Language	Package	Status
Rust	stdiobus	🟩 Available
Node.js	@stdiobus/node	🟩 Available
C++	stdiobus	🟩 Available
Python	stdiobus	🟩 Available
Go	—	Planned

MCP Orchestration

MCP server that connects IDE clients to ACP-compatible agents through stdio Bus: @stdiobus/mcp-agentic

Exposes 8 MCP tools covering agent discovery, session lifecycle, one-shot delegation, and health checks. Supports in-process agents and external worker processes. Includes a Provider Factory API for OpenAI, Anthropic, and Google Gemini with a unified interface, runtime parameter control per session and per prompt, and a defineProvider() contract for custom or private LLM integrations.