> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oqoqo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ask Oqo in your editor

> Chat with Ask Oqo from Zed, a JetBrains IDE, or another Agent Client Protocol (ACP) editor, with the same projects and chat history as the dashboard.

Run [Ask Oqo](https://docs.oqoqo.ai/operate/ask-oqo.md) 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](https://docs.oqoqo.ai/operate/plugin.md) instead.

## Prerequisites

* The [Oqoqo CLI](https://docs.oqoqo.ai/operate/cli.md#install-the-cli) installed on `PATH`.
* An **Ask Oqo model** assigned under **Organization settings → Oqoqo AI defaults** ([prerequisites](https://docs.oqoqo.ai/operate/ask-oqo.md#prerequisites)).

## Add Ask Oqo to your editor

> [tab] Zed
>
> 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**:
>
> ```json theme={null}
> {
>   "agent_servers": {
>     "Ask Oqo": {
>       "type": "custom",
>       "command": "oqoqo",
>       "args": ["acp", "ask-oqo"],
>       "env": {}
>     }
>   }
> }
> ```

> [tab] JetBrains IDEs
>
> Add **Ask Oqo** to `~/.jetbrains/acp.json`, then open a chat with **Ask Oqo** in the IDE AI chat:
>
> ```json theme={null}
> {
>   "agent_servers": {
>     "Ask Oqo": {
>       "command": "oqoqo",
>       "args": ["acp", "ask-oqo"]
>     }
>   }
> }
> ```

If your editor cannot find `oqoqo`, pass the full path printed by `command -v oqoqo`. You can also append optional [`args`](https://docs.oqoqo.ai/cli/ask-oqo#oqoqo-acp): `"--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](https://docs.oqoqo.ai/setup/profile.md#api-keys)) and `--project-id`:

```bash theme={null}
OQOQO_API_KEY=<your personal API key> oqoqo acp ask-oqo --project-id prj_2d7c90ab
```

To evaluate Ask Oqo itself in experiments, see [Run Ask Oqo as a custom agent](https://docs.oqoqo.ai/guides/ask-oqo-custom-agent.md).

## Next steps

> [card] [Ask Oqo](https://docs.oqoqo.ai/operate/ask-oqo.md)
>
> See what Ask Oqo can do and which models it supports.

> [card] [Install the Oqoqo Plugin](https://docs.oqoqo.ai/operate/plugin.md)
>
> Combine local coding context with Oqoqo tools.

> [card] [oqoqo acp](https://docs.oqoqo.ai/cli/ask-oqo.md)
>
> CLI flags for `oqoqo acp ask-oqo`.

> [card] [Ask Oqo in Slack](https://docs.oqoqo.ai/operate/ask-oqo-in-slack.md)
>
> Use Ask Oqo with your team in Slack.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.