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.
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
- Add the Reviewable marketplace:
codex plugin marketplace add bereviewable/reviewable-agents - Install the plugin:
codex plugin add reviewable-agent-plugin@reviewable - Reload plugins. Setup prepared — this page cannot verify your local setup.
- 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
- Add the Reviewable marketplace:
claude plugin marketplace add bereviewable/reviewable-agents - Install the plugin:
claude plugin install reviewable-agent-plugin@reviewable - Run
/reload-plugins. Setup prepared — this page cannot verify your local setup. - 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
- Add a local stdio MCP server named
reviewablethat runs:npx -y reviewable-artifacts-mcp - Reload the host's MCP servers. Before authorization, the server exposes
get_connection_state,start_web_authorization,check_authorization, anddisconnect. They reveal no reviews. Setup prepared — this page cannot verify your local setup. - Optional: install the
make-it-reviewableskill from bereviewable/reviewable-agents through your host's Agent Skills mechanism. - 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.