run.zero

• runzero_get_help — Look up structured guidance on platform concepts and conventions. Topics: workflow, files, addons, procfile, domains. Call this whenever you need to understand
• runzero_list_apps — List the apps the authenticated user has access to (own + collaborated), newest first — one compact row each (name, slug, url, kind, status, flags). Details of
• runzero_get_app — Get one app: slug, status, publish mode, services (URL, replicas, health, env var NAMES), addons, domains. Secret values are never returned.
• runzero_create_app — Create a new app. Optionally links to a Git repository — if no repo is given, you can attach one later.
• runzero_list_templates — List the curated template library: finished, deployed page designs (landing pages, shops, portfolios …) that can be adopted as the starting point of a NEW app i
• runzero_adopt_template — Create a NEW app as a full copy of a template from runzero_list_templates: app + repo + running instance, owned by the caller. Use this INSTEAD of runzero_creat
• runzero_list_services — List the services (runtime processes) of an app with their build source, port, replicas and status.
• runzero_get_logs — Get the runtime log output of one service (stdout/stderr of its running containers), last N lines.
• runzero_get_metrics — CPU and memory usage of a service over a time window (default last hour). Returns per-pod current/min/max/avg — CPU in millicores, memory in MiB — not raw time
• runzero_screenshot — SEE the deployed page with your own eyes: renders the live URL in a real browser and returns fresh screenshots as images — desktop (1280×800) and/or mobile (390
• runzero_rebuild_service — Rebuild a service from the latest commit of its repo branch; on success the new version rolls out to the live URL. Use after an external repo changed; pushes vi
• runzero_delete_app — Permanently delete an app with all its services, addons (including database data), secrets and domains. Irreversible: only on an explicit request, and name the
• runzero_deploy — Deploy an app. Fetches the repo and checks for run-zero.yaml (or the older itdone.yaml). If found, syncs all services + addons + domains from config. If not, de
• runzero_deploy_preview — Preview what a deploy would change without making any changes. Use this before runzero_deploy to verify the diff.
• runzero_add_service — Add a new service to an app. Clones the repo, builds with buildpacks, and deploys. The web process must listen on $PORT.
• runzero_delete_service — Permanently delete one service of an app: its running containers, its public URL and its configuration. Irreversible, and it also deletes the persistent volume
• runzero_scale_service — Set the replica count of a service (0-10). Scaling to 0 takes the service offline (its URL stops answering) without deleting it; scale up again to bring it back
• runzero_volume_status — Show the persistent volume of a service: mount path, size, last backup, the backups that can be restored, and the state of a running or last restore. Volumes ar
• runzero_backup_volume — Start a backup of the persistent volume now, on top of the automatic daily one. The service keeps running. It runs in the background; runzero_volume_status list
• runzero_restore_volume — Replace the data on the persistent volume with a backup. The service stops, the current data is backed up first, the backup is unpacked, and the service starts
• runzero_set_secrets — Set one or more environment variables for an app or a specific service. Existing keys are overwritten; other keys are preserved. Affected services are redeploye
• runzero_list_secrets — List the secret keys for an app (values are never returned). Includes both app-wide and per-service secrets.
• runzero_delete_secret — Delete a single secret from an app or a service. Affected services are redeployed automatically.
• runzero_list_builds — List recent build records for an app. Returns kpack Build status (success/failed/running) per service. To WAIT for a build to finish, use runzero_wait_for_build
• runzero_list_versions — Earlier versions of a service that can be put back online, newest first. Each entry has an `image` (pass it to runzero_activate_version or runzero_preview_versi
• runzero_preview_version — Show an earlier version under a SECOND address without touching the live site — use this whenever the user wants to look before deciding. Returns a url; the pod
• runzero_work_url — The URL where this app's UNPUBLISHED changes can be looked at, and a link that opens it (the plain hostname refuses without one). Call this after EVERY change t
• runzero_list_releases — What the user has PUBLISHED, newest first, with the sentence they described each change with, and which one visitors see right now. This is the list to use when
• runzero_publish — Put the waiting changes on the real site — this is what VISITORS see, so only ever on an explicit request ("mach das live", "veröffentliche das"), never on your
• runzero_restore_release — Put an earlier published state back on the real site. Use the id from runzero_list_releases. This CHANGES what visitors see. It does not touch the code: anythin
• runzero_set_publish_mode — Switch between publishing every change immediately (auto) and collecting changes on a preview until the user releases them (manual). Explain the consequence bef
• runzero_activate_version — Put an earlier version back online — this CHANGES what visitors see. Only do this when the user explicitly asks to go back; never on your own initiative after a
• runzero_wait_for_build — Wait server-side until the newest build of an app is finished AND the new version is serving traffic — use this INSTEAD of polling runzero_list_builds, sleeping
• runzero_get_build_logs — Get the full log stream for a specific build (all kpack steps concatenated). Use runzero_list_builds first to find the build id.
• runzero_push_files — Push changes into the app's Git repository as ONE atomic commit (create, patch, and delete in a single push). CHANGING an existing file? Use `edits` — an exact-
• runzero_list_files — List all files in the app's Git repository (platform-managed repos only). Optionally filter by path prefix.
• runzero_read_file — Read a file from the app's Git repository (platform-managed repos only), UTF-8. Returns at most 250 lines per call (a note at the end says how to continue) — re
• runzero_upload_assets — Get the dashboard upload link for an app so the USER can upload binary assets (icons, images, fonts) via drag & drop — real bytes, nothing travels through the m
• runzero_list_users — List the end-users of an app's login realm (requires the app's keycloak addon). Returns id, username, email and enabled state.
• runzero_create_user — Create an end-user in the app's login realm. Returns the generated password ONCE if none is given — relay it to the user, it cannot be retrieved later.
• runzero_delete_user — Permanently delete an end-user (account, sessions, login data) from the app's login realm. Irreversible; to only block the login use runzero_set_user_enabled.
• runzero_reset_user_password — Replace an end-user's password in the app's login realm; the old one stops working at once. Returns the new password ONCE (generated if none given).
• runzero_set_user_enabled — Enable or disable (block) an end-user in the app's login realm. A disabled user cannot log in but is not deleted.
• runzero_list_identity_providers — List external login providers (Google, GitHub, …) configured on the app's login realm. Secrets are never returned.
• runzero_create_identity_provider — Add an external login provider (Google, GitHub, Microsoft, generic OIDC/SAML) to the app's login realm, so end-users can sign in with it. You need an OAuth clie
• runzero_generate_image — Generate an image with AI (FLUX) and commit it into the app's repo. Costs credits. Use for hero images, backgrounds, illustrations. The file is committed at the
• runzero_db_query — Run one SQL statement against an app's PostgreSQL addon (owner/admin only). Read-only by default: the statement runs in a READ ONLY transaction that is rolled b
• runzero_describe_addon — Show exactly which environment variables an addon injects into an attached service, straight from the platform (the source of truth — use this instead of guessi
• runzero_get_legal_profile — Get the user's saved legal profile (their Impressum details: name/company, address, contact, and for a company the representative, register and VAT id). Read th
• runzero_set_legal_profile — Save or update the user's legal profile so it is reused across their apps and the legal pages can be regenerated. Send only what the user actually provided; omi

No hidden text found in the tool definitions.

Text a person reading a tool definition does not see and a model does. Invisible characters can be pasted in by accident; this says what is there, not why. Covers tools only, not prompts or resources.