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

# Running a Task

> From a goal to a plan to a finished document — how an agent task actually runs, and one real failure mode to watch for.

Submitting a prompt doesn't generate an answer directly — it produces a plan you review first, then a live-running task you can watch.

<Steps>
  <Step title="Review the plan">
    After you describe what you want (e.g. in **Deep Research** mode), the agent proposes a numbered plan — its research angles, an analysis step, and a final write-up step — with an ETA.

    <Frame>
      <img src="https://mintcdn.com/imagineart/1KCL2GMp1E8xXUlb/images/imagine-computer/imagine-computer-task-step-01.png?fit=max&auto=format&n=1KCL2GMp1E8xXUlb&q=85&s=16a46c5235f2ae9099dad643430f9831" alt="A step-by-step research plan card with Edit Plan and Start Research buttons" width="2880" height="1800" data-path="images/imagine-computer/imagine-computer-task-step-01.png" />
    </Frame>

    There's no drag-and-drop plan editor. Click **Edit Plan** and describe what you want changed in plain language (different ranking criteria, a dropped angle, an added axis) — the agent replies conversationally and regenerates the whole plan.
  </Step>

  <Step title="Start it and watch it work">
    Click **Start Research**. The view splits into two panes: your chat collapses to a short "Working…" status on the left, while the right-hand canvas streams a timestamped log — search angles, result counts, which sources it's reading, and interim takeaways.

    <Frame>
      <img src="https://mintcdn.com/imagineart/1KCL2GMp1E8xXUlb/images/imagine-computer/imagine-computer-task-step-02.png?fit=max&auto=format&n=1KCL2GMp1E8xXUlb&q=85&s=4bc71f731213b4a9f59c2ae8a06dc670" alt="Live two-pane progress view with a timestamped research log on the right and a collapsed chat pane on the left" width="2880" height="1800" data-path="images/imagine-computer/imagine-computer-task-step-02.png" />
    </Frame>
  </Step>

  <Step title="Get the finished document">
    Once research wraps up, the right pane switches into a Google-Docs-style editor titled after your topic, with **Contents**, **Download**, and **Share** controls and a live word count. It's a fully editable rich-text document, not a read-only report — you can keep working in it directly.
  </Step>
</Steps>

## A real failure mode to watch for

In testing, a task reported completion ("Done — the report is in your chat") while the actual document contained only a **Sources** heading — the synthesized write-up itself was silently missing, despite the chat log showing sources had been read and a report was being written. Separately, the stated "4-5 minutes" estimate isn't a reliable ceiling — a research run can still be mid-flight well past that.

<Warning>
  Always open and check the actual document before trusting a "Done" status or relying on it for anything time-sensitive. A completed status is not proof the content is actually there.
</Warning>

## Run modes

There's no separate run-mode pill on the chat prompt bar anymore. Two controls shape how a chat task runs:

* **Model tier**: the dropdown next to the send button (**Flash**, **Pro**, or **Ultra**). See [Model tier](/imagine-computer/getting-started#model-tier).
* **Ask permission**: a toggle in the **+** menu of the prompt box. Off (the default), the agent runs without stopping. On, it's meant to ask before creating or editing artifacts. See [Ask permission](/imagine-computer/getting-started#ask-permission).

<Warning>
  In earlier testing, the approval setting did not actually pause a full research run at any point, including at the report-writing step. Treat every run as if it will continue without stopping.
</Warning>

### Startup modes

**Startup**, the website builder, has its own prompt bar with two different controls.

<Frame>
  <img src="https://mintcdn.com/imagineart/WhPNzW_Qb-MXnMMg/images/imagine-computer/imagine-computer-task-step-03.png?fit=max&auto=format&n=WhPNzW_Qb-MXnMMg&q=85&s=14848e79cc028edbe0a133eec90a7411" alt="Startup prompt box with the Build menu open, showing Plan (Discuss before building) and Build (Make changes directly)" width="800" height="260" data-path="images/imagine-computer/imagine-computer-task-step-03.png" />
</Frame>

* **Plan**: discuss before building.
* **Build**: make changes directly.

<Frame>
  <img src="https://mintcdn.com/imagineart/WhPNzW_Qb-MXnMMg/images/imagine-computer/imagine-computer-task-step-04.png?fit=max&auto=format&n=WhPNzW_Qb-MXnMMg&q=85&s=2249c1fbd2b49a6b4e07734f4d68dfec" alt="Startup prompt box with the Eco menu open, showing Eco, Balanced, and Max, with Max locked" width="980" height="340" data-path="images/imagine-computer/imagine-computer-task-step-04.png" />
</Frame>

* **Eco**: budget-friendly runs that take a bit longer and cost less.
* **Balanced**: a steady mix of speed and quality for everyday builds.
* **Max**: not available on every account. On accounts without it, it shows a lock and "Max is not available on this account."


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