Troubleshoot Arc Studio - Arc Docs

Match the message or behavior you see to its likely cause and fix. If a fix doesn’t work, contact Circle Support or ask in the Arc Discord. In the CLI, run arc-studio doctor and include its output.

Usage and app limits

Message or behavior	Cause	Fix
”You’ve reached your daily limit” or “30-day usage limit”	Your AI usage has reached its daily or 30-day limit. A daily limit resets. A 30-day limit covers a rolling 30 days.	Wait and try again. In the CLI, run `arc-studio usage` to see how much you’ve used. To raise your organization’s limit, run `arc-studio upgrade`, which opens a checkout. Only billing admins can pay.
”Thread limit reached”	Each app has a limit on conversation threads.	Delete an old thread in Arc Studio on the web, then start a new one.
You can’t open or start a new app	You’ve reached the limit on apps running at once. The CLI reports a 429 `active-sandbox-limit` error.	Pause an app with `arc-studio pause --app <appId>`, using an ID from `arc-studio apps`, or delete one.

Service and sandbox

Message or behavior	Cause	Fix
”Sandbox is temporarily unavailable” or “Service temporarily unavailable”	A temporary service issue.	Wait a few minutes and try again.
The sandbox is slow to load	Idle sandboxes pause after about 30 minutes.	None needed. Resuming takes 5 to 15 seconds, and the agent reconnects automatically.

GitHub and repositories

Message or behavior	Cause	Fix
”Your GitHub authorization expired”	Your GitHub authorization is no longer valid.	Disconnect and reconnect your GitHub account in Arc Studio on the web.
”GitHub not connected”	Private repositories and pushing code to any repository require a connected account. Public repositories import without one.	Connect your GitHub account in Arc Studio on the web.
”Clone failed”	The URL is wrong, or the repository doesn’t exist or is private. Arc Studio can’t tell a private repository from a missing one.	Check the URL. The CLI clones only public repositories, so connect GitHub in Arc Studio on the web to import a private one. If the CLI stops because the target directory has uncommitted changes, rerun with `--force` to overwrite it.

Deploys and transactions

Message or behavior	Cause	Fix
Netlify or Hugging Face deploy errors	The connection has expired or is missing.	Reconnect the integration in Arc Studio on the web.
A transaction never appears and shows no error	Arc silently drops transactions with a `maxFeePerGas` lower than 20 Gwei.	Set `maxFeePerGas` to at least 20 Gwei. See EVM differences.

CLI turn outcomes

A turn is one prompt and the agent’s response to it. For all outcomes, see Turn outcomes and exit codes. For an error turn, check the errorMessage field.

Status	Exit code	Cause	Fix
`needs_input`	3	The agent has questions.	Rerun against the same session with `--answers-json`. See Answering follow-up questions.
`budget_exceeded`	4	Your daily or 30-day usage limit is spent (`monthly` in `budget.period`).	Run `arc-studio usage` to see which limit you’ve reached. Wait for it to reset, or run `arc-studio upgrade` to raise it (billing admins only).