Skip to main content
monocle connects to your agent by installing skills — small instruction files that tell the agent how to check review status, retrieve feedback, and submit content for review. Run monocle register to install them.

​
Register monocle with your agent

The register command installs skills into your agent’s skill directory and, for Claude Code, writes the MCP channel config for push notifications. 
monocle register          # interactive picker
monocle register claude   # or: opencode, codex, gemini, all
Add --global to install at the user level instead of the current project: 
monocle register claude --global
AgentSkills directoryMCP config
Claude Code.claude/skills/.mcp.json
OpenCode.opencode/skills/—
Codex CLI.codex/skills/—
Gemini CLI.gemini/skills/—

​
Set up each agent

​
Register via CLI

monocle register claude
This installs skills into .claude/skills/ and writes the MCP channel config to .mcp.json for push notifications.

​
Enable push notifications

Claude Code supports MCP channels, which deliver your review feedback directly into the agent’s context the moment you submit — no polling needed. Start Claude Code with the channel flag to enable this:
claude --dangerously-load-development-channels plugin:monocle@monocle
The --dangerously-load-development-channels flag is required during the channels research preview.
If you start or restart monocle while Claude Code is already running, the MCP channel may need to reconnect. Type /mcp in Claude Code and select monocle to reconnect.

​
Alternative: plugin marketplace

You can also install monocle through Claude Code’s plugin system:
/plugin marketplace add josephschmitt/monocle
/plugin install monocle@monocle

​
Verify the connection

Start monocle in a terminal alongside your agent: 
monocle
Press I in the TUI to see the socket path and confirm your agent is connected.