Ronda

Check an instruct edit: queued | in_progress | applied | failed | cancelled. When applied, includes summary, files changed and previewUrl. While it is queued or running, pass waitSeconds: 20 so the call waits until the edit finishes instead of being repeated. Read-only.

get_edit

Take a screenshot of the running preview at desktop (1280x800) and mobile (390x844) widths and return it as images. Use after layout, style or mobile changes to check the result before reporting, and to show the user what the page looks like; pass path for a page other than '/' and viewport 'mobile' for mobile bugs. Needs a READY sandbox; max 6 screenshots per session per minute. Read-only.

get_screenshot

Get a sandbox session: sandboxStatus (CREATING → INSTALLING → STARTING → READY), branch, previewUrl (a loading page until previewReady is true), pollAfterMs, estimatedSecondsRemaining, lastError when the sandbox failed, and recent edits. Use after open_session and to fetch the preview link. While the sandbox is starting, pass waitSeconds: 20 so the call waits for the next status change instead of being repeated. Read-only.

get_session

Keep the chosen variant and discard the others (removes the variant switcher from the code; discarded variants can't be recovered from the preview). Uses the workspace's model key; synchronous, 30-60s; restarts the sandbox.

resolve_variant

List GitHub repositories the user's connected GitHub account can access (most recently pushed first, max 100): owner, name, fullName, defaultBranch. Use to resolve a repo the user names (e.g. github.com/acme/site) before create_project. If GitHub isn't connected, returns a link the user can open to connect it. Read-only.

list_repos

List files and directories in the sandbox repository (relative paths, sizes). Skips .git, node_modules and build output; max 500 entries. Read-only.

list_files

List a project's sandbox sessions (newest first, max 50), optionally including destroyed ones, plus the plan's concurrent-sandbox cap. Read-only.

list_sessions

List the web app projects (connected GitHub repositories) in the user's ronda workspace, newest first, max 100. Returns id, name, GitHub repo, dev command/port and primary service. Use first to find which project the user means; if their repo isn't listed, use list_repos then create_project. Read-only.

list_projects

Start (or reuse) an isolated sandbox for a project: clones the repo on a fresh ronda branch, installs dependencies and runs the dev server with a live preview URL. Reuses a running sandbox or resumes an archived one when available. Returns immediately with the previewUrl, which shows a loading page until previewReady is true; call get_session with waitSeconds: 20 until sandboxStatus is READY (typically 30-120s). Consumes the workspace's sandbox hours. Does not change the GitHub repository.

open_session

Push the session branch to the user's GitHub repository and open a pull request against the default branch. Commits any uncommitted sandbox changes first. Visible to everyone with access to the repo — only call when the user explicitly asks to open a PR. Title/body default to the edit summaries. Calling again after success opens no duplicate; it rotates to a new branch only if a PR already exists for it.

open_pr

Read a text file from the sandbox repository, optionally a line range (max 2000 lines per call; use startLine/endLine to page). Environment files (.env*) are not returned. Read-only.

read_file

Write a file's ENTIRE content, replacing whatever is there (or creating it), and commit it on the session's ronda branch (not pushed to GitHub until open_pr). Overwrites existing content, so prefer apply_patch for edits and create_file for new files; use this only to rewrite a file wholesale. Writing identical content is a no-op. Changes take effect in the isolated sandbox, where the project's code (including package.json scripts you change) can run via run_script.

write_file

Restart the sandbox dev server (e.g. after installing dependencies or changing config) and wait up to 60s for it to come back. The preview is briefly unavailable and in-flight work in the dev server (running builds, requests, unsaved dev-server state) is cancelled. Does not change files.

restart_dev_server

Run one named script from package.json (e.g. build, lint, typecheck, test) with the repo's package manager (pnpm, yarn or npm, from the lockfile) and return exit code, stdout and stderr (last 64 KB each). This executes the project's own code: the script is whatever package.json defines at that moment, including any change made with apply_patch or write_file. Only existing scripts run; an unknown name lists the available ones. Optional args are passed as plain argv, never through a shell. Scripts can modify sandbox files and reach the internet; changes are not committed automatically. Hard timeout (default 120s, max 600s). Not idempotent.

run_script

Search the sandbox repository for text (literal by default, or regex) and return matching file, line number and line text. Respects .gitignore, skips .env files. Use to find where copy, components or styles live. Read-only.

search_code

Apply a previously proposed A/B experiment: writes the variant code and creates the feature flag and experiment in the workspace's connected PostHog project, stopping before launch (the user launches it in PostHog). Uses the workspace's model key. Requires a PostHog connection. The agent rewrites code and creates the flag and experiment in PostHog (not launched).

apply_experiment