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:
- Start a new thread with Ask Obss.
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 likeobss 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, setOBSS_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.
