monocle review.
User commands
monocle / monocle run
Start a review session. Opens the TUI in the current terminal.
Override the Unix socket path used for the MCP channel connection. Use this when auto-pairing fails because the agent’s working directory differs from Monocle’s. Also reads from the
MONOCLE_SOCKET environment variable.Add a file or directory to the review session. Repeatable — pass the flag multiple times to include several paths.
Resume the most recent session for this repository without showing a picker. Mutually exclusive with
--resume and --session.Show an interactive session picker to choose which previous session to resume. Mutually exclusive with
--continue and --session.Resume a specific session by its ID. Mutually exclusive with
--continue and --resume.Print the installed version and exit.
monocle register
Install Monocle’s skills for one or more agents. For Claude Code, also installs the MCP channel config for push notifications.
The agent to register. One of
claude, opencode, codex, gemini, or all. If omitted, an interactive picker lets you choose which agents to register.Write to the user-level config directory instead of the current project directory. Use this when you want skills available across all projects rather than just the current one.
| Agent | Skills directory | MCP config |
|---|---|---|
| Claude Code | .claude/skills/ | .mcp.json |
| OpenCode | .opencode/skills/ | — |
| Codex CLI | .codex/skills/ | — |
| Gemini CLI | .gemini/skills/ | — |
monocle unregister
Remove Monocle’s skills and MCP config for one or more agents.
The agent to unregister. One of
claude, opencode, codex, gemini, or all. If omitted, an interactive picker lets you choose.Remove from the user-level config directory instead of the current project directory.
Agent-facing commands
These commands are used by agents (via skills or directly) to interact with a running Monocle session. Each command connects to Monocle’s Unix socket, sends a request, prints the response, and exits.All agent-facing commands accept
--socket PATH or read the socket path from the MONOCLE_SOCKET environment variable. If Monocle is not running, the command exits with a non-zero status and prints an error to stderr.monocle review status
Check the current review status — whether feedback is pending or a pause has been requested.
Override socket path. Also reads from
MONOCLE_SOCKET.Output the status as structured JSON instead of plain text.
monocle review get-feedback
Retrieve pending review feedback from the queue. If multiple reviews have accumulated, they are all delivered together in one response.
Override socket path. Also reads from
MONOCLE_SOCKET.Block until feedback is available instead of returning immediately. Used by the
/get-feedback-wait skill and the pause flow — the command holds the connection open until the reviewer submits a review.Output feedback as structured JSON.
monocle review send-artifact
Send content (a plan, architecture doc, summary, or any text) to Monocle for the reviewer to see. Content appears alongside file diffs in the sidebar and supports line-level comments.
Reads content from --file or from stdin if --file is not provided.
Title for the content as displayed in Monocle’s sidebar. Required.
Path to the file to submit. If omitted, content is read from stdin.
Identifier for the content. When you send an update with the same
--id, it replaces the previous version in the sidebar rather than creating a duplicate. Defaults to the basename of --file if not set.File extension for syntax highlighting (e.g.
md, go, py, ts). Monocle uses this to render the content with the correct language highlight.Block until the reviewer responds with feedback. Used by the
/review-plan-wait skill. The command submits the artifact, then opens a second connection and waits for the next submitted review.Output the response as structured JSON.
Override socket path. Also reads from
MONOCLE_SOCKET.monocle review add-files
Add one or more file or directory paths to the current review session. Useful for including files that Monocle didn’t pick up automatically.
One or more file or directory paths to add. Paths are resolved to absolute paths before being sent to Monocle.
Override socket path. Also reads from
MONOCLE_SOCKET.Output the response as structured JSON.
Socket override
Monocle auto-pairs with agents using a socket path derived from the working directory. If auto-pairing fails (for example, because the agent runs in a different directory), override the socket path explicitly:I in the TUI to see the current socket path and how many agents are connected.
Keybindings
Complete reference for all TUI keybindings.
Configuration
Full config schema with all options and defaults.