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.
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 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. - 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.