New in v1.3.1 · Plugin system

Run Claude Code and Codex on models from other coding agents.

CCBUD now hosts local sidecar plugins. A plugin can reuse a coding agent’s existing CLI login, speak a standard protocol, and appear as an ordinary service. The Grok reference plugin needs an eligible Grok subscription but no separate API key or per-token API billing; xAI limits and terms still apply.

Download v1.3.1 Explore PR #27

Local gateway Open source macOS · Windows · Linux

Reuse loginCCBUD receives status, not tokens

Health-gatedSidecar /healthz passed

Two familiesClaude + Codex routing

The Plugins panel combines manifest declarations with live control-plane state.

v1.3.1Released July 11, 2026 Grok / xAIFirst reference plugin ccbud-plugin/1Open plugin contract

The one idea

A running plugin is just an ordinary local provider.

CCBUD keeps the host generic. It translates client protocols and manages the process; each plugin handles only its vendor’s login and API shape.

01 Clients Claude Code
Codex Familiar model names

02 CCBUD gateway Translate & route 127.0.0.1

03 Sidecar plugin Standard protocol in Vendor details out

04 Vendor Grok / xAI Existing CLI session

Reuse, don’t re-authenticate.

The reference plugin reads the login created by the official Grok CLI. CCBUD receives login metadata, not its access or refresh tokens.

Lifecycle you can trust.

CCBUD selects the platform binary, assigns a free localhost port, waits for health, and auto-starts the active service next launch.

Routing that understands the client.

Claude and Codex get family-aware model lists and primary/fast tier mapping through the same gateway.

From Git to ready

Install once. Enable when you need it.

The host owns the repetitive work without hiding it. Building, starting, health-check, stopped, and failed states stay visible and under your control.

1
Add a source you trust
A Git source is cloned and runs its manifest build command with your user permissions. A local folder installs an already built plugin.
2
Pass the sidecar health check
Enable starts the process and routes only after /healthz returns 200. This checks process readiness—not login or vendor availability.
3
Install creates the service
Installation adds the service; Enable only starts or stops its sidecar. Status, updates, and declared actions stay in Plugins.

Read the plugin system guide

Grok reference plugin: sign in with the official Grok CLI first. The plugin reads and may cache its OAuth tokens; refresh can require signing in again. Your Grok plan, quotas, and xAI terms still apply.

Git import needs Git and the plugin’s declared build toolchain; Grok Build currently needs Go and make.

CCBUD Add from Git dialog with the Grok Build repository URL entered — !Git install executes source.build without a sandbox or signature check. “Trusted” identifies an official ccbud source, not an independent security audit.

Tested end to end

One bridge. Two client families. Gateway hops visible.

PR #27 tested both client families. Below, a Codex → Grok capture is paired with a sanitized Claude-family gateway view.

Codex Desktop running through the Grok Build plugin while CCBUD monitors requests — **Codex stays in the client you know.**Text conversations and streaming responses reach Grok through the plugin’s OpenAI Responses endpoint.Current reference-plugin limit: Codex shell and collaboration tools are not forwarded yet. *PR #27 test capture*

An open contract

Plugins describe themselves. CCBUD stays generic.

Drop another compatible plugin into ~/.ccbud/plugins and the host needs no vendor-specific code. The manifest drives models, protocol, lifecycle, icon, updates, and even buttons or forms.

ManifestIdentity, binaries, models, protocol, source, and declarative UI.

Control planeHealth, status, auth state, and plugin-defined actions.

Data planeA standard inference endpoint and the plugin’s model catalog.

Read the contract View Grok reference plugin

plugin.json ccbud-plugin/1

{
  "spec": "ccbud-plugin/1",
  "id": "grok-build",
  "runtime": {
    "args": ["serve", "--port", "{port}"]
  },
  "endpoint": {
    "protocol": "openai-responses",
    "healthPath": "/healthz"
  },
  "modelMapping": {
    "primary": "grok-4.5",
    "light": "grok-build"
  },
  "ui": {
    "actions": [/* link · call · form */]
  }
}

Health check passed 127.0.0.1:{port}

Beyond plugins

Still the control center for your coding CLIs.

The new plugin layer sits on top of the routing, monitoring, history, and reversible configuration workflow already built into CCBUD.

Monitor

See every gateway hop.

Follow request streams, latency, model rewrites, translated bodies, headers, gateway events, and upstream errors.

Services

Switch once. Route the next request.

Manage presets and custom endpoints, test connections, map stable aliases, and change the active service without shell edits.

Conversations

Turn sessions into memory.

Search Claude Code projects and Codex sessions, inspect tool calls and diffs, then export readable JSONL or HTML.

Local

Local, visible, reversible.

The gateway binds to 127.0.0.1, but loopback is not a sandbox. Config edits are reversible; CCBUD and installed plugin code can be audited, while the selected vendor remains external.

Available now · v1.3.1

Give your coding CLIs a bigger model map.

Download CCBUD for macOS, Windows, or Linux, then add the Grok reference plugin from Git—or build the next adapter yourself.

Open v1.3.1 release View source

macOSApple silicon · Intel Windows.exe · .msi LinuxAppImage · deb · rpm

Install with Homebrew

brew install --cask ccbud/tap/ccbud