Agent integrations
The repository ships an agent skill and an MCP bridge plugin under .agents/. The skill works in any agent that reads .agents/skills/, such as peen. It tells agents to use the installed wrapper for local work, and to use MCP only for a server that is already running.
Claude Code
claude plugin marketplace add psyb0t/agents
claude plugin install pibox@psyb0t
Claude Code asks for the pibox URL and, if auth is on, the API and MCP tokens. It stores the tokens in your OS keychain.
Codex
codex plugin marketplace add psyb0t/agents
codex plugin add pibox@psyb0t
Installed through the marketplace, the skill is invoked as $pibox:pibox. Codex also picks the skill up with no install in any repository that contains .agents/skills/, where it is invoked as plain $pibox.
OpenClaw
The skill is published to ClawHub on every release:
openclaw skills install @psyb0t/pibox
For MCP clients that only speak local stdio, the @psyb0t/pibox plugin bridges stdio to the server’s MCP endpoint through mcp-remote:
openclaw plugins install clawhub:@psyb0t/pibox
| Variable | Required | Meaning |
|---|---|---|
PIBOX_URL | one of the two | Base URL of a server in API mode, such as http://localhost:8080. The bridge appends /mcp/ |
PIBOX_MCP_URL | one of the two | Full MCP endpoint URL, used as given. Set it for a sidecar MCP server, which serves at its port root, such as http://localhost:8081/. Wins over PIBOX_URL |
PIBOX_MCP_MODE_TOKEN | no | Bearer token, needed only when the server was started with PIBOX_MCP_MODE_TOKEN |
The plugin does not start a server. Start one from the workspace you want to expose, with both tokens set:
PIBOX_DETACH=1 \
PIBOX_API_MODE=1 \
PIBOX_MCP_MODE=1 \
PIBOX_AVAILABLE_MODELS=your-model-id \
PIBOX_API_MODE_TOKEN=your-api-token \
PIBOX_MCP_MODE_TOKEN=your-mcp-token \
pibox
If your MCP client already supports remote streamable HTTP servers, you do not need the bridge. Point the client at $PIBOX_URL/mcp/ with an Authorization: Bearer <token> header, as in MCP mode.
MCP Registry
The image is listed in the MCP Registry as io.github.psyb0t/pibox. The entry in server.json points at docker.io/psyb0t/pibox:latest with the streamable HTTP transport on port 8081, the sidecar placement.