Add process execution guide - #559
Conversation
Document kernel.browsers.process (exec, spawn, status, stdin, stdout-stream, resize, kill) as its own guide, and link the fx co-located agent cookbook from it and the cookbooks gallery.
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Automations to automatically generate PRs for you. |
…uage The spawn example bound port 8080, which is already taken inside every Kernel VM, so it failed immediately instead of running as documented. The resize example called resize() on a process that wasn't PTY-backed, which 400s. Verified end-to-end against a live browser. Also drops 'single-tenant' to match the plainer phrasing used on sibling browser guide pages.
There was a problem hiding this comment.
Risk assessment: Very Low
Decision: Keep existing approval (risk did not increase)
Re-evaluated after the 20d0213 update. The PR is still documentation-only Mintlify content. Four files, +266 / −0:
browsers/process-execution.mdx— new user-facing guide forkernel.browsers.processcookbooks/fx-colocated-agent.mdx— 4-line external cookbook stubcookbooks.mdx— gallery carddocs.json— two sidebar entries
The new commit only corrects docs examples (spawn no longer binds reserved port 8080; resize now uses a PTY-backed process) and drops “single-tenant” wording. No application logic, infrastructure, auth, CI, or config beyond docs nav. No CODEOWNERS file, so no codeowner review gate applies.
Action: Risk remains Very Low. Prior approval stands; not re-approving.
Sent by Cursor Automation: Assign PR reviewers


Summary
/browsers/process-executiondocumentingkernel.browsers.process: synchronousexec, backgroundspawn,status,stdin,stdout-stream, PTYresize, andkill, with TypeScript and Python SDK examples plus CLI equivalents. Added to the "Working with your browser > Intermediate" sidebar group, next to File I/O.cookbooks/fx-colocated-agent) plus a card on the main/cookbooksgallery page for that same cookbook, matching the existing pattern for other cookbook entries.Test plan
docs.jsonis well-formed JSON.kernelCLI (--help) and thekernel-node-sdk/kernel-python-sdksource.mint dev/mint broken-linkslocally (blocked by sandbox permissions installing the Mintlify CLI); CI's broken-links workflow will cover this.Note
Low Risk
Documentation and navigation-only changes with no runtime or security logic modifications.
Overview
Adds a new Process Execution guide at
/browsers/process-executionthat documents running and managing commands inside a browser VM viakernel.browsers.process: synchronousexec, backgroundspawn,status, SSEstdoutStream,stdin, PTYresize, andkill, with TypeScript/Python examples, CLI snippets, privilege notes (as_root/as_user), and a port-conflict warning for long-running servers.Wires the page into
docs.jsonunder Working with your browser → Intermediate (next to File I/O) and cross-links File I/O, SSH, and the CLI process-control reference.Also surfaces the fx co-located agent cookbook: a stub nav page (
cookbooks/fx-colocated-agent), a Harnesses & Models sidebar entry, and a new card on/cookbooks, linked from the guide’s co-location example section.Reviewed by Cursor Bugbot for commit 20d0213. Bugbot is set up for automated code reviews on this repo. Configure here.