> ## 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

> Ask Oqo about experiments, runs, and frictions, and let it take everyday actions in your project, in the dashboard and in Slack.

**Ask Oqo** is the assistant built into the Oqoqo dashboard. Powered by the same tools and [skills](https://docs.oqoqo.ai/operate/plugin.md#skills-in-the-plugin) as the Oqoqo Plugin and CLI, it drafts tasks, launches experiments, reads results, and helps diagnose frictions in plain language.

## Prerequisites

1. Connect a [model provider](https://docs.oqoqo.ai/setup/model-providers.md) under **Organization settings → Model providers**, or connect **OpenAI (ChatGPT Subscription)** or **Nous Portal** under **Profile → Integrations**.
2. Assign an **Ask Oqo model** under **Organization settings → [Oqoqo AI defaults](https://docs.oqoqo.ai/setup/oqoqo-ai.md)**.

Switch models or effort per chat using the searchable model picker next to the message box. If Ask Oqo needs a model fix, you can still read chats and draft messages while updating settings.

> [!NOTE]
>
> Ask Oqo cannot use **Anthropic (Claude Subscription)** from **Profile → Integrations**. Claude models connected via an Anthropic API key or gateway work as expected.

## Open Ask Oqo

Open Ask Oqo from **Ask Oqo** in the sidebar (full page), the **Ask Oqo** button in any header (side panel—select **Open full page** anytime to move your active chat and draft), the prompt on **Home**, [Slack](https://docs.oqoqo.ai/operate/ask-oqo-in-slack.md), or [your editor](https://docs.oqoqo.ai/operate/ask-oqo-in-editors.md).

The first time you open Ask Oqo in the dashboard, it links to your Oqoqo account automatically (if connection fails, select **Try again**).

![Ask Oqo chat answering which frictions to fix first in an experiment, with its completed tool calls, the model picker, and chat history that marks the chat as completed.](https://mintcdn.com/oqoqo/-Zey-PSefpF3uPZS/images/screenshots/ask-oqo-light.png?fit=max\&auto=format\&n=-Zey-PSefpF3uPZS\&q=85\&s=d64580d506bcda7a5513096173169507)

## What Ask Oqo can do

* Summarize **Matrix** results, rank frictions, and inspect individual run trajectories
* Build complete eval sets, write tasks and rubrics, launch experiments, and schedule runs
* [Wait for experiments](#while-ask-oqo-works), Evals, Insights, or Briefs to finish and report results
* Read [public GitHub repositories](#read-github), Oqoqo docs, and public product documentation URLs
* Write files and run commands in a private chat workspace to prepare and upload task and skill archives

Ask Oqo always presents an **Approve** / **Deny** card before deleting records, launching or relaunching experiments, editing schedules, running Evals or Insights, testing custom agents, publishing results, or overwriting uploaded archives. For secrets or OAuth sign-ins, it returns a dashboard link instead of accepting credentials in chat.

## While Ask Oqo works

* **Live status & tool cards:** Ask Oqo displays live progress and groups sequential tool calls into collapsible cards.
* **Background waiting:** when asked to wait on an experiment, Evals, Insights, or a Brief, Ask Oqo polls in the background (up to 2 hours by default, or up to 12 hours when requested; replies arrive within about 5 minutes of completion). You can send follow-up messages or leave the page and check back later.
* **Steer mid-reply:** type into the input box while Ask Oqo is working and send to incorporate your follow-up, or clear the box and select **Stop**.

## Read GitHub

Ask Oqo reads files, commits, releases, issues, pull requests, and GitHub Actions runs in **public GitHub repositories** (read-only) using the **GitHub** integration on **Profile → Integrations**. If GitHub isn't connected yet, Ask Oqo shows **Sign in with GitHub** right in chat. (Disconnecting GitHub on **Profile → Integrations** also disables GitHub Copilot for your account.)

```text theme={null}
What changed in github/github-mcp-server between its last two releases?
```

## Chat history

Ask Oqo stores chat history per project for **30 days** (ended chats remain readable; select **Start a new chat** to continue).

* **Sidebar & recent chats:** collapse or resize the sidebar, rename chats from your history, and jump to your three latest chats from the main sidebar or **Home → Recent chats**.
* **Statuses & filtering:** filter history by **Working**, **Waiting for you**, **Completed**, **Error**, or **Stopped**.
* **Bulk delete:** open the actions menu beside search to delete all or filtered chats. Deletion removes only your own chats permanently.

## Use Ask Oqo outside the dashboard

* **[In GitHub](https://docs.oqoqo.ai/operate/ask-oqo-in-github.md)** (private beta): mention **@oqoqo-ai** in an issue or pull request, and it answers in the thread with the repository's code.
* **[In Slack](https://docs.oqoqo.ai/operate/ask-oqo-in-slack.md):** message **@Oqoqo** in DMs or channels using your own permissions.
* **[In your editor](https://docs.oqoqo.ai/operate/ask-oqo-in-editors.md):** run `oqoqo acp ask-oqo` inside Zed, JetBrains IDEs, or other ACP editors.
* **[In experiments](https://docs.oqoqo.ai/guides/ask-oqo-custom-agent.md)** (private beta): benchmark Ask Oqo itself as an ACP custom agent.

## Example prompts

```text theme={null}
Show my current project, summarize recent experiments, and list the top frictions.
```

```text theme={null}
Explain why the baseline treatment underperformed the skill treatment on the Matrix.
```

```text theme={null}
Draft a small task and rubric to check our refund docs, then propose an experiment plan.
```

## Next steps

> [card] [Install the Oqoqo Plugin](https://docs.oqoqo.ai/operate/plugin.md)
>
> Give Codex, Claude Code, Cursor, or Copilot full Oqoqo access.

> [card] [Find and fix frictions](https://docs.oqoqo.ai/guides/fix-frictions.md)
>
> Turn top frictions into verified product fixes.

> [card] [Oqoqo AI defaults](https://docs.oqoqo.ai/setup/oqoqo-ai.md)
>
> Choose and override the Ask Oqo model.

> [card] [Read results](https://docs.oqoqo.ai/evaluation/results.md)
>
> Explore Matrix, Comparisons, and Run details.


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