codex-collab CLAUDE.md

codex-collab CLAUDE.md is an instructions file for coding agents from Kevin7Qi/codex-collab. It costs 727 tokens per session, scanned A, original, MIT.

Instructions for developing and using codex-collab, a command-line tool that connects Claude with Codex for coding tasks. It documents the project's commands, files, dependencies, and internal design.

In plain words
What is it for?
Use it when developing codex-collab, troubleshooting its command-line behavior, or working on threads, approvals, questions, events, and protocol handling.
Why use it?
It gives contributors a shared reference for changing the tool without having to rediscover how its parts work.

Instructions file

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/kevin7qi/codex-collab/claude-md
Clone the repo
git clone --depth 1 https://github.com/Kevin7Qi/codex-collab

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for codex-collab CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/kevin7qi/codex-collab/claude-md.svg)](https://agentmods.dev/instructions/kevin7qi/codex-collab/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/kevin7qi/codex-collab/claude-md"><img src="https://agentmods.dev/badge/instructions/kevin7qi/codex-collab/claude-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 727 This file is loaded in full into every session.
When invoked 727 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00727 $0.00727
Opus 5 $0.00364 $0.00364
Sonnet 5 $0.00145 $0.00145
Haiku 4.5 $0.00073 $0.00073

Measured 4d ago against content hash 62dbf351fd84, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

codex-collab CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 53 lines

How it starts

The opening of the file, as written. The whole thing — 53 lines — stays where its author put it; the contents beside it link to each section on GitHub.

codex-collab

CLI tool for Claude + Codex collaboration via the Codex app server JSON-RPC protocol.

Stack: TypeScript, Bun, OpenAI Codex CLI (app server protocol)

Development

./install.sh --dev    # symlink for live iteration
bun run src/cli.ts --help
codex-collab health

Key Files

File Purpose
src/cli.ts CLI router, argument parsing, signal handlers
src/client.ts JSON-RPC client for Codex app server (spawn, handshake, request routing)
src/commands/ CLI command handlers (run, review, threads, kill, config, approve)
src/threads.ts Thread index, run ledger, short ID mapping
src/turns.ts Turn lifecycle (runTurn, runReview), event wiring
src/events.ts Event dispatcher (progress lines, log writer, output accumulator)
src/approvals.ts Approval handler abstraction (auto-approve, interactive IPC)
src/questions.ts Ask-channel mailbox (Codex asks mid-turn via ask, fail-open on timeout; markers, temp-space mailbox)
src/types.ts Protocol types (JSON-RPC, threads, turns, items, approvals)
src/config.ts Configuration constants, workspace resolution
src/broker.ts Shared app-server lifecycle (connection pooling)
src/broker-client.ts Socket-based client for connecting to the broker server
src/broker-server.ts Detached broker server process (multiplexes JSON-RPC between clients and app-server)
src/process.ts Process spawn/lifecycle utilities
src/lock.ts Advisory file locks (sync/async, single-winner stale breaking)
src/git.ts Git operations (default-branch detection for reviews)
src/skill.ts Installed-skill rendering (embedded SKILL.md source), drift detection, unified diff
src/update.ts Release checking, update notices (skill sync / update commands live in src/commands/update.ts)
SKILL.md Claude Code skill definition

Dependencies

  • Runtime: Bun, codex CLI (codex app-server)

Read the full file on GitHub · 53 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 53 lines · 727 tokens per session scan A 62dbf351fd84

Subscribe to this mod's changes

codex-collab CLAUDE.md is an instructions file published in the GitHub repository Kevin7Qi/codex-collab (95 stars, last pushed 14d ago), licensed MIT. It adds 727 tokens to every session, about $0.0036 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.