# Ask Obss in your editor - Obss

Operate
Ask Obss in your editor
Chat with Ask Obss from Zed, a JetBrains IDE, or another Agent Client Protocol (ACP) editor, with the same projects and chat history as the dashboard.
Your editor starts Ask Obss as an external agent through the Obss CLI (
obss acp ask-obss
), so you can ask about experiments, frictions, and runs without leaving it.
Ask Obss works with your Obss projects, not your local files. To give the AI assistant that works on your code access to Obss,
install the Obss Plugin
in it instead.
Prerequisites
The
Obss CLI
.
A model for Ask Obss under
Organization settings → Obss AI features
(
Ask Obss prerequisites
).
Add Ask Obss to your editor
Zed
JetBrains IDEs
Open
Agent Settings → External Agents
, or open your Zed
settings.json
.
Add Ask Obss under
agent_servers
:
{
"agent_servers"
: {
"Ask Obss"
: {
"type"
:
"custom"
,
"command"
:
"obss"
,
"args"
: [
"acp"
,
"ask-obss"
],
"env"
: {}
}
}
}
Start a new thread with
Ask Obss
.
Open
~/.jetbrains/acp.json
.
Add Ask Obss with the same command and arguments:
{
"agent_servers"
: {
"Ask Obss"
: {
"command"
:
"obss"
,
"args"
: [
"acp"
,
"ask-obss"
]
}
}
}
Start a chat with
Ask Obss
in the IDE’s AI chat.
If the editor can’t find
obss
, use the absolute path that
command -v obss
prints.
Optional
args
:
"--project-id", "prj_2d7c90ab"
keeps every chat in one project.
"--model", "<model-id>"
starts new chats on a model other than your organization’s Ask Obss model.
Sign in
The first time, use the editor’s
Sign in
action, which opens Obss sign-in in your browser or shows the link. You stay signed in after that, and the editor’s
Sign out
action works like
obss logout
.
How chats work
Project:
a chat belongs to the project in
--project-id
. Without it, the chat uses your saved project, or your newest project if none is saved. It appears in your dashboard Ask Obss history with the same title.
Continue later:
when the editor restarts the agent, an open thread reconnects to its chat with the earlier messages. Editors that browse agent history list all your chats in the project, including ones started in the dashboard.
Models:
the editor’s model picker lists the models Ask Obss accepts.
Approvals and questions:
approvals use the editor’s permission prompt, and questions use its form. In an editor without forms, the question appears in the chat, and your next message answers it.
Dashboard-only steps:
for a step such as connecting Ask Obss or entering a secret, Ask Obss opens the Obss page and leaves the link in the chat. Send your message again when you’re done.
Stop:
the editor’s stop action cancels the reply, and your next message continues the chat.
Limits
Ask Obss accepts text only. A file link reaches it as text, not as the file’s content.
Ask Obss doesn’t read your local files, run your terminal, or use your editor’s MCP servers.
A request to Obss that takes more than 30 seconds fails. Send the message again.
Run without a browser sign-in
In a run, a CI job, or another tool where no one can sign in, set
OBSS_API_KEY
to a
personal API key
and pass
--project-id
. The key acts as you, so every chat can read and change your projects.
OBSS_API_KEY
=<
your
personal
API
ke
y
>
obss
acp
ask-obss
--project-id
prj_2d7c90ab
To measure how well Ask Obss answers questions about your projects,
run it as a custom agent
in experiments.
Next steps
Ask Obss
Learn what Ask Obss can do and which models it uses.
Install the Obss Plugin
Give your AI assistant the Obss tools.
obss acp and ask
Look up every flag of
obss acp
.
Ask Obss in Slack
Ask about your projects in Slack.
Ask Obss in Slack
Tasks and rubrics
Powered by
This documentation is built and hosted on Mintlify, a developer documentation platform