Skip to content

Reposition sandbox messaging from ephemeral to persistent-first#137

Merged
beran-t merged 6 commits intomainfrom
sandbox-messaging-audit
Mar 2, 2026
Merged

Reposition sandbox messaging from ephemeral to persistent-first#137
beran-t merged 6 commits intomainfrom
sandbox-messaging-audit

Conversation

@beran-t
Copy link
Copy Markdown
Contributor

@beran-t beran-t commented Mar 2, 2026

Summary

  • Replaces ephemeral language ("spin up", "disposable", "destroyed automatically", "alive for 5 minutes") across 15 doc pages with persistent-first framing
  • Rewrites sandbox lifecycle opening paragraph: sandboxes now "stay running as long as you need them" with auto-pause, instead of "alive for 5 minutes then automatically shutdown"
  • Changes runtime limits from <Warning> to <Info> with persistence-positive framing
  • Scopes persistence beta note to auto-pause specifically, not the entire persistence concept
  • Reorders billing cost tips to lead with pause/auto-pause instead of kill
  • Removes "disposable" from CLI pages, "spin up" from all 5 agent pages and landing page

Files changed (15)

Area Files Changes
Landing & quickstart docs.mdx, docs/quickstart.mdx "Spin up" → "Start"; "alive for 5 minutes" → "persistent sandbox session"
Sandbox core docs/sandbox.mdx, docs/sandbox/persistence.mdx, docs/sandbox/pty.mdx Persistent-first lifecycle narrative, scoped beta note, reframed timeouts
Use cases docs/use-cases/coding-agents.mdx, docs/use-cases/ci-cd.mdx "Destroyed automatically" → "stays available"; "fresh sandbox" → "isolated sandbox"
Agents docs/agents/claude-code.mdx, codex.mdx, amp.mdx, opencode.mdx, openclaw.mdx "Spin up" → "Create"
CLI docs/cli/create-sandbox.mdx, docs/cli/connect-to-sandbox.mdx "disposable" → "dedicated"
Billing docs/billing.mdx Lead with pause, not kill

Test plan

  • Run mintlify dev and verify all 15 changed pages render correctly
  • Grep for remaining ephemeral terms: ephemeral, disposable, short-lived, spin up, alive for 5 minutes, destroyed automatically
  • Read sandbox lifecycle and persistence pages end-to-end to confirm persistent-first narrative
  • Verify no broken links from reorganized content

Replace ephemeral language (spin up, disposable, destroyed automatically,
alive for 5 minutes) across 15 doc pages with persistent-first framing.
Sandboxes are now described as long-running by default with auto-pause,
while preserving isolation, security, and scalability messaging.
Persistence is no longer in beta. Remove all beta notes, rename
betaPause/beta_pause to pause, betaCreate/beta_create to Sandbox.create,
and rename "Limitations while in beta" to "Limitations".
The previous commit incorrectly renamed the SDK methods. The beta
labels/notes in the docs are removed but the actual API methods
(betaPause, beta_pause, betaCreate, beta_create) are still the
current SDK surface.
@beran-t beran-t merged commit c5f04f6 into main Mar 2, 2026
6 checks passed
@beran-t beran-t deleted the sandbox-messaging-audit branch March 2, 2026 18:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants