Imported from mieko/codex-bridge (AGENTS.md). Install upstream with npx skills add mieko/codex-bridge. Copyright stays with the author.

Codex Bridge source guidance

Name: codex-bridge
Author: mieko

Codex Bridge is a small Crystal library for delivering trusted caller instructions and explicitly untrusted attachments to an existing local Codex Desktop task. Keep it independent of the products that use it.

Every delivery explicitly selects steer or queue; the library has no policy default.
queue supports structured untrusted attachments. Active steer is trusted-input-only until the Desktop follower API exposes an equivalent injection seam; it must fail rather than silently queue.
Positive complete-history evidence may prove acceptance. Absence never proves rejection.
Keep lifecycle state sparse: runtime, turn identity/status, and user-message client IDs only.
The library owns Desktop transport, owner discovery, lifecycle validation, submission, and stable-ID reconciliation. Callers own queues, persistence, retries, supervisors, and completion.
Never log or report trusted instructions or untrusted attachment bodies.
Prefer causal protocol tests over source-shape assertions.

Keep handwritten Crystal at 100 columns or fewer. Run:

crystal tool format --check src spec
crystal spec --warnings=all --error-on-warnings

{ "ocm": "1", "id": "mieko-codex-bridge-codex-bridge", "kind": "skill", "name": "codex-bridge", "description": "Codex Bridge is a small Crystal library for delivering trusted caller instructions and explicitly untrusted attachments to an existing local Codex Desktop task. Keep it independent of the products that use it.", "publisher": "mieko", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "github-agents" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Codex Bridge is a small Crystal library for delivering trusted caller instructions and explicitly untrusted attachments to an existing local Codex Desktop task. Keep it independent of the products that use it." ], "primary": false, "metadata": { "source": { "provider": "github-agents", "repository": "https://github.com/mieko/codex-bridge", "path": "AGENTS.md", "ref": "908fa9e55305a7d081e551b68ec09c4ec341e62f", "url": "https://github.com/mieko/codex-bridge/blob/908fa9e55305a7d081e551b68ec09c4ec341e62f/AGENTS.md", "key": "mieko/codex-bridge/AGENTS.md" } }, "instructions": "# Codex Bridge source guidance\n\nCodex Bridge is a small Crystal library for delivering trusted caller instructions and explicitly\nuntrusted attachments to an existing local Codex Desktop task. Keep it independent of the products\nthat use it.\n\n- Every delivery explicitly selects `steer` or `queue`; the library has no policy default.\n- `queue` supports structured untrusted attachments. Active `steer` is trusted-input-only until the\n Desktop follower API exposes an equivalent injection seam; it must fail rather than silently queue.\n- Positive complete-history evidence may prove acceptance. Absen", "cost": { "context_tokens": 300 } }

codex-bridge

About

Codex Bridge source guidance

Use it

Manifest

Reviews