> For the complete documentation index, see [llms.txt](https://docs.tabnine.com/main/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tabnine.com/main/getting-started/tabnine-agent/how-to-use-tabnine-agent.md).

# How to Use Tabnine Agent

### IDE **Quick Start Guide**

When you open Tabnine in your IDE, look up to the top of the app and select <img src="/files/jnRmcfjFQ6wXX7Z6tKyP" alt="" data-size="line">**Agent**.

Then, before you type into the prompt box at the bottom, select which model you want from the dropdown menu beneath the top menu.

<figure><img src="/files/XArJXD53fODiDvGLYXj6" alt=""><figcaption></figcaption></figure>

Before you prompt, make sure to have a project folder open in your IDE. This is so that Agent has a place to save new project files. Without it, Agent won't work properly.

#### Prompt

Scroll down to the prompt box and **describe** your goal in plain language. Agent's strength is evaluating your end goal and describing what it will to do get you there. This launches Agent into [Plan Mode](/main/getting-started/tabnine-cli/features/plan-mode.md).

This will let you understand exactly what Agent plans to do and precisely how it plans to structure your project.

In this example, we ask Agent to plan out a simple translation application.

<figure><img src="/files/UsuuRfo6hWZxCds6GB6E" alt=""><figcaption></figcaption></figure>

You can see its description of the plan is thorough. It lays out its reasons for each file, shows what the project directory will look like, then asks if we would like it to continue.

<figure><img src="/files/vgDjFYqQOjU5nSdddP1l" alt=""><figcaption></figcaption></figure>

Once that's done, we can tell Agent to proceed or make any notes about changes we would like to see in its plan:

<figure><img src="/files/E1jteTvojtc8W77O8ZdL" alt=""><figcaption></figcaption></figure>

Once you confirm, Agent will generate the files.

You’ll initially be met by a brief “Working…” message below the red Tabnine logo, followed by a description of what Agent intends to do with its response.

#### Approve

It will then ask you for confirmation to <mark style="background-color:blue;">**Run**</mark> or <mark style="color:blue;">**Reject**</mark> the file generation for each file (unless you change this to automatic in the Settings).

<figure><img src="/files/ADskuIaykHJnMVqkocWu" alt=""><figcaption></figcaption></figure>

When it generates the code for a file, you can create that file by hitting the **Apply** button.

To approve changes to a new version of an existing file, select the circled, green checkmark <mark style="color:green;">✓⃝</mark> above the document window (or reject by hitting the red x mark <mark style="color:red;">ⓧ</mark>).

{% hint style="success" %}
This option will only appear if
{% endhint %}

<figure><img src="/files/Em7VIpvJoUYcQUc0gIi8" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
*Do I have to approve “changes” to the file if it’s a new file (i.e., click the green checkmark)?*

No. On the initial creation, you can do without clicking it because there are no additional changes — the file now exists. For edits, absolutely. Once you click the checkmark, it will automatically close both the original file and the window comparing the original file code (in <mark style="color:red;">red</mark>) to highlighted changes (in <mark style="color:green;">green</mark>).
{% endhint %}

***

#### Reject

If you select <mark style="color:blue;">Reject</mark> the request for whatever reason, Tabnine Agent will then clarify it is unable to finish the task, then list a number of other options.

In this case, the terminal command was rejected because it identified the wrong folder.

<figure><img src="/files/AZNJYKq80Ue451nZg18p" alt=""><figcaption></figcaption></figure>

***

Once complete, you can see all the files in your profile folder:

<figure><img src="/files/dLcFs2Kc4f0Ft50q1606" alt=""><figcaption></figcaption></figure>

### Native Tools

Tabnine Agent contains several Native Tools that help it access your project files, create new ones, edit current ones, or search your project context. All of these can be edited in [Settings](/main/getting-started/tabnine-agent/agent-settings.md).

You’ll be met with the following options:

1. Read Project Files
2. Create Project Files
3. Apply Code
4. Read Terminal
5. Run Command
6. List Directory
7. Get Diagnostics
8. Workspace Search

{% hint style="info" %}
You will see indicators for the different Native Tools for most steps of the process. This will help you keep track of Agent’s own workflow. They will appear like this in the conversation with the Agent:

<mark style="color:orange;">•</mark> Exploring and <mark style="color:green;">•</mark> Explored

<mark style="color:orange;">•</mark> Creating and <mark style="color:green;">•</mark> Created

<mark style="color:orange;">•</mark> Reading and <mark style="color:green;">•</mark> Read

<mark style="color:orange;">•</mark> Applying and <mark style="color:green;">•</mark> Applied
{% endhint %}

### Edits

You can directly request changes from Tabnine Agent in the prompt window, specifying what you would like to change and in what way, as seen in this example below:

<figure><img src="/files/4XPl2j2UypxztEjBw8Qo" alt=""><figcaption></figcaption></figure>

### Predefined Slash Commands

When the user inputs “/” at the beginning of a new message (at the beginning or middle of a conversation), it opens a dropdown list of pre-defined slash commands for Tabnine Agent.

When the relevant command is selected, it will have the “command” background.

Current predefined commands include the following:<br>

* `/code-review`
* `/test`
  * Generates focused test cases and implementations for the relevant code changes
* `/describe-pr`

  * Drafts a structured, reviewer-ready pull request description for your changes

  <br>

<figure><img src="/files/nSY9A5yoRvUgvsfxT3Nm" alt=""><figcaption></figcaption></figure>

### Skills in Your IDE

Using the Tabnine IDE plugin, Agent Skills can be configured in two ways, by loading all subdirectories containing `skill.md` files for project-level and user-level skills in two different locations:<br>

1. Project-level skills: `<project-root>/.tabnine/skills/`&#x20;
2. User-level skills: `~/.tabnine/skills/`


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tabnine.com/main/getting-started/tabnine-agent/how-to-use-tabnine-agent.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.