These answers cover working with Agent. For full reference, see the Agent overview, Agent modes, and AI billing.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.
Agent is frozen or keeps disconnecting—how do I fix it?
Agent is frozen or keeps disconnecting—how do I fix it?
- Open the Shell pane in your project—not the Agent chat.
- Type
kill 1and press Enter to stop the frozen process. (kill 1is safe in Replit—it restarts your project’s main process, it doesn’t delete anything.) - Open a new Agent chat and describe your task again to continue.
Agent is looping or repeating the same steps—how do I stop it?
Agent is looping or repeating the same steps—how do I stop it?
- Select Stop in the Agent panel to halt it immediately.
- Open the Shell pane (not the Agent chat), type
kill 1, and press Enter. - Open a new Agent chat and rephrase your task more specifically.
- Break large tasks into smaller prompts—one goal per message.
- Turn on Code Optimizations.
- Set a usage limit in Managing your spend so a loop can’t run up a large bill.
How do I reduce Agent costs—what settings actually help?
How do I reduce Agent costs—what settings actually help?
Three settings make the biggest difference:
- Economy mode—uses fewer credits per task and is a good default for everyday builds.
- Code Optimizations—Agent reviews and simplifies its own code, reducing costly rework.
- Usage limit and budget—set a hard cap in Managing your spend.
What are the Agent modes, and how do they differ?
What are the Agent modes, and how do they differ?
Agent has three top-level modes plus an optional speed toggle. See Agent modes for full guidance.
- Lite—fast, lightweight models for quick, scoped edits.
- Economy—optimized for cost; a strong default for everyday builds.
- Power—the most capable models for complex tasks and larger codebases.
- Turbo—a toggle in Advanced settings, available in Power mode, that runs the fastest models. It’s significantly faster but costs more, so use it intentionally.
Agent made changes I didn't want—how do I roll back?
Agent made changes I didn't want—how do I roll back?
Replit saves checkpoints as Agent works. In the Agent chat, find the message before the change you want to undo and select the rollback option next to it to restore your project to that point.For full rollback options—including recovering specific files and live deployments—see Checkpoints and rollbacks.
Agent says it can't access the internet or external APIs—is that expected?
Agent says it can't access the internet or external APIs—is that expected?
During the build and edit phase, Agent works in a sandboxed environment with restricted outbound access. Your deployed app can still make external API calls when it runs—the sandbox applies to Agent’s editing environment, not your running app.If an API call fails in your running app, confirm your keys are saved in the Secrets pane, then check the provider’s status page. On a corporate or school network, outbound connections from your app may be blocked—check with your network admin.
Can I use my own API keys with Agent?
Can I use my own API keys with Agent?
Yes. Add your keys to the Secrets pane and your app uses them for its API calls. Open the Secrets tool, select + New secret, and enter a name (such as
OPENAI_API_KEY) and value.You can bring your own AI provider keys for the models your app calls. The model that powers the Agent experience itself runs on Replit’s infrastructure and can’t be swapped.Agent keeps adding features I didn't ask for—how do I get more precise behavior?
Agent keeps adding features I didn't ask for—how do I get more precise behavior?
Keep Agent focused with tighter prompts:
- Start with the word Only—for example, “Only add a delete button to the user card. Don’t change anything else.”
- Use Plan mode first to review what Agent intends to do before it changes anything.
- If Agent makes an unwanted change, ask it to undo that change in the same chat right away.