README.md

codex-lmnr

Wrapper for Codex CLI that sends OpenTelemetry traces to Laminar.

Setup

bun install

Set your Laminar API key:

export LMNR_PROJECT_API_KEY="your-api-key"

Usage

bun run index.ts [codex args...]

To use local compaction instead of remote:

bun run index.ts --disable remote_compaction

With debug logging:

CODEX_LMNR_DEBUG=1 bun run index.ts

What it traces

• Each turn (user message -> assistant response)
• Tool calls as child spans
• Token usage and costs
• /compact operations (local and remote)

Environment variables

Variable	Description
LMNR_PROJECT_API_KEY	Laminar API key (required)
CODEX_BIN	Path to codex binary (default: codex)
CODEX_LMNR_DEBUG	Enable debug logging to log/codex-lmnr.log