Skip to content

Add process execution guide - #559

Open
dprevoznik wants to merge 2 commits into
mainfrom
hypeship/process-execution-guide
Open

Add process execution guide#559
dprevoznik wants to merge 2 commits into
mainfrom
hypeship/process-execution-guide

Conversation

@dprevoznik

@dprevoznik dprevoznik commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

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 navigation-only changes with no runtime or security logic modifications.

Overview
Adds a new Process Execution guide at /browsers/process-execution that documents running and managing commands inside a browser VM via kernel.browsers.process: synchronous exec, background spawn, status, SSE stdoutStream, stdin, PTY resize, and kill, 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.json under 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.

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.
@mintlify

mintlify Bot commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated
Kernel 🟢 Ready View Preview Sep 9, 2026, 9:10 PM

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

cursor[bot]
cursor Bot approved these changes Sep 9, 2026
…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.

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

Open in Web View Automation 

Sent by Cursor Automation: Assign PR reviewers

@dprevoznik
dprevoznik requested a review from juecd September 9, 2026 22:00
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.

1 participant