Plugin

Install the official Vruum marketplace app in ChatGPT, or use a supported client plugin or direct MCP plus skills.

Plugin is the packaging layer. A Vruum plugin can bundle:

the remote MCP server entry for https://api.vruum.ai/mcp;
Vruum workflow skills;
harness metadata such as display name, description, and category;
setup instructions for the harness that understands that plugin format.

The plugin is not the runtime. MCP is still the live tool connection. Skills are still the workflow instructions the agent loads. The plugin just makes installation one step when a harness has plugin rails.

Non-technical clients should use a plugin when their harness offers one, or direct MCP when it does not. They should not need Node or the local CLI for normal Vruum operation.

Get started in ChatGPT: install and connect Vruum

To get started, install and connect Vruum in ChatGPT through the official marketplace app:

https://chatgpt.com/plugins/plugin_asdk_app_6abc0d085d088191820a73232f0b3189?open_in_app

Follow the installation and connection prompts shown there. This is the recommended ChatGPT setup. No local npm installation or Vruum CLI is needed.

Once connected, ask: What needs my attention in Vruum today? This first check is read-only. The app bundles vruum-guide, deal-triage, and outreach-triage; ask naturally and use the operations exposed by the app. The broader skills catalog applies to compatible local clients.

Harness support

Harness	Plugin status	Use now
ChatGPT	Official Vruum marketplace app.	Open the marketplace link above and follow its installation and connection prompts.
Claude Code	Vruum is listed in the Claude Directory.	Install from the Directory or add the `vruum-gtm/skills` marketplace (below). Otherwise use direct MCP and skills setup.
Claude Desktop / Claude.ai	Vruum distributes a plugin zip from the skills release channel.	Download the Vruum plugin zip and add it from the Claude plugin UI.
Codex CLI	Vruum ships Codex plugin metadata with `skills` and `mcpServers` entries.	Use the Codex plugin commands below when the marketplace is available, or connect MCP and install `@vruum/skills` directly.
Cursor	No Vruum plugin bundle today.	Connect the Vruum MCP server; install shipped skill files manually where supported.
Cline	No Vruum plugin bundle today.	Connect the Vruum MCP server; install shipped skill files manually where supported.
OpenCode	No Vruum plugin bundle today.	Connect MCP; OpenCode can read `.agents/skills` when configured.
Windsurf	No Vruum plugin bundle today.	Connect MCP; install skill files manually only if the harness exposes a skill directory.
Gemini CLI	No Vruum plugin bundle today.	Connect MCP; install shipped skill files manually where supported.
Other hosted MCP clients	Use remote MCP where supported.	Connect `https://api.vruum.ai/mcp` and authenticate in the client.

Codex plugin

The public skills package includes a Codex plugin manifest:

{
  "name": "vruum",
  "skills": "./skills/",
  "mcpServers": "./.mcp.json"
}

When the Codex plugin marketplace is available in your environment:

codex plugin marketplace add vruum-gtm/skills
codex plugin add vruum@vruum-gtm
codex mcp login vruum

If plugin installation is unavailable, connect MCP through Codex configuration and install the skills directly. The Vruum CLI is not required:

export VRUUM_MCP_TOKEN=<your-vruum-token>
npx --yes @vruum/skills@latest install
codex

See MCP for the direct Codex MCP command. The skills installer auto-detects Codex and installs into ~/.agents/skills.

Claude plugin

The Vruum plugin bundles the hosted MCP connector, the public skills, and the review subagents. It is listed in the Claude Directory for Claude Code, Cowork, and Claude apps. In Claude Code you can also add its marketplace directly:

/plugin marketplace add vruum-gtm/skills
/plugin install vruum@vruum-gtm

Then run /mcp to sign in to Vruum with OAuth. For a manual Claude Desktop or Claude.ai plugin upload, use the release zip:

https://github.com/vruum-gtm/skills/releases/latest/download/vruum-plugin.zip

For Claude Code without plugin install, connect MCP and install the skills directly. The Vruum CLI is not required:

claude mcp add -s user --transport http vruum https://api.vruum.ai/mcp --header "Authorization: Bearer <your-vruum-token>"
npx --yes @vruum/skills@latest install

Restart Claude Code afterward. The skills installer auto-detects Claude Code and installs into ~/.claude/skills. This path is tested on Windows and does not require Administrator access or Developer Mode.

Plugin vs MCP vs skills

Need	Use
One install path for a harness that supports plugins	Plugin
The live Vruum tool connection	MCP
Workflow instructions like outreach triage or pipeline fill	Skills
Local config writing, CI, local files, or debugging	CLI Reference

Give this to an agent

For ChatGPT, open the official Vruum marketplace app at
https://chatgpt.com/plugins/plugin_asdk_app_6abc0d085d088191820a73232f0b3189?open_in_app
and follow the installation and connection prompts shown there.

For another client, use its Vruum plugin if available. Otherwise connect
https://api.vruum.ai/mcp. In a compatible local harness, install Vruum-shipped
skills with `npx --yes @vruum/skills@latest install`, or target its skill directory.
The Vruum CLI is optional.

Once connected, run a read-only check: What needs my attention in Vruum today?