# Install the Obss Plugin - Obss

Operate
Install the Obss Plugin
Install the Obss Plugin in Codex, Claude Code, Cursor, or GitHub Copilot, sign in once, and work with Obss from your AI assistant.
With the plugin, you ask your
AI assistant
, such as Codex or Claude Code, in plain language to create tasks, launch experiments, and read results. You still read results and enter secrets in the dashboard.
The plugin has two parts:
A connection to the Obss MCP server
at
https://mcp.obss.app/mcp
, with the same capabilities as the
CLI
and
Ask Obss
. This server operates your projects, and it’s separate from the MCP servers that you add as
tools
. You sign in with OAuth, not an API key.
Four
skills
that teach your AI assistant to build a good eval set, launch it safely, and read the results correctly.
Prerequisites
An Obss account in an organization with at least one
project
.
ChatGPT (Codex), Claude Code, Cursor, or GitHub Copilot. If your host doesn’t support plugins,
connect without the plugin
.
Install the plugin
Add the
obss
marketplace (the plugin list your host installs from), then install the
obss
plugin. Both come from the public
Obss-Inc/agent-plugin
repository, so you don’t need a GitHub sign-in.
ChatGPT (Codex)
Claude Code
Cursor
GitHub Copilot
codex
plugin
marketplace
add
Obss-Inc/agent-plugin
\
--sparse
.agents/plugins
\
--sparse
distributions/openai
codex
plugin
add
obss@obss
claude
plugin
marketplace
add
Obss-Inc/agent-plugin
\
--scope
user
\
--sparse
.claude-plugin
distributions/claude-code
claude
plugin
install
obss@obss
--scope
user
Then start Claude Code and run
/mcp
to
sign in
.
cursor-agent
plugin
marketplace
add
https://github.com/Obss-Inc/agent-plugin.git
cursor-agent
In Cursor Agent, type
/plugin
, open the
Marketplace
tab, select
obss
, press Enter, and choose user scope. Cursor Agent has no command for this step.
copilot
plugin
marketplace
add
Obss-Inc/agent-plugin
copilot
plugin
install
obss@obss
Then start
copilot
and run
/mcp auth obss
to
sign in
.
The dashboard shows the same commands under
Automate → Obss Plugin (MCP)
:
The plugin stores no credentials. Its skills read the public docs index at
https://docs.obss.app/llms.txt
.
Sign in
The first time your host connects, it opens Obss sign-in in your browser. After that, your AI assistant acts as you in your organization (
sign-in rules
).
Host
How to sign in
ChatGPT (Codex)
If Codex does not open the sign-in page when it first connects, run
codex mcp login obss
.
Claude Code
Start Claude Code, run
/mcp
, and complete sign-in for
plugin:obss:obss
.
Cursor
Start
cursor-agent
, enter
/mcp
, select
obss
, and select
Login
.
GitHub Copilot
In an interactive
copilot
session, run
/mcp auth obss
.
To check the connection, start a new session and ask who you’re signed in as. Your AI assistant calls
Get the signed-in user and organization
(
get_identity
) and shows your organization.
Turn on tool approval
In your AI assistant’s tool approval settings, don’t auto-approve Obss tools that change data, such as
Launch an experiment
(
launch_experiment
). Your host then asks you before each call. Learn more in
Approvals
.
A launch spends runs from your run balance, and Obss doesn’t ask you to confirm it, so only your host’s approval can stop it.
What your AI assistant can do
Area
What it can do
Define tasks and build treatments
Search the catalog; create and update tasks, files, machines, tools, and treatments; import from public GitHub repositories.
Run experiments
Check a plan, then launch, follow, launch again, cancel, or schedule the experiment.
Read results
Read pass and fail counts, each treatment’s difference from the baseline, Evals verdicts for each criterion, run profiles, trajectories, transcripts, output, and frictions as structured data.
Organize and share
Tag records, publish an experiment to a public link, and read your notifications and run balance.
When a step needs a secret, such as an API key, your AI assistant gives you the dashboard link (
secrets stay in the dashboard
).
Plugin (MCP) tools
lists every tool.
Name the project in your request. The plugin has no current project, so a call that names none can act on a different
project
than you meant.
Try a first prompt
Show my Obss projects. For the first one, list its catalog and summarize its recent experiments.
Then ask for the next step:
Draft a task for our checkout flow, launch a small experiment with a baseline and our MCP server, and explain the Matrix and the top frictions when it finishes.
Build an eval set and read its results
Replace the product name, docs link, and project name with your own.
1
Build the eval set
Ask your AI assistant:
Build an Obss eval set for Acme Payments from its docs at https://docs.example.com. Use my Obss project Acme evals.
The
product-eval-authoring
skill reads the docs, posts a plan, and creates the machine, files, tools, treatments, and tasks, mostly with
Create or update many resources
(
bulk_author_resources
). It then runs
Check an experiment plan before launch
(
preflight_experiment
) and lists each missing secret with its dashboard link.
2
Finish setup in the dashboard
Open each link and enter the API keys, secret headers, or OAuth sign-ins. Check under
Manage → Agents
that the agents you want to compare are on.
3
Launch the experiment
Ask your AI assistant:
Check the eval set again and plan a launch with two trials on Claude Code and Codex. Tell me how many runs it uses, and wait for my go-ahead before you launch.
The
product-eval-results
skill checks the plan and tells you the run count. After you agree, it launches with
Launch an experiment
(
launch_experiment
) and follows it with
Get experiment status
(
get_experiment_status
) until it finishes. With
tool approval
on, your host asks you before the launch.
4
Review the results
Ask your AI assistant:
Compare each treatment with the baseline, and list the top frictions and where to fix each one.
It uses
Analyze experiment results
(
analyze_results
) and
List a project’s frictions
(
list_frictions
). To see the results visually, open the experiment’s
Matrix
and
Frictions
in the dashboard.
Skills in the plugin
Your AI assistant loads a skill when your request matches it. You can also name one in your request.
Skill
Use it to
product-eval-authoring
Build a complete eval set from a product’s docs: tasks, a machine, files, tools, and treatments.
product-eval-tasks
Write tasks and fair rubrics from a product’s docs, or review an existing rubric.
product-eval-setup
Set up the machine, files, treatments, and test data for a clean baseline and valid parallel runs.
product-eval-results
Launch or rerun an experiment, follow it to the end, and read verdicts, frictions, and treatment comparisons. It checks
Comparisons
before it calls one treatment better.
With the skills, your AI assistant:
Posts a plan (tasks, treatments, and the runs a launch uses) before it creates anything, then goes ahead, so reply right away if you want changes.
Checks the plan with
preflight_experiment
before it launches, and suggests at least two trials.
Says which Evals and Insights results are still pending.
Update or remove the plugin
Update the plugin
Refresh the marketplace, update the plugin, and start a new session in your host.
ChatGPT (Codex)
Claude Code
Cursor
GitHub Copilot
codex
plugin
marketplace
upgrade
obss
codex
plugin
add
obss@obss
codex plugin list -m obss
shows the installed version.
claude
plugin
marketplace
update
obss
claude
plugin
update
obss@obss
--scope
user
cursor-agent
plugin
marketplace
update
obss
Cursor Agent has no command that updates an installed plugin. If a new session still loads the old version, type
/plugin
, open
Installed
, select
obss
, select
Uninstall
, and install it again from
Marketplace
.
copilot
plugin
marketplace
update
obss
copilot
plugin
update
obss@obss
Turn off or remove the plugin
Turn the plugin off to pause it, or remove it to delete its skills and Obss connection from your host. Neither changes anything in your Obss organization.
ChatGPT (Codex)
Claude Code
Cursor
GitHub Copilot
To turn the plugin off or on, start
codex
, type
/plugins
, select
obss
, and press Space. You can also set
enabled = false
under
[plugins."obss@obss"]
in
~/.codex/config.toml
.
To remove the plugin and its marketplace:
codex
plugin
remove
obss@obss
codex
plugin
marketplace
remove
obss
To turn the plugin off or on:
claude
plugin
disable
obss@obss
claude
plugin
enable
obss@obss
To remove the plugin and its marketplace:
claude
plugin
uninstall
obss@obss
claude
plugin
marketplace
remove
obss
To turn the Obss connection off or on, start
cursor-agent
, type
/mcp
, select
obss
, and select
Disable
or
Enable
. The skills stay installed until you remove the plugin.
To remove the plugin, type
/plugin
, open
Installed
, select
obss
, and select
Uninstall
. To remove the marketplace too:
cursor-agent
plugin
marketplace
remove
obss
This can also remove the marketplace from your other Cursor apps, because Cursor Agent lists the marketplaces that your Cursor account can see.
To turn the plugin off or on:
copilot
plugin
disable
obss@obss
copilot
plugin
enable
obss@obss
If Copilot says that
disable
isn’t a command, update GitHub Copilot CLI with
copilot update
or with the package manager that installed it.
To remove the plugin and its marketplace, in this order:
copilot
plugin
uninstall
obss@obss
copilot
plugin
marketplace
remove
obss
Your host can keep its Obss sign-in after you remove the plugin. To delete the sign-in too, sign out before you remove the plugin:
Host
Sign out of Obss
ChatGPT (Codex)
Run
codex mcp logout obss
.
Claude Code
In
/mcp
, select
plugin:obss:obss
, then
Clear authentication
.
Cursor
In Cursor Agent’s
/mcp
, select
obss
, then
Logout
.
GitHub Copilot
Open
/mcp
in an interactive
copilot
session.
Troubleshoot the plugin
An install command fails
Unknown command or flag:
update the host and run the command again. If your host doesn’t support plugins,
connect without the plugin
.
The
obss
marketplace already exists:
skip that command and run the install command.
Download errors:
the commands download the plugin from
github.com
, so check that your network can reach it.
Sign-in does not open or does not finish
Follow the
sign-in step
for your host. Hosts show the Obss server as
obss
, except Claude Code, which shows
plugin:obss:obss
. If Claude Code shows only
obss
, you
also have a direct connection
.
If you belong to more than one organization, choose one on the sign-in page. If calls fail with
organization_ambiguous
, sign in again and choose one. To switch organizations,
sign out
in your host and sign in again.
Obss tools or skills are missing
Start a new session. Hosts load a plugin’s tools and skills when a session starts.
Check that the plugin is installed and on:
codex plugin list -m obss
,
claude plugin list
,
copilot plugin list
, or
Installed
in Cursor Agent’s
/plugin
.
Check that the Obss server is signed in, because tools appear only after sign-in. Open
/mcp
in Claude Code, Cursor Agent, or GitHub Copilot, or run
codex mcp list
.
If the tools work but the skills are missing, you have a direct MCP connection instead of the plugin. Install the plugin and remove the direct connection, or
add the skills without the plugin
.
The plugin and a direct connection are both set up
When your host has both the plugin and a direct connection to
https://mcp.obss.app/mcp
, the Obss tools can appear twice, or the host hides the plugin’s server. Claude Code, for example, then shows only
obss
and not
plugin:obss:obss
. Keep the plugin and remove the direct connection:
Host
Remove the direct connection
ChatGPT (Codex)
codex mcp remove obss
Claude Code
claude mcp remove obss
Cursor
Delete the
obss
entry from
~/.cursor/mcp.json
or
.cursor/mcp.json
.
GitHub Copilot
copilot mcp remove obss
The plugin’s server stays. Start a new session and sign in to it.
For other problems, see
Troubleshooting
or email
support@obss.app
.
Connect without the plugin
Use these steps when your host doesn’t support plugins, or to search these docs from your host. For a terminal, a script, or CI, use the
CLI
.
Use the plugin or a direct connection in a host, not both. Learn why in
The plugin and a direct connection are both set up
.
Add MCP directly
A direct connection gives your AI assistant the Obss MCP server without the skills. The commands also add the optional
obss-product-docs
server, which searches these docs and works with or without the plugin.
ChatGPT (Codex)
Claude Code
Cursor
GitHub Copilot
codex
mcp
add
obss
--url
https://mcp.obss.app/mcp
codex
mcp
login
obss
codex
mcp
add
obss-product-docs
--url
https://docs.obss.app/mcp
claude
mcp
add
--transport
http
--scope
user
obss
https://mcp.obss.app/mcp
claude
mcp
add
--transport
http
--scope
user
obss-product-docs
https://docs.obss.app/mcp
Then start Claude Code, run
/mcp
, and sign in to
obss
.
Add the servers to
~/.cursor/mcp.json
(user) or
.cursor/mcp.json
(project):
{
"mcpServers"
: {
"obss"
: {
"type"
:
"http"
,
"url"
:
"https://mcp.obss.app/mcp"
},
"obss-product-docs"
: {
"type"
:
"http"
,
"url"
:
"https://docs.obss.app/mcp"
}
}
}
Then sign in and turn on the server:
cursor-agent
mcp
login
obss
cursor-agent
mcp
enable
obss
copilot
mcp
add
--transport
http
obss
https://mcp.obss.app/mcp
copilot
mcp
add
--transport
http
obss-product-docs
https://docs.obss.app/mcp
Then start
copilot
and run
/mcp auth obss
.
Add the skills without the plugin
To use the skills with a direct MCP connection or the CLI, install them with the open-source Skills CLI. It asks which AI assistants to add them to, and installs into the current project unless you add
-g
for all projects:
npx
skills
add
Obss-Inc/agent-plugin
--skill
'*'
npx skills update
gets the latest skills, and
npx skills remove
removes them. Don’t use this in a host that has the plugin, or it gets two copies of each skill. The skills use MCP tools, and some steps also give the matching CLI command.
Next steps
Measure a tool's impact
Run your first lift experiment from your AI assistant.
Plugin (MCP) reference
Read about sign-in, approvals, secrets, IDs, paging, and errors.
Plugin (MCP) tools
Look up every tool, with its parameters and CLI command.
Use the CLI
Use the same capabilities from your terminal and scripts.
Notifications
Use the CLI
Powered by
This documentation is built and hosted on Mintlify, a developer documentation platform