These commands are used by agents — via installed skills or directly from the command line — to communicate with a running monocle session. Each command connects to monocle’s Unix socket, sends a request, prints the response, and exits.
Set the MONOCLE_SOCKET environment variable when the agent’s working directory differs from monocle’s working directory. Without it, commands look for a socket based on the current directory and may not find a running session. Press I in the monocle TUI to see the active socket path.
monocle review status
Check the current review status of the running monocle session.
monocle review status [--json] [--socket PATH]
Flags
| Flag | Description |
|---|
--json | Output the result as structured JSON instead of plain text. |
--socket PATH | Override the Unix socket path. Also reads from MONOCLE_SOCKET. |
Output
Without --json, prints a status string or summary. The status reflects whether feedback is pending, a pause has been requested, or the session is idle.
monocle review get-feedback
Retrieve pending review feedback from the queue.
monocle review get-feedback [--wait] [--json] [--socket PATH]
--wait, the command returns immediately. If no feedback is pending it prints No feedback pending. and exits.
Flags
| Flag | Description |
|---|
--wait | Block until feedback is available. The command does not return until the reviewer submits a review. Used by the /review-plan-wait skill. |
--json | Output the result as structured JSON. |
--socket PATH | Override the Unix socket path. Also reads from MONOCLE_SOCKET. |
monocle review send-artifact
Send content to the reviewer — a plan, architecture document, summary, or any other text — so it appears in the monocle sidebar alongside file diffs.
monocle review send-artifact --title TEXT [--file PATH] [--id ID] [--type EXT] [--wait] [--json] [--socket PATH]
--id, monocle updates the existing entry and shows a diff between the old and new versions.
When --file is not provided, the command reads content from stdin.
Flags
| Flag | Description |
|---|
--title TEXT | (Required) Title displayed in the monocle sidebar. |
--file PATH | Path to the file to submit. When omitted, reads from stdin. |
--id ID | Identifier for the artifact. Use the same ID on subsequent calls to update the content in place. Defaults to the filename when --file is used. |
--type EXT | File extension used for syntax highlighting (e.g. md, go, py, ts). |
--wait | Block until the reviewer responds with feedback. Used by the /review-plan-wait skill. |
--json | Output the result as structured JSON. |
--socket PATH | Override the Unix socket path. Also reads from MONOCLE_SOCKET. |
Reading from stdin
echo "## Plan\n- Step 1\n- Step 2" | monocle review send-artifact --title "My plan" --type md
Reading from a file
monocle review send-artifact --title "Architecture" --file docs/architecture.md --id architecture.md
monocle review add-files
Add one or more files or directories to the current review session so they appear in the monocle diff viewer.
monocle review add-files <paths...> [--json] [--socket PATH]
Arguments
| Argument | Description |
|---|
paths | (Required) One or more file or directory paths to add. Paths are resolved to absolute paths before being sent to monocle. |
Flags
| Flag | Description |
|---|
--json | Output the result as structured JSON. |
--socket PATH | Override the Unix socket path. Also reads from MONOCLE_SOCKET. |
Example
monocle review add-files src/feature.go tests/