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

# Quickstart

> A 5-minute guide to sending your first request and reviewing and approving the changes the AI makes.

## Open the chat panel

Click the CodePilot icon in the activity bar.

<img src="https://mintcdn.com/banyaai/eM-Nuqr2SnMxEdsc/images/en/IDE_MAIN.png?fit=max&auto=format&n=eM-Nuqr2SnMxEdsc&q=85&s=c9142411a9c5a630ca542436a40e774a" alt="CodePilot main chat screen" width="1920" height="1075" data-path="images/en/IDE_MAIN.png" />

***

## Choose a mode

From the dropdown to the left of the input box, choose the mode that fits your goal.

<img src="https://mintcdn.com/banyaai/eM-Nuqr2SnMxEdsc/images/en/IDE_MODE_DROPDOWN.png?fit=max&auto=format&n=eM-Nuqr2SnMxEdsc&q=85&s=52f85b5be881cf54c62362952edee407" alt="Mode selection dropdown" width="499" height="1015" data-path="images/en/IDE_MODE_DROPDOWN.png" />

| Mode      | File changes | Purpose                                             |
| --------- | :----------: | --------------------------------------------------- |
| **CODE**  |       O      | Create, edit, and delete files; run commands        |
| **AGENT** |       O      | Break down complex tasks and handle them on its own |
| **ASK**   |       X      | Questions and analysis                              |
| **PLAN**  |       X      | Draft an implementation plan first                  |

For the full breakdown, see the [Chat modes](/en/ide/chat-modes) documentation.

***

## Try your first request

### Understanding code (ASK)

```
Explain the current project structure. Walk me through the main directories and the role of each file.
```

ASK mode only answers — it doesn't modify code. Try it first when getting your bearings in an unfamiliar codebase.

### Building a feature (CODE)

```
Create a login form component in the src/components/ directory.
Include email and password inputs, a submit button, and validation.
```

CODE mode has the AI create and modify files directly.

### Handing off a goal (AGENT)

```
Add a refund feature to the payment module, write the related tests, and then run the full test suite.
```

AGENT mode takes a goal, breaks the work down on its own, and follows through with verification after editing files. If you use a frontier model, we recommend AGENT mode.

### Planning first (PLAN)

```
I want to add an authentication system. How should I implement JWT-based login, logout, and token refresh?
```

PLAN mode presents an implementation plan first without touching any files. It's useful for checking the scope of impact before a large task.

***

## Attaching context

Type **`@`** in the input box to pick the context you want to hand to the AI.

<img src="https://mintcdn.com/banyaai/eM-Nuqr2SnMxEdsc/images/en/IDE_CHAT_AT.png?fit=max&auto=format&n=eM-Nuqr2SnMxEdsc&q=85&s=b3f33cc47564c2e2481423938e25afed" alt="@ menu" width="453" height="248" data-path="images/en/IDE_CHAT_AT.png" />

```
@src/api/auth.ts Improve the token expiration handling logic in this file.
```

Type **`/`** to use shortcut commands such as commit, review, and session management.

<img src="https://mintcdn.com/banyaai/eM-Nuqr2SnMxEdsc/images/en/IDE_CHAT_SLASH.png?fit=max&auto=format&n=eM-Nuqr2SnMxEdsc&q=85&s=6ff59a0d78a096b8be3e9162ca856b5e" alt="Slash command menu" width="454" height="286" data-path="images/en/IDE_CHAT_SLASH.png" />

***

## Approving / undoing changes

When the AI modifies a file, the changes are shown in the editor as an inline diff.

<img src="https://mintcdn.com/banyaai/eM-Nuqr2SnMxEdsc/images/en/IDE_DIFF.png?fit=max&auto=format&n=eM-Nuqr2SnMxEdsc&q=85&s=9c39221686e46b9f78e4548b57ec97a6" alt="Diff screen" width="1693" height="694" data-path="images/en/IDE_DIFF.png" />

* **Keep** — Apply the change.
* **Undo** — Revert the change.

You can also handle everything at once in the **Pending changes** area at the bottom of the chat panel.

| Shortcut                                  | Action            |
| ----------------------------------------- | ----------------- |
| `Ctrl+Enter` (macOS: `Cmd+Enter`)         | Apply all changes |
| `Ctrl+Backspace` (macOS: `Cmd+Backspace`) | Undo all changes  |

<Warning>
  CODE and AGENT modes change actual files. Check your Git commit state before any important work.
</Warning>

***

## Running multiple tasks at once

Large requests are automatically split into several subtasks and processed in parallel. You can track progress in real time in the task list in the chat panel.

<img src="https://mintcdn.com/banyaai/eM-Nuqr2SnMxEdsc/images/en/IDE_JOB_QUEUE.png?fit=max&auto=format&n=eM-Nuqr2SnMxEdsc&q=85&s=0d6797233de9bdb69455b0b19312a766" alt="Task progress" width="352" height="332" data-path="images/en/IDE_JOB_QUEUE.png" />

```
Build an internal employee benefits portal.
- A React + TypeScript frontend in the front/ directory
- A FastAPI backend in the server/ directory
- Use PostgreSQL for the database
```

***

## Reviewing the results

When the AI finishes, it shows a summary of what it did and a list of the files that changed.

<img src="https://mintcdn.com/banyaai/eM-Nuqr2SnMxEdsc/images/en/IDE_COMPLETE_1.png?fit=max&auto=format&n=eM-Nuqr2SnMxEdsc&q=85&s=401d3a48fdc198d6f436a323996615eb" alt="Task complete" width="445" height="694" data-path="images/en/IDE_COMPLETE_1.png" />

Below the response, you can confirm this turn's changes all at once or expand the list of files the AI referenced.

<img src="https://mintcdn.com/banyaai/eM-Nuqr2SnMxEdsc/images/en/IDE_COMPLETE_2.png?fit=max&auto=format&n=eM-Nuqr2SnMxEdsc&q=85&s=bf988bbaf66e8c104fb2e93c590cc67e" alt="Referenced documents" width="455" height="700" data-path="images/en/IDE_COMPLETE_2.png" />

***

## Next steps

<CardGroup cols={2}>
  <Card title="Chat modes" icon="layer-group" href="/en/ide/chat-modes">
    How to use CODE / AGENT / ASK / PLAN
  </Card>

  <Card title="Key features" icon="list-check" href="/en/ide/features">
    Automatic error fixing, security guardrails, RAG
  </Card>

  <Card title="Settings" icon="gear" href="/en/ide/settings">
    AI models, build verification, security settings
  </Card>
</CardGroup>
