Review workspace changes with Codex
codex_reviewInspect uncommitted changes in a workspace. Provides severity-ordered findings and a sessionId to continue the review.
Instructions
Ask Codex to review the uncommitted changes in a workspace (read-only sandbox, no files modified). Returns findings ordered by severity plus a sessionId usable with codex_continue.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cwd | Yes | Absolute path of the workspace to review | |
| focus | No | Optional focus for the review, e.g. "security of the auth module" | |
| model | No | Codex model override | |
| terminal | No | Open a Terminal window streaming live progress (default: env CODEX_MCP_TERMINAL=1) | |
| timeoutMs | No | Max execution time per attempt in ms; auto-resume may add attempts (default: 60 minutes) | |
| writeNotes | No | Persist a markdown summary of this run to <cwd>/.codex-flow/notes/<sessionId>.md (default false). | |
| baselineRef | No | Optional git ref to review from: Codex reviews `git diff <baselineRef>..HEAD` plus current uncommitted changes, so checkpoint/merge commits made since the baseline are covered. | |
| reasoningEffort | No | Reasoning effort override for the selected model |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| diff | Yes | ||
| runId | Yes | ||
| usage | Yes | ||
| errors | Yes | ||
| status | Yes | ||
| stderr | Yes | ||
| aborted | Yes | ||
| liveLog | Yes | ||
| attempts | No | ||
| commands | Yes | ||
| exitCode | Yes | ||
| timedOut | Yes | ||
| warnings | Yes | ||
| notesPath | Yes | ||
| sessionId | Yes | ||
| turnCount | Yes | ||
| attribution | Yes | ||
| fileChanges | Yes | ||
| parseErrors | Yes | ||
| agentMessage | Yes | ||
| resumeReasons | No | ||
| sawCompletion | Yes | ||
| schemaVersion | Yes | ||
| unknownEvents | Yes | ||
| outputTruncated | Yes |