Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.getmonocle.sh/llms.txt

Use this file to discover all available pages before exploring further.

monocle is a terminal UI that runs alongside your AI coding agent. You review diffs in real time as the agent writes code, leave line-level comments, and submit a structured review in one batch. The agent receives your feedback and starts fixing things immediately — like a PR review, but live.

Installation

Install monocle via Homebrew or download a pre-built binary for macOS or Linux.

Quick Start

Register monocle with your agent and start your first review session in minutes.

Agent Setup

Connect monocle to Claude Code, OpenCode, Codex CLI, or Gemini CLI.

Configuration

Customize layouts, diff styles, keybindings, and review formatting.

​
How it works

1

Install monocle

Download monocle and install it on your system with a single command.
2

Register with your agent

Run monocle register to connect monocle to your agent — via MCP tools (default for Claude Code) or skill files (default for other agents).
3

Start reviewing

Run monocle in a separate terminal alongside your agent. Review diffs as they appear, leave comments, and submit.
4

Agent fixes your feedback

Your agent receives the review and addresses each comment. You see the updated diffs and can iterate.

​
Supported agents

monocle works with any agent that supports agent skills or MCP tools, with enhanced push notification support for Claude Code.
AgentIntegration modePush notifications
Claude CodeMCP tools (default) or skillsYes (via MCP channels)
OpenCodeSkills (default) or MCP toolsNo (pull-based)
Codex CLISkills (default) or MCP toolsNo (pull-based)
Gemini CLISkills (default) or MCP toolsNo (pull-based)
Push notifications are currently only supported with Claude Code via experimental MCP channels.