Skip to content

v0.2.2 — OpenAI Codex Onboarding

Choose a tag to compare

View all tags
@marmar9615-cloud marmar9615-cloud released this 28 Apr 04:30
· 55 commits to main since this release
v0.2.2
38a86e9
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

v0.2.2 — OpenAI Codex onboarding

Date: 2026-04-27
Status: Stable, additive release on top of v0.2.1. Same protocol,
same code, same safety story — better onboarding for OpenAI Codex
users, plus client-neutral docs.

AgentBridge already worked with OpenAI Codex at the protocol level
because the bundled MCP server speaks stdio and Codex can launch
any stdio MCP server. This release closes the onboarding gap: a
dedicated Codex setup doc, copy-pasteable config.toml snippets, an
AGENTS.md for any AI coding agent looking at the
repo, an experimental local plugin skeleton, and an updated mcp-config
CLI command that emits Codex configs alongside the existing ones.

Headline changes

  • Codex setup is one command. codex mcp add agentbridge -- npx -y @marmarlabs/agentbridge-mcp-server registers the AgentBridge server
    in Codex.
  • config.toml blocks for global and project-scoped Codex. Drop
    the same six lines into ~/.codex/config.toml (every Codex session)
    or .codex/config.toml (one repo only).
  • agentbridge mcp-config is now multi-client. The CLI prints
    Codex CLI / Codex config.toml / Claude Desktop / Cursor / raw
    stdio snippets in one go.
  • AGENTS.md lands at the repo root — short, model-neutral, sits
    next to the deeper Claude-focused CLAUDE.md for any agent reading
    the code.
  • No behavior change. Same MCP tools, same confirmation tokens,
    same origin pinning, same loopback-only default, same audit
    redaction, same simulated destructive demo actions.

What's new

Documentation

  • docs/codex-setup.md — full walkthrough:
    three setup options (CLI, global config, project-scoped),
    demo-app pairing, prompt suggestions, troubleshooting, safety
    reminders, links into the rest of the docs.
  • docs/mcp-client-setup.md —
    restructured to be client-neutral with sections for OpenAI Codex,
    Claude Desktop, Cursor, and custom clients, plus a "Safety
    expectations for all clients" block that names the invariants
    enforced regardless of which client is talking to the server.
  • AGENTS.md — model-neutral working notes
    (project summary, layout, core commands, safety invariants, release
    rules, how-to-add-a-new-MCP-client). Sibling to
    CLAUDE.md, which stays as the deeper
    Claude-Code-specific reference.
  • Root README.md gained a "Works with MCP
    clients" subsection in the wiring section, a Codex one-liner, a
    Cursor JSON snippet, and an AGENTS.md row in the docs table.

Examples

  • examples/codex-config/ —
    copy-pasteable config.global.toml, config.project.toml, and a
    README that explains when to use which.
  • examples/codex-plugin/ —
    experimental local Codex plugin skeleton:
    .codex-plugin/plugin.json, .mcp.json, and
    skills/agentbridge/SKILL.md. Not a published plugin — treat
    it as illustrative; the supported flow is docs/codex-setup.md.
  • examples/mcp-client-config/
    README gained a Codex section and standardized JSON snippets on
    npx -y so first-run installs don't prompt.

CLI

  • agentbridge mcp-config now prints, in this order:
    • raw stdio command (any MCP-compatible client)
    • OpenAI Codex CLI one-liner (codex mcp add agentbridge ...)
    • OpenAI Codex ~/.codex/config.toml block
    • Claude Desktop JSON
    • Cursor / generic MCP JSON
    • Local checkout (node ./apps/mcp-server/dist/index.js)
    • Safety reminder (loopback default + confirmation token reminder)
  • New CLI test
    (packages/cli/src/tests/cli.test.ts)
    asserts each block is present in the output.

Per-package READMEs

The @marmarlabs/agentbridge-mcp-server and
@marmarlabs/agentbridge-cli READMEs got new Codex setup sections.
The other four publishable READMEs (core, sdk, scanner,
openapi) updated their Status blocks to describe v0.2.2 as the
Codex-onboarding release for consistency.

What did not change

  • No protocol behavior, schema, or build-output changes.
  • No safety invariant changes — confirmation gate, origin pinning,
    URL allowlist, audit redaction, and simulated destructive demo
    actions are byte-for-byte the same as v0.2.1.
  • @marmarlabs scope unchanged.
  • All 86 existing tests still pass; the new mcp-config test brings
    the count up.
  • Workspace dep ranges remain ^0.2.0 — 0.2.2 satisfies the range,
    no consumer migration required. v0.2.0 and v0.2.1 remain functional
    on npm.

Setup commands users will see

OpenAI Codex CLI (one-liner):

codex mcp add agentbridge -- npx -y @marmarlabs/agentbridge-mcp-server

OpenAI Codex ~/.codex/config.toml:

[mcp_servers.agentbridge]
command = "npx"
args = ["-y", "@marmarlabs/agentbridge-mcp-server"]
startup_timeout_sec = 20
tool_timeout_sec = 60
enabled = true

Same server, same safety story — also wired up for Claude Desktop,
Cursor, and custom MCP clients via
docs/mcp-client-setup.md.

Reporting issues

Assets 2
Loading