onpath × Cl Claude Code integration

Monitor Claude Code,
locally.

Wrap claude with onpath and monitor each session you run through it. Detect stuck loops, get a recovery prompt, and let Claude Code inspect local findings over read-only MCP.

Get started Read the docs

Works with the Claude Code CLI from Anthropic · stable

zsh — Claude Code command walkthrough

# one prefix — Claude Code runs exactly as normal

$ onpath run -- claude "refactor the request handler"

↳ illustrative session · local recording active

# onpath watches the stream and flags stuck loops

⚠ repeated-file-edit · 4× · b7d2·31 · recovery prompt ready

# configure and verify read-only MCP

$ onpath install claude --workspace .

$ claude mcp get onpath

What onpath catches in Claude Code

Repeated failures

Same test, same error, on repeat — caught by failure signature.

warn

Edit loops

The same path edited repeatedly without a successful command.

warn

No progress & time budget

Configured session budgets crossed without successful progress.

warn

How onpath works with Claude Code

Three steps. Nothing changes about how Claude Code runs.

onpath sits between you and the claude CLI — observing, recording, and reporting without altering the agent's behavior.

STEP 01

Wrap the command

Prefix any Claude Code invocation. onpath spawns it as a child process and watches the stream.

$ onpath run -- claude

STEP 02

Detect locally

Commands, exits, and edits stream to local SQLite. Detectors flag stuck patterns in real time.

→ .onpath/events.sqlite

STEP 03

Feed back over MCP

Install the read-only MCP server so Claude Code can read its own findings and recovery prompt.

$ onpath install claude --workspace .

Read-only MCP

Claude Code can inspect local evidence — and cannot act through onpath.

The onpath MCP server exposes discovered projects, recent sessions, findings, reports, Work summaries, and deterministic recovery prompts. It has no tool that runs commands, edits files, or changes policy.

Active findingsOpen detections with severity, signature, and repeat count.

Recovery promptA concrete next step Claude Code can act on to break the loop.

Read-only by designNo write surface — onpath only answers questions about the session.

Claude Code · MCP

# configure and verify the server

$ onpath install claude --workspace .

$ claude mcp get onpath

# implemented read-only tools

onpath_list_findings

onpath_get_recovery_prompt

Compatibility

Claude Code support at a glance.

onpath wraps the claude CLI on macOS and Linux. Everything runs locally — no agent API keys are shared with onpath.

Invocationonpath run -- claude

Event capturecommands · exits · edits · timings

MCP serveronpath install claude --workspace .

Data handlinglocal SQLite · sync opt-in

Statusstable

More integrations

onpath works with your whole agent stack.

Use the same prefix and the same dashboard across every coding agent on your team.

C Codexonpath run -- codex Cu Cursor Agentonpath run -- cursor-agent O OpenCodeonpath run -- opencode

Put Claude Code on path.

Local-first. Open-core. Two minutes to install and one prefix to start.

$onpath run -- claude

Get started Read the docs