refresh-cv
v0.1.9
Published
Install refresh.cv MCP connections for supported agent clients.
Maintainers
Readme
refresh-cv
Install the refresh.cv MCP server for supported agent clients.
Codex
npx -y refresh-cv@latest --client codexThis configures Codex with:
https://mcp.refresh.cv/mcpThen it starts the Codex OAuth login flow.
OpenCode
npx -y refresh-cv@latest --client opencodeThis writes the remote MCP server to OpenCode config and starts:
opencode mcp auth refresh.cvOpenCode uses http://127.0.0.1:19876/mcp/oauth/callback during OAuth login.
If the browser reaches that URL but OpenCode does not finish connecting, another
local process may already be using port 19876:
lsof -nP -iTCP:19876 -sTCP:LISTENFree that port, then rerun:
opencode mcp auth refresh.cvIf you prefer a shorter server name:
npx -y refresh-cv@latest --client opencode --name refresh
opencode mcp auth refreshClaude Code
This package also contains the refresh.cv Claude Code plugin. Install it through the public refresh.cv marketplace:
/plugin marketplace add https://mcp.refresh.cv/claude/marketplace.json
/plugin install refresh@refresh-cv
/mcpThen authorize refresh.cv from /mcp.
The plugin also provides a login helper command:
/refresh:loginOpenClaw
MCP-only install:
npx -y refresh-cv@latest --client openclawPlugin marketplace install from GitHub:
openclaw plugins install refresh-cv --marketplace refresh-dev/claude-pluginThe npm-style command below will only work after an npm package named @refresh-dev/claude-plugin is published:
openclaw plugins install @refresh-dev/claude-pluginThe installer pins OpenClaw's OAuth callback to:
http://127.0.0.1:8989/oauth/callbackAfter browser approval, OpenClaw should save the credentials and probe the MCP server automatically. If login does not complete, rerun:
openclaw mcp login refresh.cv
openclaw mcp probe refresh.cvHermes
MCP-only install:
npx -y refresh-cv@latest --client hermesEquivalent manual commands:
hermes mcp add refresh.cv --url https://mcp.refresh.cv/mcp --auth oauth
hermes mcp login refresh.cv
hermes mcp test refresh.cvLocal server
npx -y refresh-cv@latest --client codex --localThis configures Codex with:
http://localhost:8010/mcpThe default local server name is refresh_cv_local, so production and local MCP connections can coexist.
Options
--client codex: configure Codex.--client openclaw: configure OpenClaw withopenclaw mcp add, then run OAuth.--client opencode: configure OpenCode JSONC config, then runopencode mcp auth.--client hermes: configure Hermes withhermes mcp add, then run OAuth.--url <url>: override the MCP endpoint.--local: configurehttp://localhost:8010/mcpasrefresh_cv_local.--name <name>: override the MCP server name. Codex defaults torefresh_cv; OpenClaw/OpenCode/Hermes default torefresh.cv; local mode defaults torefresh_cv_local.--force: replace an existing supported config entry where possible.--skip-login: add the MCP server but skip OAuth login.
