Add process execution guide

[dprevoznik]

Summary

• New guide at /browsers/process-execution documenting kernel.browsers.process: synchronous exec, background spawn, status, stdin, stdout-stream, PTY resize, and kill, with TypeScript and Python SDK examples plus CLI equivalents. Added to the "Working with your browser > Intermediate" sidebar group, next to File I/O.
• Links out to the new fx co-located agent cookbook as a real-world example of process execution.
• Added a docs stub page and Cookbooks-tab nav entry (cookbooks/fx-colocated-agent) plus a card on the main /cookbooks gallery page for that same cookbook, matching the existing pattern for other cookbook entries.

Test plan

• Validated docs.json is well-formed JSON.
• Checked all referenced CLI flags and SDK method signatures against the kernel CLI (--help) and the kernel-node-sdk/kernel-python-sdk source.
• Did not run mint dev / mint broken-links locally (blocked by sandbox permissions installing the Mintlify CLI); CI's broken-links workflow will cover this.

---

Note

Low Risk
Documentation and site navigation only; no runtime or API behavior changes.

Overview
Adds a new Process Execution guide at /browsers/process-execution that documents running commands inside a browser VM via kernel.browsers.process: synchronous exec, background spawn, and lifecycle APIs (status, SSE stdout streaming, stdin, PTY resize, kill), with TypeScript/Python examples, CLI snippets, production patterns, and links to File I/O, Playwright execution, and security context for as_root/as_user.

Navigation and cookbooks: docs.json now lists the page under Working with your browser > Intermediate (after File I/O). The PR also surfaces the fx, Co-located integration via a cookbook stub (cookbooks/fx-colocated-agent), a Harnesses & Models nav entry, and a new card on /cookbooks, cross-linked from the process guide as an end-to-end co-located agent example.

^{Reviewed by Cursor Bugbot for commit ef909bf. Bugbot is set up for automated code reviews on this repo. Configure here.}

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
Kernel	🟢 Ready	View Preview	Sep 12, 2026, 12:47 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

[cursor]

Stale 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 for kernel.browsers.process
• cookbooks/fx-colocated-agent.mdx — 4-line external cookbook stub
• cookbooks.mdx — gallery card
• docs.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}

[cursor]

Risk assessment: Very Low

Decision: Keep existing approval (risk did not increase)

Re-evaluated after ef909bf ("Explain process execution use cases"). The PR remains documentation-only Mintlify content. Four files, +276 / −0:

• browsers/process-execution.mdx — new user-facing guide for kernel.browsers.process
• cookbooks/fx-colocated-agent.mdx — 4-line external cookbook stub
• cookbooks.mdx — gallery card
• docs.json — two sidebar entries

The new commit only expands the guide intro and adds a "common production patterns" section (and removes a shorter co-location example that that section supersedes). 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}