Skip to main content
The root command is openlit. Run openlit --help or openlit <command> --help for inline usage at any time.

​
openlit coding

Coding-agent observability for Claude Code, Cursor, and Codex. See the Coding Agents setup guide for the full vendor-by-vendor walkthrough.

​
openlit coding install

Install the per-vendor host plugin manifest. Idempotent - re-running drops prior openlit entries before re-writing, leaving any third-party entries in place.
Where manifests are written:

​
openlit coding launch

Bootstrap the plugin for an agent and exec it - telemetry on from the first turn. Auto-installs the manifest if needed.
Any arguments after -- are forwarded to the agent’s own CLI.

​
openlit coding uninstall

Remove the per-vendor plugin manifests written by install. Best-effort deregisters the plugin from the vendor’s own CLI where applicable. Leaves your shared config alone unless --purge is passed.

​
openlit coding hook

You will almost never run this yourself. The host plugin manifests written by openlit coding install invoke it once per agent event, piping the event payload on stdin.
The hook is crash-isolated: a 5-second hard timeout (~3s reserved for OTLP flush) and it always exits 0 even when telemetry fails - a broken pipeline never blocks your coding session. It never writes to stdout (agents like Claude Code parse stdout for JSON). Set OPENLIT_DEBUG_PAYLOAD_DIR to tee raw payloads for debugging.

​
openlit configure

Write persistent settings to ~/.config/openlit/config.env. See Configuration for the full flag table, precedence, and content-capture modes.

​
openlit doctor

Diagnose the CLI’s setup. Reads the resolved config, TCP-dials the OTLP endpoint (2s timeout), and lists installed vendor plugins.
Exit code 0 means the CLI is wired up (possibly with warnings); 1 means at least one check failed. This is the first thing to run when something isn’t showing up on /agents.

​
openlit version

Print the CLI version and build commit.

​
Reserved (future) commands

The CLI is built to grow into OpenLIT’s full control plane. These command groups are reserved in the codebase and will land in future releases:
These are not available yet. They are documented here only to signal the CLI’s direction - new groups plug in by registering on the root command without breaking the coding-agent integration.