> ## Documentation Index
> Fetch the complete documentation index at: https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Run your first agent

> Start a lane-scoped chat, watch the tool calls, and review the diff.

Agent chat is the fastest way to learn ADE — it shows the whole loop: prompt, tool calls, file changes, terminal output, review, and commit.

## Start the chat

<Steps>
  <Step title="Start a new chat">
    In **Work**, open a new chat. You can pick an existing lane or let ADE create one for the task.
  </Step>

  <Step title="Pick a provider and model">
    Use the default, or choose any verified provider — Claude Code, Codex, Cursor, Factory Droid, or OpenCode — from the model selector.
  </Step>

  <Step title="Send a narrow task">
    Ask for one contained change. Skip broad prompts like "clean up the whole app" for your first run.
  </Step>

  <Step title="Watch tool calls">
    The transcript streams reads, edits, shell commands, and test output as the agent works.
  </Step>

  <Step title="Review the diff">
    Open **Files**, inspect every changed file, run tests if needed, then commit.
  </Step>
</Steps>

<Frame caption="Start a new chat">
  <img src="https://mintcdn.com/ade-ac1c6011-dependabot-github-actions-actions-cache-6/mZiHD0-x8whDsXL3/media/features/agent-chat/new-chat-button.webp?fit=max&auto=format&n=mZiHD0-x8whDsXL3&q=85&s=9b202bee4da81f32150166a1e8529812" alt="Start a new agent chat" width="2592" height="1410" data-path="media/features/agent-chat/new-chat-button.webp" />
</Frame>

<Frame caption="Pick a provider and model">
  <img src="https://mintcdn.com/ade-ac1c6011-dependabot-github-actions-actions-cache-6/mZiHD0-x8whDsXL3/media/features/agent-chat/model-selection.webp?fit=max&auto=format&n=mZiHD0-x8whDsXL3&q=85&s=cdd14ad227d129504339556dc90afefc" alt="Pick a provider and model for the chat" width="1948" height="1350" data-path="media/features/agent-chat/model-selection.webp" />
</Frame>

<Frame caption="Run it in a lane — choose one or let ADE create it">
  <img src="https://mintcdn.com/ade-ac1c6011-dependabot-github-actions-actions-cache-6/mZiHD0-x8whDsXL3/media/features/agent-chat/choose-or-autocreate-lane.webp?fit=max&auto=format&n=mZiHD0-x8whDsXL3&q=85&s=40d93e14cae85fb9671788f2d20615e1" alt="Choose an existing lane or let ADE auto-create one" width="2592" height="1410" data-path="media/features/agent-chat/choose-or-autocreate-lane.webp" />
</Frame>

## First prompt

```text theme={null}
Add a GET /health endpoint that returns { "status": "ok" } and add one test for it.
```

## If the agent gets stuck

<AccordionGroup>
  <Accordion title="Unstick a run" icon="triangle-exclamation">
    * Press **Stop** and ask for a shorter plan.
    * Paste the exact test or build error back into the chat.
    * Switch to a stronger model for the session.
    * Keep the task inside the lane — don't move it to your primary checkout.
  </Accordion>
</AccordionGroup>

## Next

<CardGroup cols={2}>
  <Card title="Agent chat" icon="comments" href="/chat/overview">
    How chats, providers, and tool calls work.
  </Card>

  <Card title="Pull requests" icon="code-pull-request" href="/tools/pull-requests">
    Open a PR once the lane is ready.
  </Card>
</CardGroup>