@mindbridgeio/codex
v0.3.7
Published
MindBridge MCP and lifecycle hooks for Codex.
Readme
@mindbridgeio/codex
MindBridge MCP tools and lifecycle hooks for Codex, using durable OAuth.
npx -y @mindbridgeio/codex@latest setupThe command configures an OAuth-enabled HTTP MCP server, starts Codex’s MCP
login, then signs lifecycle hooks in through the system keychain. It uses
https://memory.ifelse.io by default; pass --server-url https://… or set
MINDBRIDGE_MCP_SERVER_URL for a nonsecret server override.
npx -y @mindbridgeio/codex@latest auth status
npx -y @mindbridgeio/codex@latest auth logout
npx -y @mindbridgeio/codex@latest doctorNo bearer token is placed in Codex configuration, command arguments, or an environment variable. A keychain is required; setup fails safely when one is unavailable.
Setup validates the server, Codex CLI, and keychain before changing config. If
MindBridge is temporarily unavailable, hooks remain non-blocking and replay
redacted pending events from a bounded local outbox. doctor --json reports
MCP configuration, lifecycle OAuth, and outbox health. Codex requires installed
hooks to be reviewed in /hooks after their definition changes.
New sessions are tagged automatically from Codex's working directory. Git repositories use a credential-free remote identity; non-Git directories use a private install-scoped local identity. Recall prefers the current project and then fills from the wider MindBridge workspace.
