bounded-deploy
Ship and configure a Bounded app: CLI setup, browser-backed developer login, deploy, hosted frontend publishing, environments, source sync, domains, bounded.json, collaborators, and release recovery. Part of the Bounded skill family.
How do I install this agent skill?
npx skills add https://github.com/bounded-sh/skill --skill bounded-deployIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides a command-line interface for deploying and managing applications on the Bounded platform. It handles account authentication, project configuration, and deployment of backend policies and frontend assets. While it involves sensitive operations such as managing local keys and performing network uploads, these actions are essential to its documented purpose and target the vendor's own infrastructure.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Bounded deploy
Use this skill to initialize, ship, configure, and share a Bounded app. Policy authoring belongs in bounded-backend; client code and app-user auth belong in bounded-frontend.
Default workflow
For a new project or a normal release, read docs/quickstart.md. The expected path is:
bounded init
bounded deploy --create --name my-app
bounded init reuses a saved web session or opens hosted browser login. It
writes public bounded.json (with "sourcePush": true, so deploys sync the
project source) and policy.json; credentials never belong in either file.
Task router
Read only the reference needed for the current task.
| Task | Read |
|---|---|
| First setup, normal deploy, creator publishing an Owned OpenApps frontend without an AI run, multiple app IDs from one project | docs/quickstart.md |
| Normal web account login, session refresh, headless OTP, account switching | docs/accounts.md |
| Hosted web frontend, preview, private/public access | frontend-hosting.md |
| Multi-environment policies: per-env app id, constants, schedule cadence, function scoping | docs/environments.md |
Build an app from a prompt, iterate with edit, watch/cancel/gate a run | docs/cli-reference.md (Prompt-driven builds) |
Source sync, --with-source, clone, pull | docs/source-sync.md |
| Bring or migrate an existing app; preserve its stack where supported and agree on any material migration | docs/porting-an-existing-app.md |
Third-party API discovery, readiness, and requests: bounded services search/describe/request/status | docs/cli-reference.md (Capabilities) |
The dry run of the checks an oApp must pass to open: bounded oapp preflight | docs/cli-reference.md (Open Apps) |
| Custom domains and vanity slugs | docs/domains.md |
Share, access, owner mismatch, 401/403 | docs/access-playbook.md |
| Delete an app permanently (browser-confirmed, owner only) | docs/cli-reference.md (apps delete) |
| Uncommon command or exact flag lookup | docs/cli-reference.md |
| Local signing keys, profiles, CI key auth, legacy key-owned apps | docs/key-and-account-safety.md |
Do not load the local-key reference during normal onboarding. It is an advanced alternative for users who explicitly request local signing, CI key auth, an account profile, or recovery of an existing key-owned app.
Incident router
deploy_in_progress,operationId, orrecoveryCommand: use only the exact owner-visible recovery command with unchanged inputs, then let the CLI poll. See deploy recovery.- An error with
code/statebut NOrecoveryCommandis terminal for that operation -410 policy_operation_unrecoverableand the abandoned, superseded, target-mismatch and manual-intervention states. Re-running the recovery can never commit it; run a freshbounded deploy(or escalate, when the message says operator review). Never invent a recovery command for these. onchain_creation_pending,onchain_creation_unreadable, oronchain_creation_superseded(all409): the app's mainnet creation never finished - its on-chain owner is not proven at finalized yet, so nothing can be deployed to it and nothing has been signed or spent. Re-run the SAMEbounded deployfor that app id: the platform resumes the original creation and lifts the fence as soon as the account is finalized. Never re-run--create, and never create a replacement app - the first app's on-chain account is already paid for and a second one strands that rent.onchain_creation_owner_conflict(409): the app's on-chain account is finalized under a wallet the creation did not intend. That is an integrity fault, not a state to retry; escalate for operator review.- Unsure which applies, or unsure whether a fresh deploy is safe: run the
read-only
bounded deploy status --jsonfirst. It reports what holds the deploy slot and afreshDeploySafeverdict, and it never mutates anything. - Before a deploy, to know whether it will LAND (not just whether the slot is
free): run the read-only
bounded deploy preflight --json. Deploys are metered against the app's credit balance - each leg charges its actual Cloudflare infra cost (sub-cent; no per-tier deploy cap, no minimum), so an out-of-credit app is refused. Preflight reports the credit balance + awould_likely_admit/refuse/ unknownverdict so you can tell the user "this will land" or "top up first" before spending time on the deploy. It never mutates anything. 402 deploy_credit_insufficientonsite deploy: billing, not identity. The deploying account has no spendable credit for the deploy's infra cost. Runbounded billing status, add credit withbounded billing topup --credits <n>, then retry under the same identity. Switching accounts never helps here.- Custom domain still pending after DNS is configured: rerun
bounded domains list --app-id <id> --env <environment> --jsonto refresh status and reconcile activation. Verify DNS and follow the bounded retry/escalation steps in domains. Listing does not generally restart provider validation; do not substitute provider-dashboard instructions for a public CLI workflow. site_control_denied(a403), wrong owner, or unexpected401/403: runbounded whoamiandbounded access --app-id <id>before changing identity. See access playbook.project_daily_limit_exceeded(a429): a Free account may create 20 apps per rolling 24 hours, and this one has. ReadlimitandresetsAtMs(alsoRetry-After) and tell the user when the next create fits; wait for it or reuse an existing app the user approves. Upgrading removes the limit; deleting apps does not free it. Never delete or repurpose an app automatically. See billing.boundary_violation: changing accounts will not bypass an app boundary. Use the boundary-lock section of the access playbook.
Release rules
- Read
bounded.jsonfirst in an existing app. - The
policy.jsonthatbounded.jsonnames is what deploys. Before running a script that generates it, diff its output against the committed file; if it drops or changes anything you did not mean to change, the generator is stale: update it or delete it, never deploy its output. bounded deployvalidates and compiles the policy and refuses an invalid one before anything changes; there is no separate proof step.- After a release-critical deploy, use
bounded apps inspect --app-id <id> --jsonto confirm the active policy and runtime publication before measuring behavior. - Resolve the hosted URL from the exact site receipt or
bounded domains list --app-id <id> --env <environment> --json. Do not invent a hostname. - Share control-plane access with
bounded share <email-or-wallet> --role admin|developer|viewer|billing. - Do not commit credentials, web sessions, refresh tokens, or provider secrets.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/bounded-sh/skill/bounded-deploy">View bounded-deploy on skillZs</a>