# Ask Obss - Obss

Operate
Ask Obss
Ask Obss about experiments, runs, and frictions, and let it take everyday actions in your project, in the dashboard and in Slack.
Ask Obss
is the assistant built into the dashboard. It has the same capabilities as the
Obss Plugin
and the
CLI
, so it can draft tasks, launch experiments, read results, and suggest what to fix next.
Prerequisites
Connect a
model provider
under
Organization settings → Model providers
, or connect
OpenAI (ChatGPT Subscription)
or
Nous Portal
under
Profile → Integrations
.
Assign a model to
Ask Obss
under
Organization settings →
Obss AI features
.
When Ask Obss asks, select
Connect
and allow access to your projects. You connect once per organization, and Ask Obss stays connected until you
disconnect it
.
If you see
Ask Obss needs a model
or
Ask Obss can’t use its model
, the message under it says what to fix, usually steps 1 and 2.
Ask Obss can’t use your personal
Claude Subscription
from
Profile → Integrations
. Claude models through an Anthropic API key or a gateway work.
Open Ask Obss
Open Ask Obss from
Ask Obss
in the sidebar (full page) or in any page’s header, from the Ask prompt on the project
Home
page, or
in Slack
. It works on the project you have selected.
Here, Ask Obss lists the top frictions in the
Skill lift
experiment and where to fix each one, with its tool calls folded into one card above the answer:
What Ask Obss can do
Explain the
Matrix
, the friction list, or one run
Find where agents got stuck and what to change next
Draft tasks and rubrics, launch small experiments, and read the results
Read
public GitHub repositories
and these docs
Ask Obss asks for your approval before it removes any data, such as a delete, and before each of these actions:
Launch or relaunch an experiment, including
Launch now
on a schedule
Create, change, pause, or resume a
schedule
Run Evals or Insights
Test a custom agent
Publish an experiment, or change its public link
Read the details on the card, then select
Approve
or
Deny
. Ask Obss doesn’t run the action until you approve it.
When a step needs an API key, an OAuth grant, or another secret, Ask Obss sends you to the exact dashboard page for it. It never asks you to paste a secret into the chat.
For larger workflows in Codex, Claude Code, Cursor, or a similar host,
install the Obss Plugin
or
use the CLI
.
While Ask Obss works
Status line:
the line at the end of the chat shows what Ask Obss is doing:
Thinking
, the tools it calls, or
Summarizing earlier messages
in a long chat. After a few seconds, it also shows how long Ask Obss has worked. It stays until the answer is complete.
Tool cards:
tool calls in a row fold into one card, such as
Used 3 tools
. Open it to see each call’s input, result, and status (
Running
,
Completed
, or
Error
). A card that needs your approval opens by itself.
Notes and pauses:
some Claude models write short notes between tool calls, which Ask Obss shows while the tools run. With Claude Opus 5.5 and Sonnet 5.5, the answer after a tool call can arrive all at once after a pause. The status line shows that Ask Obss is still working.
Add to a reply:
you can type while Ask Obss works.
Stop
becomes
Send
, and Ask Obss uses your message in the reply it’s writing. To stop instead, clear the box and select
Stop
.
Ended requests:
if a request that waits for you ends before you answer, its card says how, such as
Withdrawn
,
Stopped
, or
Expired
.
Read GitHub
Ask Obss can read files, commits, releases, issues, pull requests, and GitHub Actions runs in public repositories. Use it to see what changed in a tool between two experiments, or to compare a friction with the code and open issues.
It uses the
GitHub
connection on
Profile → Integrations
, the same one that runs GitHub Copilot. If you haven’t connected GitHub, Ask Obss shows
Sign in with GitHub
in the chat and continues your request after you sign in. In an editor that runs
obss acp ask-obss
, the editor opens the same sign-in page.
Access is read-only and limited to public repositories. Ask Obss doesn’t create, change, or comment on anything.
To stop access, disconnect GitHub on
Profile → Integrations
. This also turns off the GitHub Copilot agent for you.
What changed in github/github-mcp-server between its last two releases?
Chat history
Ask Obss keeps a chat history for each project. Select
Chat history
to find, rename, or delete a chat.
When you close the panel, your open chat and unsent message stay.
If a message isn’t sent, Ask Obss shows
Not sent
and puts your message back in the box, so you can send it again.
If the connection drops, for example after your computer sleeps, select
Reconnect
. Ask Obss also reconnects when your network comes back.
A chat ends 30 days after it starts, but you can still read it. To continue, select
Start a new chat
, and your unsent message moves to it.
Disconnect Ask Obss
Disconnecting stops Ask Obss from reading or changing your projects in this organization until you connect it again on the
Ask Obss
page. Obss keeps your chats, and your Slack accounts stay linked. In Slack, Ask Obss asks you to connect it again.
Dashboard
CLI
Plugin (MCP)
Open
Profile → Integrations
.
On the
Ask Obss
row, choose
Disconnect
.
Confirm with
Disconnect
.
obss
ask
disconnect
In a terminal, the CLI asks you to confirm. With
--output json
, or with no terminal, add
--yes
. See
obss ask disconnect
.
Ask your AI assistant to disconnect Ask Obss. It calls
Disconnect Ask Obss
(
disconnect_ask_oqo
), and it asks you to approve the call.
Use Ask Obss outside the dashboard
In Slack
:
ask in direct messages or by mentioning
@Obss
in a channel, with your own account and a default project you choose.
In your editor:
Zed, JetBrains IDEs, and other Agent Client Protocol (ACP) editors can run
Ask Obss in your editor
through
obss acp ask-obss
. These chats also show in your Ask Obss history.
In experiments:
run Ask Obss as a custom agent
to measure how well it answers questions about your projects.
Example prompts
Show my current project, summarize recent experiments, and list the top frictions.
Explain why the baseline treatment underperformed the skill treatment on the Matrix.
Draft a small task and rubric to check our refund docs, then propose an experiment plan.
Next steps
Install the Obss Plugin
Use the same capabilities from Codex, Claude Code, Cursor, or Copilot.
Find and fix frictions
Ask Obss where agents get stuck, then fix it.
Obss AI features
Choose the model for Ask Obss and the other AI features.
Read results
Learn what the Matrix, Frictions, and Runs show.
Use the CLI
Ask Obss in Slack
Powered by
This documentation is built and hosted on Mintlify, a developer documentation platform