Repository navigation
Releases: aipmer/codex-grok-task-bridge
Release list
v0.4.0 — Multi-agent callers
Multi-agent callers
- Adds isolated, scoped caller identities for trusted local Codex, Claude Code, and Cursor clients.
- Tasks are private to their owner; create idempotency is namespaced by caller.
- Adds a credential-free stdio-to-HTTP MCP proxy plus installation, backup, and rollback guidance.
Grok Bot remains the sole executor. Cross-agent task delegation and additional executors are intentionally out of scope.
Before enabling multiple callers, configure the BRIDGE_CLIENTS Worker Secret with SHA-256 token digests as documented in docs/multi-agent-callers.md.
v0.3.0 — Codex continuation
Codex continuation
- Adds the optional
grok-task-continuationSkill for per-task continuation after a Grok bridge job reaches a terminal state. - Documents the scoped heartbeat flow: poll only known task IDs, review
get_taskevidence and limitations, then continue the originating Codex request under existing authority. - Clarifies that this does not add a Worker or Grok Bot callback into arbitrary Codex conversations; external writes still require new authority.
Verification
npm run checknpm testnpm run build- Skill structure validation
v0.2.0 — Execution Safety
Highlights
- Fenced leases with opaque lease tokens and monotonic generations prevent stale executors from reporting progress or completing a reclaimed task.
- Execution-attempt audit history, delayed retry backoff, cooperative cancellation, and idempotency conflict detection improve recovery after network or lease failures.
- Completion is replay-safe when the task state commits but the client loses the response.
- The bridge remains read-only: unregistered task types and write-capable operations are rejected.
- Added global Codex MCP setup documentation for reuse across new desktop, CLI, and IDE conversations on one host.
Upgrade note
Grok executors must pass the lease_token returned by claim_next_task to lease renewal, progress, result-attachment, completion, and failure calls. Update any Routine instruction before using v0.2.0.
Verification
npm run check, npm test, npm run build, local end-to-end smoke testing, and staging protocol checks passed.
v0.1.0 — Codex × Grok Bot MCP Task Bridge
Initial public release: an authenticated MCP task bridge for Codex and Grok Bot with async jobs, leases, idempotency, scoped OAuth, and Cloudflare Workers/D1/R2. Hermes integration is documented as a future roadmap item.