How an Agent credit converts to actions
A Replit Agent credit is approximately one substantive model invocation plus the tool calls it spawns to complete one logical step of the build. 'One substantive model invocation' typically means one Claude Sonnet 4.6 or GPT-5.5 call with the Agent's full system prompt, the current project state, and the user's intent — roughly 8k-15k input tokens + 800-2k output tokens. The associated tool calls (file reads, file writes, terminal commands, package installs, dependency lookups) are bundled into the same credit when they happen as part of the same logical step.
**Logical step**, not raw tool call, is the unit. If Agent decides to add a new API endpoint, that one decision typically consumes one credit even though it involves: reading the existing routes file, generating the new handler code, writing the handler to a new file, updating the routes index, running `npm install` for any new package, and verifying the dev server still boots. All of that is one credit because it's one logical 'add endpoint' step.
When Agent breaks an Agent task into multiple logical steps — say, building a Todo app means 'design schema → set up database → build CRUD API → build UI → wire form submission → handle delete' — each step is approximately one credit. A Todo app from scratch in a clean repl typically consumes 5-15 credits across the full build, varying by how many steps Agent breaks the work into and how many error-correction iterations it goes through.
**Error iterations cost credits.** When Agent runs a `npm install`, the install fails because of a version conflict, Agent reads the error, decides to pin a different version, retries — that's typically one extra credit consumed per debug cycle. The 5-15 credit range for a Todo app assumes 1-3 debug cycles total; if Agent gets stuck on a stubborn dependency conflict or a misconfigured TypeScript path and burns 6-8 debug iterations, the same Todo app can hit 18-25 credits.
**You can monitor live credit consumption** in the Agent panel as the build progresses — Replit shows a running credit count next to each step. If the count is climbing faster than you expected, you can pause Agent, accept the partial result, and continue manually rather than letting it iterate further. Most over-budget Agent runs happen because the user walked away during a long build and Agent kept iterating without supervision.