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.

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 it is authorized, the server offers only get_setup_instructions, which explains the connection and reveals nothing about your 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.