@versely/cli
v0.2.0
Published
Connect Versely's MCP server and skills to Claude Code, Cursor, Codex, and other AI agents.
Maintainers
Readme
@versely/cli
Connect Versely's MCP server and skills to Claude Code, Cursor, and other AI agents.
Quick start
npx @versely/cli setupThat runs three things:
npx skills add AI-XLabs-Innovation/versely-skills— installs the Versely skill packs (powered by vercel-labs/skills, supports 54 agents).- Signs you in via your browser and stores a Versely API key at
~/.versely/config.json. - Writes the Versely MCP server (
https://mcp.versely.studio/mcp) into every detected agent's config with your key.
Restart your agent and you'll see the mcp__versely__* tools and the /versely-* skills.
Authentication
versely auth login opens your browser and runs the same OAuth flow that
claude.ai uses to connect to the Versely MCP — authorization code with PKCE
over a localhost loopback redirect (RFC 8252).
No secret is stored and no password is typed into the terminal: the CLI
registers as a public client, you approve access in the browser, and that
sign-in is used once to mint a long-lived vsk_ API key. Only the key is
saved (to ~/.versely/config.json, chmod 600) and wired into your agents —
there are no short-lived tokens to refresh.
For CI / headless use, skip the browser entirely:
versely auth login --key vsk_xxx # or set VERSELY_API_KEY in the environmentCommands
| Command | What it does |
|---|---|
| versely setup | Skills + auth + MCP install, all in one |
| versely auth login | Sign in via browser (OAuth + PKCE), or --key <key> for headless |
| versely auth logout | Clear stored credentials |
| versely auth whoami | Show the active sign-in (OAuth scopes or masked key) |
| versely install | Wire MCP into detected agents (or --agent <id>, or --agent '*') |
| versely uninstall | Remove Versely MCP (default: all agents) |
| versely status | Auth + per-agent connection state |
Supported agents
| Agent | Config file |
|---|---|
| Claude Code | ~/.claude.json |
| Cursor | ~/.cursor/mcp.json |
API keys (alternative to OAuth)
Prefer a long-lived key (CI, scripts)? Create one at
versely.studio/settings/api-keys and
either run versely auth login --key vsk_xxx or set VERSELY_API_KEY in your
environment. The env var takes precedence over everything stored on disk.
License
MIT
