# obss acp and ask - Obss

CLI
obss acp and ask
Serve Ask Obss to Agent Client Protocol editors such as Zed or JetBrains IDEs, and disconnect Ask Obss from your account.
Chat with
Ask Obss
outside the dashboard over the Agent Client Protocol (ACP), the open standard editors use to talk to AI agents, or disconnect Ask Obss from your account.
obss acp
Serve an Obss agent as an ACP agent on standard input and output. An ACP editor, such as Zed or a JetBrains IDE, or an automated tool starts it.
obss
acp
<
agent-i
d
>
[flags]
No Plugin (MCP) tool: this is a way to reach Ask Obss, not a product operation.
Arguments
Argument
Description
<agent-id>
Required. The agent to serve:
ask-obss
.
Flags
Flag
Type
Default
Description
--project-id
string
The saved project
The project every chat uses. The saved project doesn’t change.
--model
string
The organization’s
Ask Obss model
The model that new chats start on.
Also takes the
global flags
.
Examples
The command an editor runs to chat with Ask Obss:
obss
acp
ask-obss
Pin every chat to one project:
obss
acp
ask-obss
--project-id
prj_2d7c90ab
Run unattended, such as in a run or a CI job, with a personal API key:
OBSS_API_KEY
=<
your
personal
API
ke
y
>
obss
acp
ask-obss
--project-id
prj_2d7c90ab
Notes
Standard output carries only the protocol; errors go to standard error.
Sign in.
The editor’s
Sign in
action opens Obss sign-in in your browser. Unattended tools set
OBSS_API_KEY
to a
personal API key
instead. The key acts as you: anything that uses it can read and change your projects, as Ask Obss can.
Chats.
Chats use your Obss project and show in your Ask Obss history in the dashboard.
Models.
Ask Obss needs a model under
Organization settings → Obss AI features
. See
Ask Obss
for which models it can use.
To measure Ask Obss in experiments, add this command as a custom agent from a download: see
Run Ask Obss as a custom agent
.
Custom agents are in private beta. Email
support@obss.app
to enable them for your organization.
obss ask disconnect
Disconnect Ask Obss from your Obss account in this organization.
obss
ask
disconnect
[flags]
Plugin (MCP) tool:
disconnect_ask_oqo
Ask Obss can’t read or change your projects until you connect it again on the
Ask Obss
page. Your chats stay.
Flags
Flag
Type
Default
Description
--yes
boolean
false
Confirm without a prompt. Required with
--output json
or without a terminal.
Also takes the
global flags
.
Examples
Disconnect Ask Obss without a prompt:
obss
ask
disconnect
--yes
--output
json
Notes
If Ask Obss isn’t connected, nothing changes and
removed
is
false
. The dashboard action is
Disconnect
on
Profile → Integrations
; see
Disconnect Ask Obss
. Your
Ask Obss in Slack
links stay.
Next steps
Ask Obss
Models, access, Slack, and Disconnect.
Run Ask Obss as a custom agent
Measure Ask Obss with tasks and rubrics.
Profile and API keys
Create a personal API key for OBSS_API_KEY.
CLI reference
Install, sign in, and global flags.
quota and notifications
Overview
Powered by
This documentation is built and hosted on Mintlify, a developer documentation platform