Add Cookbooks page by goosewin · Pull Request #537 · kernel/docs

goosewin · 2026-09-01T17:50:45Z

Adds a Cookbooks tab to the docs, cataloguing all 16 recipes in kernel/cookbooks. Related to the strawman in #525 — built as a separate take from main; happy to reconcile whichever direction wins.

Note

Low Risk
Documentation and navigation-only changes with no runtime product or API behavior impact.

Overview
Adds a Cookbooks docs tab that catalogs runnable recipes from kernel/cookbooks, with a wide landing page (cookbooks.mdx), client-side search (CookbookSearch), and a card grid split into “common patterns” vs “harnesses & models.”

Navigation is reorganized: Playwright computer-use fallback and enable payments move out of the Platform section into Cookbooks under Common Patterns; Harnesses & Models uses lightweight cookbooks/*.mdx stubs (url frontmatter) so the sidebar lists GitHub recipes without full doc pages. Integration guides (Browser Use, Claude Managed Agents, Anthropic computer use, Stagehand, AI SDK, Vibium) gain Tip links to the matching cookbooks, and the changelog fixes the Claude Managed Agents cookbook URL to the monorepo path. CSS hides misleading prev/next pagination on external cookbook routes and styles .cookbook-tag on cards.

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

New Cookbooks tab with a card gallery for all 16 kernel/cookbooks recipes, per-card feature/integration labels, live search filter (snippets/cookbook-search.jsx), sidebar external links to each cookbook subdirectory, and card artwork in images/cookbooks/.

…links Add cookbook Tips to the five integration pages with a matching cookbook, and point claude-managed-agents-kernel links (integration page + changelog) at kernel/cookbooks subdirectories.

…ookbooks-page-94e601 # Conflicts: # style.css

mintlify · 2026-09-01T17:50:49Z

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

Project	Status	Preview	Updated (UTC)
Kernel	🟢 Ready	View Preview	Sep 1, 2026, 5:51 PM

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

cursor

Stale Bugbot comment from a previous run.

cursor · 2026-09-01T17:59:39Z

+   so hide pagination that would point at them */
+#pagination a[href^="/cookbooks/"] {
+  display: none;
+}


Pagination hide misses production URLs

Medium Severity

The pagination hide rule matches only hrefs that start with /cookbooks/. Docs are served under /docs, so production pagination links likely will not match and will still send readers to the empty cookbook stubs this rule is meant to hide.

^{Reviewed by Cursor Bugbot for commit 10dcac3. Configure here.}

juecd · 2026-09-02T13:44:15Z

+
+<CookbookSearch />
+
+<Columns className="responsive-columns" cols={3}>


Remove features section per canvas notes

juecd · 2026-09-02T13:48:05Z

+
+Every cookbook is self-contained: clone it, set your secrets, run. Use them as 1-click starts for your agents or as templates for your own automations.
+
+import { CookbookSearch } from '/snippets/cookbook-search.jsx';


Very cool addition, tysm!

cursor

Stale comment

Risk assessment: Low

Verdict: Low risk. Re-evaluated after 287b9e9 (copy edit on cookbooks.mdx). Risk did not increase. Prior approval stands; not re-approving.

What changed (from the diff)

New docs tab and landing page (docs.json, cookbooks.mdx) cataloguing 16 cookbooks as cards that link out to github.com/kernel/cookbooks.

16 stub MDX pages under cookbooks/ whose only content is title + external url frontmatter.

Card images under images/cookbooks/.

Tip/link updates on existing integration pages and a changelog URL rewrite from absorbed repo paths to kernel/cookbooks.

Client-side search snippet (snippets/cookbook-search.jsx) that filters existing cards by textContent and toggles style.display.

Scoped CSS: hide pagination links whose href starts with /cookbooks/, plus .cookbook-tag styling.

Latest commit vs prior approval: one intro sentence rewrite on cookbooks.mdx. No new files, logic, or nav changes.

Why Low (not Very Low)

This is more than a typo or copy-only edit: it adds a new nav tab, a new interactive snippet, and CSS that hides pagination for cookbook routes. Those are easy to reason about but they are a real user-facing surface on the docs site.

Why not Medium+

No auth, billing, permissions, APIs, or infrastructure.

No production application logic; this repo is a Mintlify docs site.

Search uses the query only for string matching (includes) and does not inject user input as HTML or make network calls.

CSS and navigation changes are limited to the new Cookbooks surface.

No CODEOWNERS file and no code-owner review requirement found.

Approval is not revoked. If later commits expand beyond docs/nav/UI (for example CI, secrets, or site-wide behavior), this approval must be re-evaluated.

_{Sent by Cursor Automation: Assign PR reviewers}

cursor

Stale comment

Risk assessment: Low

Verdict: Low risk. Re-evaluated after adce39e (address review comments, merge main, update cookbook images and card order). Risk did not increase versus the prior Low assessment. Prior approval stands; not re-approving.

What changed (from the diff)

New Cookbooks tab and landing page (docs.json, cookbooks.mdx) with a card grid. Most cards link out to github.com/kernel/cookbooks; two cards link to existing in-repo guides (/browsers/playwright-computer-use-fallback, /browsers/enable-payments-in-browser-agent).

Those two existing guide pages are removed from the Guides tree and listed under Cookbooks → Common Patterns. Remaining sidebar entries are thin cookbooks/*.mdx stubs (title + external url frontmatter) under Harnesses & Models.

Card images under images/cookbooks/.

Tip/link updates on existing integration pages and a changelog URL rewrite to kernel/cookbooks.

Client-side search snippet (snippets/cookbook-search.jsx) that filters matching cards by textContent and toggles style.display.

Scoped CSS: hide pagination links whose href starts with /cookbooks/, plus .cookbook-tag styling.

This update vs the last assessed head is still docs/nav/UI: group rename, card reorder, new images, and moving two existing docs pages into the Cookbooks tab. No CI, secrets, auth, or site-wide runtime changes.

Why Low (not Very Low)

This is more than a typo or copy-only edit: it adds a new nav tab, a new interactive snippet, and CSS that hides pagination for cookbook routes. Those are easy to reason about but they are a real user-facing surface on the docs site.

Why not Medium+

No auth, billing, permissions, APIs, or infrastructure.

No production application logic; this repo is a Mintlify docs site.

Search uses the query only for string matching (includes) and does not inject user input as HTML or make network calls.

CSS and navigation changes are limited to the Cookbooks surface and two relocated guide pages.

No CODEOWNERS file. Branch ruleset require_code_owner_review is false.

Approval is not revoked. If later commits expand beyond docs/nav/UI (for example CI, secrets, or site-wide behavior), this approval must be re-evaluated.

_{Sent by Cursor Automation: Assign PR reviewers}

cursor

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

There are 2 total unresolved issues (including 1 from previous review).

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Want higher recall? High effort reviews run extra passes and find more bugs. A team admin can switch effort levels in the Cursor dashboard.

^{Reviewed by Cursor Bugbot for commit adce39e. Configure here.}

cursor · 2026-09-09T17:08:00Z

+    ).filter((a) => !a.closest('nav') && !a.closest('aside'));
+    const cards = anchors.map((a) => a.closest('.card') || a);
+    return Array.from(new Set(cards));
+  };


Search skips internal cookbook cards

Medium Severity

CookbookSearch only treats anchors whose href starts with the GitHub cookbooks URL as cards, so the Agentic Payments and Playwright cards are never shown or hidden. They stay on screen for every query, and a search for those titles can still render the empty-results message.

Additional Locations (2)

cookbooks.mdx#L13-L17

cookbooks.mdx#L41-L45

^{Reviewed by Cursor Bugbot for commit adce39e. Configure here.}

cursor

Risk assessment: Low

Verdict: Low risk. Re-evaluated after d0f2613 (remove unused cookbook stub pages). Risk did not increase versus the prior Low assessment. Prior approval stands; not re-approving.

What changed (from the diff)

New Cookbooks tab and landing page (docs.json, cookbooks.mdx) with a card grid. Most cards link out to github.com/kernel/cookbooks; two cards link to existing in-repo guides (/browsers/playwright-computer-use-fallback, /browsers/enable-payments-in-browser-agent).
Those two existing guide pages move from the Guides tree into Cookbooks → Common Patterns. Remaining sidebar entries are thin cookbooks/*.mdx stubs (title + external url frontmatter) under Harnesses & Models.
Card images under images/cookbooks/.
Tip/link updates on existing integration pages and a changelog URL rewrite to kernel/cookbooks.
Client-side search snippet (snippets/cookbook-search.jsx) that filters matching GitHub-linked cards by textContent and toggles style.display. Query text is used only for includes matching; no HTML injection or network calls.
Scoped CSS: hide pagination links whose href starts with /cookbooks/, plus .cookbook-tag styling.

This update vs the last assessed head (adce39e) only deletes six unused 4-line stub files (cookbooks/ad-blocker.mdx, chrome-policies.mdx, file-io.mdx, profiles.mdx, proxies.mdx, replays.mdx). They were not in docs.json navigation. No new logic, nav, or CSS.

Why Low (not Very Low)

This is more than a typo or copy-only edit: it adds a new nav tab, a new interactive snippet, and CSS that hides pagination for cookbook routes. Those are easy to reason about but they are a real user-facing surface on the docs site.

Why not Medium+

No auth, billing, permissions, APIs, or infrastructure.
No production application logic; this repo is a Mintlify docs site.
Search uses the query only for string matching and does not inject user input as HTML.
CSS and navigation changes are limited to the Cookbooks surface and two relocated guide pages.
No CODEOWNERS file. Branch ruleset require_code_owner_review is false.

Approval is not revoked. If later commits expand beyond docs/nav/UI (for example CI, secrets, or site-wide behavior), this approval must be re-evaluated.

_{Sent by Cursor Automation: Assign PR reviewers}

goosewin added 3 commits September 1, 2026 10:48

feat: add Cookbooks docs page

21a89b6

New Cookbooks tab with a card gallery for all 16 kernel/cookbooks recipes, per-card feature/integration labels, live search filter (snippets/cookbook-search.jsx), sidebar external links to each cookbook subdirectory, and card artwork in images/cookbooks/.

docs: cross-link cookbooks from integration pages, fix absorbed repo …

15398b5

…links Add cookbook Tips to the five integration pages with a matching cookbook, and point claude-managed-agents-kernel links (integration page + changelog) at kernel/cookbooks subdirectories.

Merge remote-tracking branch 'origin/main' into feature/kernel-docs-c…

10dcac3

…ookbooks-page-94e601 # Conflicts: # style.css

mintlify Bot deployed to staging September 1, 2026 17:51 View deployment

cursor Bot approved these changes Sep 1, 2026 •

edited

Loading

View reviewed changes

cursor Bot reviewed Sep 1, 2026

View reviewed changes

juecd self-requested a review September 2, 2026 13:43

juecd requested changes Sep 2, 2026

View reviewed changes

andrewleesteele mentioned this pull request Sep 8, 2026

Restructure guides IA, add missing pages, fix doc inaccuracies #555

Draft

cursor Bot reviewed Sep 9, 2026

View reviewed changes

mintlify Bot deployed to staging September 9, 2026 16:27 View deployment

juecd added 4 commits September 9, 2026 09:45

Address comments

4c60b36

Merge branch 'main' into feature/kernel-docs-cookbooks-page-94e601

65fcae2

Update images, order of cookbooks

91dab99

merge

adce39e

juecd force-pushed the feature/kernel-docs-cookbooks-page-94e601 branch from 287b9e9 to adce39e Compare September 9, 2026 17:03

juecd self-requested a review September 9, 2026 17:04

mintlify Bot deployed to staging September 9, 2026 17:04 View deployment

cursor Bot reviewed Sep 9, 2026

View reviewed changes

Remove unused files

d0f2613

mintlify Bot deployed to staging September 9, 2026 17:10 View deployment

cursor Bot reviewed Sep 9, 2026

View reviewed changes

juecd merged commit 0ed2577 into main Sep 9, 2026
4 checks passed

juecd deleted the feature/kernel-docs-cookbooks-page-94e601 branch September 9, 2026 17:15

Navigation Menu

Uh oh!

Add Cookbooks page - #537

Add Cookbooks page#537
juecd merged 8 commits into
mainfrom
feature/kernel-docs-cookbooks-page-94e601

goosewin commented Sep 1, 2026 •

edited by cursor Bot

Loading

Uh oh!

mintlify Bot commented Sep 1, 2026 •

edited

Loading

Uh oh!

cursor Bot left a comment •

edited

Loading

Uh oh!

cursor Bot Sep 1, 2026

Uh oh!

juecd Sep 2, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

juecd Sep 2, 2026

Uh oh!

cursor Bot left a comment •

edited

Loading

Uh oh!

cursor Bot left a comment •

edited

Loading

Uh oh!

cursor Bot left a comment

Uh oh!

cursor Bot Sep 9, 2026

Uh oh!

cursor Bot left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants


		<CookbookSearch />

		<Columns className="responsive-columns" cols={3}>


		Every cookbook is self-contained: clone it, set your secrets, run. Use them as 1-click starts for your agents or as templates for your own automations.

		import { CookbookSearch } from '/snippets/cookbook-search.jsx';

Uh oh!

Conversation

goosewin commented Sep 1, 2026 • edited by cursor Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

mintlify Bot commented Sep 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

cursor Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cursor Bot Sep 1, 2026

Choose a reason for hiding this comment

Pagination hide misses production URLs

Uh oh!

juecd Sep 2, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

juecd Sep 2, 2026

Choose a reason for hiding this comment

Uh oh!

cursor Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Risk assessment: Low

What changed (from the diff)

Why Low (not Very Low)

Why not Medium+

Uh oh!

cursor Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Risk assessment: Low

What changed (from the diff)

Why Low (not Very Low)

Why not Medium+

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

cursor Bot Sep 9, 2026

Choose a reason for hiding this comment

Search skips internal cookbook cards

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Risk assessment: Low

What changed (from the diff)

Why Low (not Very Low)

Why not Medium+

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

goosewin commented Sep 1, 2026 •

edited by cursor Bot

Loading

mintlify Bot commented Sep 1, 2026 •

edited

Loading

cursor Bot left a comment •

edited

Loading

cursor Bot left a comment •

edited

Loading

cursor Bot left a comment •

edited

Loading