Agent Review Tool

Review code with terminal-based AI agents without leaving VS Code.

Agent Review lets you attach comments to editor selections, organize feedback by file, and send structured notes directly to Codex CLI or Claude Code in the integrated terminal. It also tracks supported agent lifecycle events and can notify you when an agent needs input or finishes a task.

Features

Add review comments to selected text or the current line.
Edit, delete, copy, or send individual comments.
Delete, copy, send, expand, or collapse all comments in the current file.
Choose the target Codex CLI or Claude Code terminal before sending.
Launch Codex CLI and Claude Code from the Terminal profile menu.
Restore review comments after reloading the workspace.
Open Markdown preview beside the source document.
Show agent status in the VS Code status bar.
Show local macOS notifications for waiting and completed agent tasks.

Requirements

VS Code 1.96 or later.
Codex CLI or Claude Code installed and available on your PATH, unless an absolute command path is configured.
A trusted workspace is required before Agent Review can install notification hooks.
Native system notifications are currently available on macOS. VS Code notifications are used as a fallback.

Getting started

1. Start an agent terminal

Open a folder or workspace in VS Code. From the integrated terminal's profile menu, choose Codex or Claude Code.

The default commands are:

Codex:       codex
Claude Code: claude

You can also start either command in a regular integrated terminal. After VS Code Shell Integration becomes available, Agent Review recognizes the configured command and registers that terminal as a send target.

2. Add review comments

In a writable text editor:

Select the code you want to discuss. With no selection, the current line is used.
Select Agent Review: Add Comment to Selection from the editor context menu.
Enter your feedback and select Add Comment.

Comments are displayed in the editor and in VS Code's Comments view. They are stored in the current workspace's local extension state.

3. Send feedback

Use the actions on an individual comment to edit, delete, copy, or send it.

Select the Agent Review button in the editor title area for current-file actions:

Delete all comments
Copy all comments
Send all comments
Expand or collapse all comments

When sending, choose a registered agent terminal. Agent Review writes a structured prompt containing the file, source language, line range, excerpt, and your comment. Successfully sent comments are removed from the editor.

A single send is limited to 100 comments and 64 KiB of structured prompt text.

4. Enable agent notifications

Run Agent Review: Setup Agent Notifications in a trusted workspace. Review the configuration diff, then select Install Hooks.

Restart any running Codex CLI and Claude Code sessions after installation. Use Agent Review: Send Test Notification to verify notification delivery.

Run Agent Review: Uninstall Agent Notifications to remove only the hooks managed by this extension.

Settings

Search for Agent Review in VS Code Settings, or edit settings.json:

{
  "agentReview.codex.command": "codex",
  "agentReview.codex.args": [],
  "agentReview.claude.command": "claude",
  "agentReview.claude.args": [],
  "agentReview.notifications.enabled": true
}

Command settings accept an executable name available on PATH or an absolute path. Arguments are passed directly to the configured command without shell evaluation.

Privacy and local data

Agent Review does not collect telemetry.
Review comments are stored in VS Code workspace state.
Comment text is sent only to the integrated terminal you select.
Agent lifecycle events are relayed through local files under ~/.agent-review/.
Hook configuration changes are previewed before installation and backed up locally.

Limitations

Review comments require a writable text editor. Webviews, notebooks, images, PDFs, and Markdown preview panes are not supported comment targets.
In a Working Tree diff, comments can be added only to the editable modified side.
Native system notifications are macOS-only in the current release.
VS Code Web, vscode.dev, and github.dev are not supported.

Troubleshooting

No agent terminal is available

Open a folder or workspace, then launch an agent from the Terminal profile menu. If you use a regular shell, wait for Shell Integration to initialize before starting the configured agent command.

A prompt was inserted but not submitted

Make sure the terminal agent is ready for input and is not showing a login, permission, or selection prompt.

Agent notifications do not appear

Confirm that hooks are installed, restart the agent sessions, ensure agentReview.notifications.enabled is enabled, and run the test-notification command. On macOS, also check the system notification settings for terminal-notifier.

Agent Review Tool