Skip to main content
Run Ask Oqo inside Zed, JetBrains IDEs, or any Agent Client Protocol (ACP) editor via oqoqo acp ask-oqo so you can query experiments and frictions without switching windows. Ask Oqo operates on your Oqoqo projects, not your local workspace files. To let your coding assistant read your local repository and operate Oqoqo together, install the Oqoqo Plugin instead.

Prerequisites

  • The Oqoqo CLI installed on PATH.
  • An Ask Oqo model assigned under Organization settings → Oqoqo AI defaults (prerequisites).

Add Ask Oqo to your editor

Open Agent Settings → External Agents (or your Zed settings.json) and add Ask Oqo under agent_servers, then start a new thread with Ask Oqo:
If your editor cannot find oqoqo, pass the full path printed by command -v oqoqo. You can also append optional args: "--project-id", "prj_2d7c90ab" to pin one project, or "--model", "<model-id>" to override the default Ask Oqo model.

Sign in

Use your editor’s Sign in action on first launch to complete browser authentication (and Sign out to clear it). If you have never opened Ask Oqo in the dashboard, follow the Open Ask Oqo in Oqoqo once link shown in chat, then resend your message.

How editor chats work

  • Synced history: chats use the --project-id project (or your saved CLI project) and appear in your dashboard Ask Oqo chat history, so sessions survive restarts.
  • Approvals & models: approvals use your editor’s native permission prompts, and the editor model picker displays supported Ask Oqo models.
  • Scope limits: Ask Oqo accepts text only and cannot read local files, run local commands, or call your editor’s MCP servers.

Run without a browser sign-in

In automated environments, pass OQOQO_API_KEY (personal API key) and --project-id:
To evaluate Ask Oqo itself in experiments, see Run Ask Oqo as a custom agent.

Next steps

Ask Oqo

See what Ask Oqo can do and which models it supports.

Install the Oqoqo Plugin

Combine local coding context with Oqoqo tools.

oqoqo acp

CLI flags for oqoqo acp ask-oqo.

Ask Oqo in Slack

Use Ask Oqo with your team in Slack.