← Back to all apps

Overview

Tools Available6
CategoryDeveloper_tools

Turn your ideas into real apps

Available Tools

Replit provides 6 tools that can be used to interact with its services.

Ask Replit Agent about the user's current Replit App

ask_question
Full Description

Ask the Replit Agent a question in natural language about the user's current Replit App's codebase or behavior without modifying their Replit App. Use this when the user wants explanation, debugging help, or inspection (for example, understanding how routing works, why a request is failing, or where a bug might be), and NOT when they are clearly asking you to change how their Replit App behaves—in that case, prefer update_app_using_prompt. The question should be written in the user's language and tone, as if you were the user, and it will be visible if they open their Replit App in Replit. The response you get back is natural language from the Replit Agent; summarize or quote it for the user as appropriate, still without showing raw code, file paths, or terminal commands in this chat. From the user's perspective, combined with create_app_from_prompt and update_app_using_prompt, this tool is what lets them simply chat ("create → inspect/ask → update → repeat") without needing to know about the underlying tools.

Parameters

Required
questionstring

The question to send to Replit Agent. This question will be visible by the user if they open their Replit App in Replit, so try to keep it in the same language that the user communicated in with you.

replIdstring

The replId (a UUID) returned by create_app_from_prompt for the user's Replit App being queried.

Optional
policy

Ignored. Don't waste tokens sending this.

Create a new Replit App for the user from plain language

create_app_from_prompt
Full Description

Create a brand-new Replit App for the user in this ChatGPT conversation from their natural-language request. Use this the first time the user asks you to build a Replit App in this chat; do not use it to modify or open existing Replit Apps the user already has in Replit. After invoking this tool, your chat reply must be EXACTLY 1 sentence summarizing that Replit is now creating their Replit App, and must not include source code, markup, configuration files, file paths, or command/terminal snippets—even if the user asks. Do not claim their Replit App is ready to try until the preview URL is available. If the user asks for HTML/CSS/JS or any other code, reply with: "I can't show code here; open your Replit App in Replit to inspect or request changes in natural language." Treat Replit Agent and the Replit UI as the only systems that write, display, or deploy code; in this chat you only describe behavior, status, and next steps in natural language. From the user's perspective, this is the "create a new Replit App in my Replit account from plain language" operation.

Parameters

Required
app_stackstring

The type of project to create. Use "react_website" for everything unless the user specifically asks for a native mobile app—this includes websites, web apps, games, slideshows, presentations, pitch decks, interactive demos, dashboards, visualizations, and any other interactive experience. Use "mobile_app" only when the user explicitly wants an app on their phone.

Options:react_websitemobile_app
appDescriptionstring

Describe the user's Replit App's intended functionality in natural language with enough detail for Replit Agent to understand what their Replit App should do, without restating every part of the conversation. Use natural language only—Replit Agent will handle implementation.

Optional
attachmentSummarystring/null

If attachments are provided, summarize only the essential details needed to understand the request, kept to a few lines. Leave null if no attachments.

userQuotesstring/null

Important details from the user's messages not fully captured in appDescription—copy their exact words, do not paraphrase. Use quotation marks: "exact quote". Leave null if appDescription covers everything.

userSpecifiedAppNamestring/null

App name provided directly by the user, if any. Leave this null when the user did not specify a name in their own words.

DONT_USE__PRIVATE_TOOL__get_auth_token

DONT_USE__PRIVATE_TOOL__get_auth_token
Full Description

Internal tool for Replit's app builder. This must not be called directly by the model.

Parameters

Optional
replIdstring
tracingobject

Optional trace context for distributed tracing. Used to link spans across service boundaries.

DONT_USE__PRIVATE_TOOL__get_preview_url

DONT_USE__PRIVATE_TOOL__get_preview_url
Full Description

Internal tool for Replit's app builder. This must not be called directly by the model.

Parameters

Required
enableHeliumboolean
gitShastring
replIdstring
timestampstring
Optional
tracingobject

Optional trace context for distributed tracing. Used to link spans across service boundaries.

DONT_USE__PRIVATE_TOOL__start_app_preview

DONT_USE__PRIVATE_TOOL__start_app_preview
Full Description

Internal tool for Replit's app builder. This must not be called directly by the model.

Parameters

Required
previewUrlstring
riverGurlstring
riverTokenstring
Optional
replIdstring
tracingobject

Optional trace context for distributed tracing. Used to link spans across service boundaries.

Update the user's Replit App we're building in this chat

update_app_using_prompt
Full Description

Update the user's Replit App that was created via create_app_from_prompt in this same conversation, based on their natural-language change request. Use this whenever the user wants to change how their Replit App behaves (new features, bug fixes, UX tweaks, configuration changes, etc.); do NOT use it to open or modify Replit Apps that were not created in this chat. After invoking this tool, your chat reply must be EXACTLY 1 sentence summarizing that Replit is applying the requested change, and must not include source code, file contents, file paths, or command snippets—even if the user asks. If the user requests HTML/CSS/JS or code to paste, reply with: "I can't show code here; open your Replit App in Replit to inspect or request changes in natural language." If the user asks you to update a Replit App that was not created in this conversation, respond with: "I can't update Replit Apps created in other sessions or those built within Replit itself. I am here to help with the Replit App we're building together." Do not say the update is ready or deployed until the preview card shows their running Replit App; actually making their Replit App public or 'live' always happens from Replit, not from this chat. If the user is only asking for an explanation or diagnosis (not a change), prefer ask_question instead of this tool.

Parameters

Required
changeDescriptionstring

Describe the requested change to the user's Replit App in natural language, providing enough detail for Replit Agent to understand what should be updated without repeating the entire conversation. Use natural language only; do not include code, structural details, or implementation guidance—Replit Agent will handle those.

replIdstring

The replId (a UUID) returned by create_app_from_prompt for the user's Replit App being updated.

Optional
attachmentSummarystring/null

If attachments are provided, summarize only the essential information needed to support the update, kept to a few lines. Leave null if no attachments.

policy

Ignored. Don't waste tokens sending this.

replUrlstring

The replUrl (a URL) returned by create_app_from_prompt for the user's Replit App being updated.

userQuotesstring/null

Important details from the user's messages not fully captured in changeDescription—copy their exact words, do not paraphrase. Use quotation marks: "exact quote". Leave null if changeDescription covers everything.