Reviewable for agents

Connect your agent to human review.

Choose the agent you use. Reviewable installs without a workspace key; you approve a scoped connection only when you first publish a private review.

Setup is local and explicit.
This page prepares instructions. It cannot detect, modify, or claim a connection to software on your computer.

Cursor and VS Code each ask before they add the server.

Open this page on your computer to install in Cursor or VS Code.

Giving an agent this page is enough to start. For the complete, machine-readable route, it can follow the agent onboarding guide.

Choose your agent

Install the Reviewable bundle

  1. Add the Reviewable marketplace:codex plugin marketplace add bereviewable/reviewable-agents
  2. Install the plugin:codex plugin add reviewable-agent-plugin@reviewable
  3. Reload plugins. Setup prepared — this page cannot verify your local setup.
  4. After creating an HTML artifact, ask: Make proposal.html reviewable.

Prefer no plugin? The MCP on its own is a complete installation:codex mcp add reviewable -- npx -y reviewable-artifacts-mcp

Install the Reviewable bundle

  1. Add the Reviewable marketplace:claude plugin marketplace add bereviewable/reviewable-agents
  2. Install the plugin:claude plugin install reviewable-agent-plugin@reviewable
  3. Run /reload-plugins. Setup prepared — this page cannot verify your local setup.
  4. After creating an HTML artifact, ask: Make proposal.html reviewable.

Prefer no plugin? The MCP on its own is a complete installation:claude mcp add --transport stdio reviewable -- npx -y reviewable-artifacts-mcp

Add the Reviewable MCP

  1. Add a local stdio MCP server named reviewable that runs:npx -y reviewable-artifacts-mcp
  2. Reload the host's MCP servers. Before authorization, the server exposes get_connection_state, start_web_authorization, check_authorization, and disconnect. They reveal no reviews. Setup prepared — this page cannot verify your local setup.
  3. Optional: install the make-it-reviewable skill from bereviewable/reviewable-agents through your host's Agent Skills mechanism.
  4. After creating an HTML artifact, ask: Make proposal.html reviewable.

The bundle adds the named make-it-reviewable action on top of the MCP. With the MCP alone, asking in plain language does the same thing through the same authorized tool. Both are open source at bereviewable/reviewable-agents.

Approve only on first publish

When the skill needs to create a review, your agent opens Reviewable browser authorization for workspace_create. Approve it there; do not paste a workspace key into chat or configuration.

You receive a private owner URL. Open it, then share with colleagues from Reviewable when you choose.