# Source: https://docs.replit.com/replitai/agent.md

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

# Replit Agent

> Replit Agent uses AI to set up and create apps from scratch. Describe your app in everyday language, and it can set up and create your Replit App in minutes.

export const YouTubeEmbed = ({videoId, title = "YouTube video", startAt}) => {
  if (!videoId) {
    return null;
  }
  let url = "https://www.youtube.com/embed/" + videoId;
  if (startAt) {
    url = url + "?start=" + startAt;
  }
  return <Frame>
      <iframe src={url} title={title} allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowFullScreen></iframe>
    </Frame>;
};

export const TeamsCredits = '$40';

export const CoreCredits = '$25';

Agent uses powerful AI technology to transform your ideas into applications
and seamlessly add new features by describing what you want.

<Tip>
  **New with Agent 3** - Extended autonomous builds with minimal supervision,
  App Testing for self-validation, Fast and Full build modes, and Agents & Automations
  for building your own autonomous systems.
</Tip>

<YouTubeEmbed videoId="nr6qrQTv7QI" title="Now Available: Replit Agent 3" />

## Features

<Info>
  Agent uses powerful AI technology to create your apps, leveraging
  industry-leading models to deliver the best results.
</Info>

Chat with Agent in your Replit App to receive the following support:

* Create full-stack apps from scratch
* Add advanced features and integrate complex APIs
* Design, create, and modify database structures
* Streamline environment setup and dependency management

## Creating Apps

When starting a new project on Replit, you have two options on the homepage:

* **App**: Build full-stack applications, websites with backends, AI-powered apps, and more
* **Design**: Create slides, static websites, prototypes, and visual designs (see [Design Mode](/replitai/design-mode))

<Frame>
  <img src="https://mintcdn.com/replit/6KciCEIm5HrhSv3n/images/replitai/app-vs-design.png?fit=max&auto=format&n=6KciCEIm5HrhSv3n&q=85&s=53e69e48babddba6a8ad71080beb14ab" alt="Replit homepage showing App and Design tabs for creating new projects" data-og-width="1294" width="1294" data-og-height="746" height="746" data-path="images/replitai/app-vs-design.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/replit/6KciCEIm5HrhSv3n/images/replitai/app-vs-design.png?w=280&fit=max&auto=format&n=6KciCEIm5HrhSv3n&q=85&s=d93ca3651211e76afac65b9e61897347 280w, https://mintcdn.com/replit/6KciCEIm5HrhSv3n/images/replitai/app-vs-design.png?w=560&fit=max&auto=format&n=6KciCEIm5HrhSv3n&q=85&s=4263e592c7addf7339e1fc16b3528d65 560w, https://mintcdn.com/replit/6KciCEIm5HrhSv3n/images/replitai/app-vs-design.png?w=840&fit=max&auto=format&n=6KciCEIm5HrhSv3n&q=85&s=cbb2436d4cf07e6fce707f5a82090bf4 840w, https://mintcdn.com/replit/6KciCEIm5HrhSv3n/images/replitai/app-vs-design.png?w=1100&fit=max&auto=format&n=6KciCEIm5HrhSv3n&q=85&s=993a4060d1f3736ac6273fcd8aafe808 1100w, https://mintcdn.com/replit/6KciCEIm5HrhSv3n/images/replitai/app-vs-design.png?w=1650&fit=max&auto=format&n=6KciCEIm5HrhSv3n&q=85&s=25668ec5a7a901efce62a7337d9165dc 1650w, https://mintcdn.com/replit/6KciCEIm5HrhSv3n/images/replitai/app-vs-design.png?w=2500&fit=max&auto=format&n=6KciCEIm5HrhSv3n&q=85&s=41231b7eb5b08800e8b6c7383a08745b 2500w" />
</Frame>

This section covers building Apps with Agent.

### Stack selection

When you type your prompt in the App tab, Agent automatically suggests an app type based on your description:

* **Web App**: Most common—full-stack web applications with frontend and backend
* **Data App**: Data-focused applications with visualization and analysis
* **Other types**: Agent may suggest other specialized technology stacks based on your needs

After auto-classification, you can change the App type using a dropdown if the suggested one doesn't match your vision.

<Info>
  Most projects are classified as Web Apps. If you're unsure, start with the Replit-suggested App type.
</Info>

### Build modes

After entering your prompt, you have two key choices which affect how Agent builds your app:

#### Fast build vs. full build

Choose your build speed based on your needs. Select the ⚡ lightning bolt icon in the prompt box to enable Fast build, or leave it off for Full build.

| Mode           | Duration      | Best For                                                    |
| -------------- | ------------- | ----------------------------------------------------------- |
| **Fast**       | \~3-5 minutes | Quick prototypes, lightweight apps                          |
| **Full build** | 10+ minutes   | Complex apps, comprehensive features, hands-off development |

**Key differences:**

* **Fast build**: Select the ⚡ icon in the prompt box. Agent works quickly to create a working version. Great for rapid prototyping and when you want to stay engaged with the build process.
* **Full build**: Leave the ⚡ icon unselected. Agent uses more autonomy from the first build and tests its own work. Results in more polished, comprehensive applications but takes longer.

<Note>
  **Web Apps only**: Fast is currently only available for Web Apps.
</Note>

#### Build vs. Plan

Choose when Agent starts building:

* **Build**: Agent immediately starts building your app based on your prompt
* **Plan**: Agent creates an initial plan that you can review and iterate on before building begins

**When to use Plan mode:**

* You want to refine requirements before committing to a build
* You're exploring different approaches to a complex problem
* You need to align on scope with stakeholders before development

Learn more about [Plan Mode](/replitai/plan-mode) for collaborative planning workflows.

## Autonomous Features (New in Agent 3)

Agent 3 introduces powerful autonomous capabilities that enable extended, self-supervised development with minimal human intervention.

<Note>
  **Core and Teams only**: Autonomous mode features require a Core or Teams subscription.
</Note>

### App Testing

**Automated browser testing** - Agent tests itself using an actual browser, navigating through your application like a real user would.

**Key capabilities:**

* **Real user simulation**: Agent clicks through your app, testing functionality and user workflows
* **Automatic issue detection**: Identifies problems and fixes them during development
* **Visual feedback**: Provides video replays of testing sessions for review
* **Intelligent timing**: Agent decides when testing would be most valuable

**Usage**: Toggle "App testing" in the Agent Tools panel. When enabled, Agent intelligently decides when testing adds the most value.

<Frame>
  <img src="https://mintcdn.com/replit/fq3p5W3K0mVwvlo1/images/replitai/app-testing-toggle-on.png?fit=max&auto=format&n=fq3p5W3K0mVwvlo1&q=85&s=c5d005615afe2475bb061ebd2b77746b" alt="Agent Tools interface showing App testing toggle enabled with description" data-og-width="790" width="790" data-og-height="676" height="676" data-path="images/replitai/app-testing-toggle-on.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/replit/fq3p5W3K0mVwvlo1/images/replitai/app-testing-toggle-on.png?w=280&fit=max&auto=format&n=fq3p5W3K0mVwvlo1&q=85&s=ba6b762fbe5730894324cc7d6212480b 280w, https://mintcdn.com/replit/fq3p5W3K0mVwvlo1/images/replitai/app-testing-toggle-on.png?w=560&fit=max&auto=format&n=fq3p5W3K0mVwvlo1&q=85&s=b6730785f3cf14a1bb9eaddd95a55320 560w, https://mintcdn.com/replit/fq3p5W3K0mVwvlo1/images/replitai/app-testing-toggle-on.png?w=840&fit=max&auto=format&n=fq3p5W3K0mVwvlo1&q=85&s=9807008811156ba5462eccd096dca81a 840w, https://mintcdn.com/replit/fq3p5W3K0mVwvlo1/images/replitai/app-testing-toggle-on.png?w=1100&fit=max&auto=format&n=fq3p5W3K0mVwvlo1&q=85&s=174e0482dc7723899ead32d2684114e9 1100w, https://mintcdn.com/replit/fq3p5W3K0mVwvlo1/images/replitai/app-testing-toggle-on.png?w=1650&fit=max&auto=format&n=fq3p5W3K0mVwvlo1&q=85&s=09ff5aea756b118284f9d13fe41a7d16 1650w, https://mintcdn.com/replit/fq3p5W3K0mVwvlo1/images/replitai/app-testing-toggle-on.png?w=2500&fit=max&auto=format&n=fq3p5W3K0mVwvlo1&q=85&s=19196178de37b248aa5045d1b4b1a82b 2500w" />
</Frame>

Learn more about [App Testing](/replitai/app-testing) capabilities and troubleshooting.

### Max Autonomy (Beta)

**Extended autonomous development** - Agent works for much longer periods with minimal supervision. Learn more about [Autonomy Level settings](/replitai/autonomy-level) and how to choose the right level for your project.

**Key benefits:**

* **Extended work sessions**: Agent can work much longer without requiring input
* **Longer-tasklist handling**: Creates much longer task lists to complete more functionality
* **Reduced supervision**: Agent will supervise itself, so you don't have to (runs up to 200 minutes)

**Usage**: Turn on "Max autonomy" in the Agent Tools panel under the Autonomy Level based on your comfort level with autonomous development. This feature is currently in Beta.

<Frame>
  <img src="https://mintcdn.com/replit/YBG_cdNEwjn6sUBd/images/replitai/max-autonomy-level.png?fit=max&auto=format&n=YBG_cdNEwjn6sUBd&q=85&s=ee206296f46a60e96dd8766665ff5c41" alt="Agent Tools interface showing Max autonomy toggle enabled with Beta label" data-og-width="748" width="748" data-og-height="694" height="694" data-path="images/replitai/max-autonomy-level.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/replit/YBG_cdNEwjn6sUBd/images/replitai/max-autonomy-level.png?w=280&fit=max&auto=format&n=YBG_cdNEwjn6sUBd&q=85&s=a4b3660ae2e7aef981c6937d830efdac 280w, https://mintcdn.com/replit/YBG_cdNEwjn6sUBd/images/replitai/max-autonomy-level.png?w=560&fit=max&auto=format&n=YBG_cdNEwjn6sUBd&q=85&s=5286da78b4fdb4858a2b3562c3d2bdca 560w, https://mintcdn.com/replit/YBG_cdNEwjn6sUBd/images/replitai/max-autonomy-level.png?w=840&fit=max&auto=format&n=YBG_cdNEwjn6sUBd&q=85&s=ca2ef939abcf4eaf62ff0fbf485bd735 840w, https://mintcdn.com/replit/YBG_cdNEwjn6sUBd/images/replitai/max-autonomy-level.png?w=1100&fit=max&auto=format&n=YBG_cdNEwjn6sUBd&q=85&s=2d6d29d204f1f15dd1ac1b4ec7a5c37e 1100w, https://mintcdn.com/replit/YBG_cdNEwjn6sUBd/images/replitai/max-autonomy-level.png?w=1650&fit=max&auto=format&n=YBG_cdNEwjn6sUBd&q=85&s=b6ffaf110ba9b82ffdee479071fe2198 1650w, https://mintcdn.com/replit/YBG_cdNEwjn6sUBd/images/replitai/max-autonomy-level.png?w=2500&fit=max&auto=format&n=YBG_cdNEwjn6sUBd&q=85&s=b45706fbc0638dea274c2152e6e4ea75 2500w" />
</Frame>

### Agents & Automations

**Beyond traditional apps** - Build intelligent agents, chatbots, and automated workflows that interact with external services.

<Note>
  Agents & Automations is currently in beta. Your automation must be deployed to
  function with external triggers like Slack or Telegram.
</Note>

**Supported use cases:**

* **Slack Agents**: Intelligent Slackbots for research, Q\&A, and task automation
* **Telegram Bots**: Customer service, scheduling, and entertainment bots
* **Timed Automations**: Scheduled workflows for reports, summaries, and monitoring

**Getting started**: Select "Agents & Automations" from the Replit homepage app type selector to begin building automated systems.

<Frame>
  <img src="https://mintcdn.com/replit/fq3p5W3K0mVwvlo1/images/replitai/agents-automations-homepage-2.png?fit=max&auto=format&n=fq3p5W3K0mVwvlo1&q=85&s=ec25b745f7f0e9d95e0af74d2dcb6515" alt="Replit homepage showing Agents & Automations selection with Beta label and prompt input area" data-og-width="3024" width="3024" data-og-height="1720" height="1720" data-path="images/replitai/agents-automations-homepage-2.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/replit/fq3p5W3K0mVwvlo1/images/replitai/agents-automations-homepage-2.png?w=280&fit=max&auto=format&n=fq3p5W3K0mVwvlo1&q=85&s=5883ef5ebf084203769864895fcb8efe 280w, https://mintcdn.com/replit/fq3p5W3K0mVwvlo1/images/replitai/agents-automations-homepage-2.png?w=560&fit=max&auto=format&n=fq3p5W3K0mVwvlo1&q=85&s=ec76976d9e55ac89cd51034a3a6598c5 560w, https://mintcdn.com/replit/fq3p5W3K0mVwvlo1/images/replitai/agents-automations-homepage-2.png?w=840&fit=max&auto=format&n=fq3p5W3K0mVwvlo1&q=85&s=3fe988967420714ecf6580f755d828a1 840w, https://mintcdn.com/replit/fq3p5W3K0mVwvlo1/images/replitai/agents-automations-homepage-2.png?w=1100&fit=max&auto=format&n=fq3p5W3K0mVwvlo1&q=85&s=b8b4d52bb93b9d3e69b937bf9011fc72 1100w, https://mintcdn.com/replit/fq3p5W3K0mVwvlo1/images/replitai/agents-automations-homepage-2.png?w=1650&fit=max&auto=format&n=fq3p5W3K0mVwvlo1&q=85&s=acfca4c11edebf2c7e0b826345151cda 1650w, https://mintcdn.com/replit/fq3p5W3K0mVwvlo1/images/replitai/agents-automations-homepage-2.png?w=2500&fit=max&auto=format&n=fq3p5W3K0mVwvlo1&q=85&s=472b699cdbf333e64401d4437f3c0002 2500w" />
</Frame>

Learn more about [Agents & Automations](/replitai/agents-and-automations) use cases and setup.

## Usage

You can access Agent in your Replit App workspace by selecting the Agent tool.

<Accordion title="How to access Agent">
  From the **Create a new App** screen, select the **Replit Agent** tab to enter a description of the app you want as shown in the following animation:

  <Frame>
    <img src="https://mintcdn.com/replit/AZ1L8RlIroSxuJDa/images/replitai/agent-start-building.avif?fit=max&auto=format&n=AZ1L8RlIroSxuJDa&q=85&s=132104b9caa4c832a48387532886f51e" alt="animation showing Agent in the Create a new App screen" data-path="images/replitai/agent-start-building.avif" />
  </Frame>

  If viewing a Replit App started by Agent, you can locate the Agent tool in your workspace in one of the following locations:

  From the left tool dock, select <img class="icon-svg" src="https://mintcdn.com/replit/rBzGsKp9NcWJ7sib/images/icons/agent_icon.svg?fit=max&auto=format&n=rBzGsKp9NcWJ7sib&q=85&s=4aaa46ea144fd055c19515360c3e54e0" alt="Agent icon" data-og-width="24" width="24" data-og-height="25" height="25" data-path="images/icons/agent_icon.svg" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/replit/rBzGsKp9NcWJ7sib/images/icons/agent_icon.svg?w=280&fit=max&auto=format&n=rBzGsKp9NcWJ7sib&q=85&s=a1e59f8c5158ea6de7129ef20d5a4ef7 280w, https://mintcdn.com/replit/rBzGsKp9NcWJ7sib/images/icons/agent_icon.svg?w=560&fit=max&auto=format&n=rBzGsKp9NcWJ7sib&q=85&s=cc44739441b4392f9d81b316de6d5101 560w, https://mintcdn.com/replit/rBzGsKp9NcWJ7sib/images/icons/agent_icon.svg?w=840&fit=max&auto=format&n=rBzGsKp9NcWJ7sib&q=85&s=dd03ff2eea4de9fb2c05cadc9c43fcd2 840w, https://mintcdn.com/replit/rBzGsKp9NcWJ7sib/images/icons/agent_icon.svg?w=1100&fit=max&auto=format&n=rBzGsKp9NcWJ7sib&q=85&s=54afa04aff1a5fc4586f246534982338 1100w, https://mintcdn.com/replit/rBzGsKp9NcWJ7sib/images/icons/agent_icon.svg?w=1650&fit=max&auto=format&n=rBzGsKp9NcWJ7sib&q=85&s=96a1c41c81a076c74ffb614ab00d7c9a 1650w, https://mintcdn.com/replit/rBzGsKp9NcWJ7sib/images/icons/agent_icon.svg?w=2500&fit=max&auto=format&n=rBzGsKp9NcWJ7sib&q=85&s=4f9db91f36f4536fe93b152c8a60cd4b 2500w" /> **Agent** as shown
  in the following animation:

  <Frame>
    <img src="https://mintcdn.com/replit/AZ1L8RlIroSxuJDa/images/replitai/agent-from-dock.avif?fit=max&auto=format&n=AZ1L8RlIroSxuJDa&q=85&s=0368c2ee2414d7c5715f243205af38be" alt="animation showing Agent selection from the dock" data-path="images/replitai/agent-from-dock.avif" />
  </Frame>

  From the **Search bar**:

  1. Select the <img class="icon-svg" src="https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/workspace-search-icon.svg?fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=4a0eb8f6b17ff6761d53167334a68b30" alt="magnifying glass icon" data-og-width="16" width="16" data-og-height="16" height="16" data-path="images/icons/workspace-search-icon.svg" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/workspace-search-icon.svg?w=280&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=baa20919b2c8e7db2fad2562c732edd0 280w, https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/workspace-search-icon.svg?w=560&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=5fcfa3935da89ed6c1c6f893998c4f4a 560w, https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/workspace-search-icon.svg?w=840&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=2a24f3fcc4dd990d9062598eab165cff 840w, https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/workspace-search-icon.svg?w=1100&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=a3258e068d5ead6bacadcbe6e5785575 1100w, https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/workspace-search-icon.svg?w=1650&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=d08ebecb3063ed18a657beb563ac9c3c 1650w, https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/workspace-search-icon.svg?w=2500&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=e63dd2009929a4b375b86e44ed6d7732 2500w" /> magnifying glass at the top to open the search tool
  2. Type "Agent" to locate the Agent tool and select it from the results
</Accordion>

From the Agent tool, you can perform the following actions:

* **Chat**: Describe your app or feature in the text area and respond to Agent's follow-up questions
* **Add detailed requests**: Upload files or import content from URLs to give Agent more information
* **Manage conversations**: Select **New chat** or select previous conversations from the <img class="icon-svg" src="https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/manage-chats-menu.svg?fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=f2f1a6e7b1f15d5b2872e17c3f20c225" alt="menu icon" data-og-width="16" width="16" data-og-height="16" height="16" data-path="images/icons/manage-chats-menu.svg" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/manage-chats-menu.svg?w=280&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=dbdb56f439f91ffe4cee7f3dec524745 280w, https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/manage-chats-menu.svg?w=560&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=e19235692660ac62efd538a3926ba516 560w, https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/manage-chats-menu.svg?w=840&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=a0bfc54f5aaa77d80a538637f8419c2d 840w, https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/manage-chats-menu.svg?w=1100&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=31e527219103051b532ebbc58758ee60 1100w, https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/manage-chats-menu.svg?w=1650&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=6315e4a8bfcb9f3c54727a4916256862 1650w, https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/manage-chats-menu.svg?w=2500&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=db658f70c776954f0dc0719ca3fee1ec 2500w" /> menu icon to start or resume a conversation
* **Track usage**: Select the <img class="icon-svg" src="https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/usage-icon.svg?fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=afedaf18cbe1d4549be6e7833c88c269" alt="usage icon" data-og-width="16" width="16" data-og-height="16" height="16" data-path="images/icons/usage-icon.svg" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/usage-icon.svg?w=280&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=d5746213e15396325c7772f33084a4b5 280w, https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/usage-icon.svg?w=560&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=31e3306f672210e2d9d4c1a0284be5fb 560w, https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/usage-icon.svg?w=840&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=971452a359f72a20a7170f4c07bb6ea0 840w, https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/usage-icon.svg?w=1100&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=5e04ff80266d49ad695d29d09a05a106 1100w, https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/usage-icon.svg?w=1650&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=cc48eb084ae86bff8f1a5beefdc0d332 1650w, https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/usage-icon.svg?w=2500&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=4c7f0bfca699d607e695cc4439b52de1 2500w" /> usage icon at the top right to view your billing page
* **Reverse changes**: Undo changes made by Agent by selecting <img class="icon-svg" src="https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/rollback-icon.svg?fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=34791076a8d31ed55a923fff97179a6f" alt="rollback icon" data-og-width="12" width="12" data-og-height="12" height="12" data-path="images/icons/rollback-icon.svg" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/rollback-icon.svg?w=280&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=f4c01c9de40b3f082ec90b725d68c13d 280w, https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/rollback-icon.svg?w=560&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=81eebf41994b2b6efaa2155ed2bd3030 560w, https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/rollback-icon.svg?w=840&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=db132485bb79a63b97a4afd74d879864 840w, https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/rollback-icon.svg?w=1100&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=a4bf6a6fa2b53af44b23b3a1c0546b79 1100w, https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/rollback-icon.svg?w=1650&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=8e829bfcacb9e2d7c53406f9411a9039 1650w, https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/rollback-icon.svg?w=2500&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=36866c365d865b45e0216641e343779b 2500w" /> **Rollback to here**

### Chat prompts

<img src="https://mintcdn.com/replit/pnpczhK4itt7pXl2/images/replitai/updated-v3-chat-window.png?fit=max&auto=format&n=pnpczhK4itt7pXl2&q=85&s=2b71a7e363837be3f9466a9c7c0a6e67" alt="Agent chat interface with Make, test, iterate header and build options" data-og-width="922" width="922" data-og-height="175" height="175" data-path="images/replitai/updated-v3-chat-window.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/replit/pnpczhK4itt7pXl2/images/replitai/updated-v3-chat-window.png?w=280&fit=max&auto=format&n=pnpczhK4itt7pXl2&q=85&s=c7962510fb1d9cdc05896e608a553323 280w, https://mintcdn.com/replit/pnpczhK4itt7pXl2/images/replitai/updated-v3-chat-window.png?w=560&fit=max&auto=format&n=pnpczhK4itt7pXl2&q=85&s=f3118a67f36f11ed24099d5ce6d3e7e7 560w, https://mintcdn.com/replit/pnpczhK4itt7pXl2/images/replitai/updated-v3-chat-window.png?w=840&fit=max&auto=format&n=pnpczhK4itt7pXl2&q=85&s=3a864847bca9f76ad7fab8b46242acf4 840w, https://mintcdn.com/replit/pnpczhK4itt7pXl2/images/replitai/updated-v3-chat-window.png?w=1100&fit=max&auto=format&n=pnpczhK4itt7pXl2&q=85&s=3d3d7bf094ac47c5afd82c493c86a135 1100w, https://mintcdn.com/replit/pnpczhK4itt7pXl2/images/replitai/updated-v3-chat-window.png?w=1650&fit=max&auto=format&n=pnpczhK4itt7pXl2&q=85&s=49e62f7e798ee52498babd243fbc5919 1650w, https://mintcdn.com/replit/pnpczhK4itt7pXl2/images/replitai/updated-v3-chat-window.png?w=2500&fit=max&auto=format&n=pnpczhK4itt7pXl2&q=85&s=27152a7f5e46da63c96db4fb537018d7 2500w" />

To communicate your request to Agent, enter a **prompt** in the text area.
A prompt is a natural language instruction that describes the task you want Agent to perform.

In addition to text, you can include the following data in your prompt:

* **File attachments**: Drag a file into the text area or select the <img class="icon-svg" src="https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/paperclip-icon.svg?fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=45949f269700584b5abce83018948efd" alt="Paperclip icon" data-og-width="16" width="16" data-og-height="16" height="16" data-path="images/icons/paperclip-icon.svg" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/paperclip-icon.svg?w=280&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=20637e43d92832822bac672894536c45 280w, https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/paperclip-icon.svg?w=560&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=48afdd5748452937f68d924dadba078c 560w, https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/paperclip-icon.svg?w=840&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=6f6c0cb9f5f50ab2b0d6ec1e9103c981 840w, https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/paperclip-icon.svg?w=1100&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=41dd59447d7a8d7370a13243f28b3936 1100w, https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/paperclip-icon.svg?w=1650&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=c457d89082fe14f8d91c206c5e0a981a 1650w, https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/paperclip-icon.svg?w=2500&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=97e8124e2a60e38994e0536971d52f67 2500w" /> paperclip icon
* **Web content**: Include text data from a webpage by entering a URL and selecting **Copy page content**
* **Webpage screenshots**: Include a screenshot of a webpage by entering a URL and selecting **Take screenshot**

Agent operates in three distinct modes to support different types of work:

* **Build mode** (default): Agent writes code, modifies files, and implements features directly in your project
* **Plan mode**: Brainstorm ideas, plan development work, and collaborate on project architecture without modifying code. Learn more about [Plan mode](/replitai/plan-mode)
* **Edit mode**: Make targeted changes to specific files or code sections with precise control

**All Agent interactions are billable** - whether Agent responds with text guidance or makes code changes, there is always a charge, though smaller requests cost less.

### Checkpoints

<img src="https://mintcdn.com/replit/pnpczhK4itt7pXl2/images/replitai/updated-v3-checkpoint.png?fit=max&auto=format&n=pnpczhK4itt7pXl2&q=85&s=1cf06bf550cc671d1c29677309d7e1c9" alt="Agent checkpoint with interactive map and rollback options" data-og-width="924" width="924" data-og-height="306" height="306" data-path="images/replitai/updated-v3-checkpoint.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/replit/pnpczhK4itt7pXl2/images/replitai/updated-v3-checkpoint.png?w=280&fit=max&auto=format&n=pnpczhK4itt7pXl2&q=85&s=015361934ff2b7553e45e019c33641da 280w, https://mintcdn.com/replit/pnpczhK4itt7pXl2/images/replitai/updated-v3-checkpoint.png?w=560&fit=max&auto=format&n=pnpczhK4itt7pXl2&q=85&s=504101b5ff23c77eab546f3c175b6b0b 560w, https://mintcdn.com/replit/pnpczhK4itt7pXl2/images/replitai/updated-v3-checkpoint.png?w=840&fit=max&auto=format&n=pnpczhK4itt7pXl2&q=85&s=ded3d57a358b7f2498929fdc00ecbf32 840w, https://mintcdn.com/replit/pnpczhK4itt7pXl2/images/replitai/updated-v3-checkpoint.png?w=1100&fit=max&auto=format&n=pnpczhK4itt7pXl2&q=85&s=5295974014851e7859b8122cc5c77dad 1100w, https://mintcdn.com/replit/pnpczhK4itt7pXl2/images/replitai/updated-v3-checkpoint.png?w=1650&fit=max&auto=format&n=pnpczhK4itt7pXl2&q=85&s=4bcf9999c62e6235550dd4ac2ee94217 1650w, https://mintcdn.com/replit/pnpczhK4itt7pXl2/images/replitai/updated-v3-checkpoint.png?w=2500&fit=max&auto=format&n=pnpczhK4itt7pXl2&q=85&s=15795948b09d9110d78984f5fc7511b0 2500w" />

A **checkpoint** is a comprehensive snapshot of your Replit App that captures completed work from Agent, including workspace contents, AI conversation context, and connected databases.
Agent creates checkpoints when it finishes implementing your request, ensuring you only pay for completed functionality.

<YouTubeEmbed videoId="iLOxO1FBZls" title="Checkpoints" />

#### How checkpoints work with effort-based pricing

Agent's new effort-based pricing creates checkpoints that reflect the actual work performed:

* **One checkpoint per request**: Agent bundles all work for your request into a single, meaningful checkpoint
* **Variable pricing**: Simple changes cost less, while complex builds cost more based on the effort required
* **Transparent costs**: Each checkpoint shows exactly what you're paying for that completed work
* **No intermediate billing**: You're not charged for Agent's thinking or planning process

Each checkpoint lets you perform the following actions:

* **Rollback**: Undo changes made by Agent and return to the state of the previous checkpoint, including workspace contents and AI memory; connected databases can also be restored when selected
* **Track usage**: Hover over the <img class="icon-svg" src="https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/usage-icon.svg?fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=afedaf18cbe1d4549be6e7833c88c269" alt="usage icon" data-og-width="16" width="16" data-og-height="16" height="16" data-path="images/icons/usage-icon.svg" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/usage-icon.svg?w=280&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=d5746213e15396325c7772f33084a4b5 280w, https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/usage-icon.svg?w=560&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=31e3306f672210e2d9d4c1a0284be5fb 560w, https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/usage-icon.svg?w=840&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=971452a359f72a20a7170f4c07bb6ea0 840w, https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/usage-icon.svg?w=1100&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=5e04ff80266d49ad695d29d09a05a106 1100w, https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/usage-icon.svg?w=1650&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=cc48eb084ae86bff8f1a5beefdc0d332 1650w, https://mintcdn.com/replit/7jcTEkTXPQwUz2BL/images/icons/usage-icon.svg?w=2500&fit=max&auto=format&n=7jcTEkTXPQwUz2BL&q=85&s=4c7f0bfca699d607e695cc4439b52de1 2500w" /> usage icon
  in a checkpoint to view the amount billed for that checkpoint

<Info>
  For comprehensive details about what checkpoints capture and how rollbacks
  work across your entire development environment, see [Checkpoints and
  Rollbacks](/replitai/checkpoints-and-rollbacks).
</Info>

<Info>
  Agent uses effort-based pricing where you pay based on the complexity and
  scope of your request. Simple changes typically cost less than complex builds.
  Learn more about [Agent billing](/billing/ai-billing#agent-billing).
</Info>

### Progress tab

The **Progress** tab shows a record of Agent's actions in real-time. Access it through the Tools dock or search bar to monitor Agent's progress and navigate directly to relevant files.

**Key features:**

* **Real-time updates**: Monitor Agent's progress with live activity feed
* **Chronological history**: Review Agent's activities to understand changes and troubleshoot issues
* **File navigation**: Click links to jump directly to files Agent is working on

## Getting the most from Agent

### Best practices for prompts

* **Be specific**: Describe exactly what you want your app to do
* **Provide context**: Include relevant files, URLs, or examples
* **Start simple**: Begin with basic functionality and add complexity gradually
* **Use examples**: Show Agent similar apps or features you want to emulate
* **Choose your mode thoughtfully**: Consider your timeline, certainty about requirements, and development style

### Managing costs effectively

* **Start with free planning**: Review Agent's implementation plan before approving work
* **Use simple requests**: Break complex projects into smaller, focused tasks
* **Set spending limits**: Configure [usage alerts and budgets](/billing/managing-spend) to control costs
* **Monitor usage**: Track checkpoint costs to understand pricing patterns

## Next steps

Ready to start building with Agent? Here's how to begin:

1. **Create your first app**: Use the [Create with AI quickstart](/getting-started/quickstarts/ask-ai/)
2. **Choose your build mode**: Select Fast for quick iterations or full build for comprehensive development
3. **Learn effective prompting**: Follow our [vibe coding guide](/tutorials/how-to-vibe-code)
4. **Set up billing controls**: Configure [spending management](/billing/managing-spend)
5. **Explore Agent 3 features**: Try [App Testing](/replitai/app-testing) for self-validation, [Autonomy Level](/replitai/autonomy-level) for customized workflows, and [Agents & Automations](/replitai/agents-and-automations) for building intelligent systems

Learn more about [Agent pricing](/billing/ai-billing#agent-billing) or explore other [Replit AI tools](/category/replit-ai).