Skip to main content

​
Overview

The Codex plugin traces every local OpenAI Codex CLI session: each turn becomes a full trace with its LLM calls and tool executions, sent to Laminar.

​
Install

1

Run the installer

The CLI logs you in (browser device flow), lets you pick the Laminar project that should receive your Codex traces, mints a project API key named after the plugin and your machine, writes it to ~/.config/lmnr/codex-plugin.json, and installs the plugin through Codex’s native plugin marketplace.
Pick a dedicated project for coding-agent traces so they don’t mix with your application’s traces. The setup is global and directory-independent: it never touches .lmnr/project.json or your .env.
2

Restart Codex

Codex loads plugins at startup, so restart it to activate the plugin.
3

Use Codex as usual

Every turn becomes a trace in the project you picked. Open the Laminar dashboard to watch them land in realtime.
Self-hosting Laminar? The same command works against your instance: pass your frontend URL (the auth issuer) and your API URL, including the API port:

​
Manual install

If you’d rather not use lmnr-cli, install the plugin with Codex’s plugin commands and create the config file yourself:
Then create ~/.config/lmnr/codex-plugin.json with a project API key. Get one from the Laminar dashboard under Settings → Project API Keys (create a dedicated key so it’s clear it belongs to the plugin):
~/.config/lmnr/codex-plugin.json
projectApiKey is required. baseUrl is optional and defaults to https://api.lmnr.ai; self-hosters set it to their instance’s API URL (for example http://localhost:8000).

​
Configure the Codex plugin

The plugin reads its config from ~/.config/lmnr/codex-plugin.json, written by lmnr-cli plugin add codex:
The environment variables LMNR_PROJECT_API_KEY and LMNR_BASE_URL override the file when set, which is handy for CI or a shell you already have configured. Traces are attributed to the identity from lmnr-cli login when present; set LMNR_USER_ID to override the user id attached to traces.

Claude Code

Trace Claude Code sessions with a one-command plugin.

OpenCode

Trace OpenCode coding agent sessions.

Pi

Trace Pi coding agent sessions with a one-command extension.

OpenAI

Trace the OpenAI SDK directly in TypeScript and Python.

OpenAI Agents SDK

Trace agent runs, handoffs, and tool calls.

All integrations

Browse every provider, framework, coding agent, and browser integration Laminar supports.