Skip to content

docs: sync CLI reference with latest commands#463

Merged
rgarcia merged 2 commits into
mainfrom
docs/sync-cli-reference-readme
Jul 25, 2026
Merged

docs: sync CLI reference with latest commands#463
rgarcia merged 2 commits into
mainfrom
docs/sync-cli-reference-readme

Conversation

@rgarcia

@rgarcia rgarcia commented Jul 25, 2026

Copy link
Copy Markdown
Contributor

Description

Sync the docs site's CLI reference with the command and flag coverage added in kernel/cli#140 and documented in the CLI README.

Updates:

  • document browser default-proxy and process env/TTY flags
  • document profile, project, and proxy update commands
  • document managed-auth timeline, telemetry, and canonical submit flags
  • document API key lookup/rotation additions
  • add an Organization Limits CLI page, card, and navigation entry
  • align the Homebrew install command with the CLI README

The timeline JSON docs describe the current pagination envelope (events, page, per_page, has_more) added by the follow-up bugbot fix in the merged CLI PR rather than the README's earlier "raw array" wording.

Implementation Checklist

  • If updating our CLI, update the info in our CLI reference
  • Added the new Organization Limits page to docs.json navigation

Testing

  • git diff --check
  • docs.json parses as valid JSON
  • mintlify dev --port 3333 starts successfully
  • Updated pages return HTTP 200 locally:
    • /reference/cli
    • /reference/cli/browsers
    • /reference/cli/profiles
    • /reference/cli/projects
    • /reference/cli/proxies
    • /reference/cli/managed-auth
    • /reference/cli/api-keys
    • /reference/cli/org

Related change


Note

Low Risk
Documentation and navigation only; no runtime or API behavior changes in this repo.

Overview
Syncs the docs site CLI reference with command and flag coverage from the latest Kernel CLI release.

Adds a new Organization Limits page (kernel org limits get/set), navigation entry, and overview card. Expands existing pages with update commands for profiles, projects, and proxies; API key rotation, --include-deleted on get, and refreshed overview copy; browser session --disable-default-proxy and VM process --env, PTY/cols/rows on spawn; managed auth telemetry on create/login/update, canonical --field-value / --choice-id on submit, and connections timeline with paginated JSON; profile download --format; proxy check --url.

Reviewed by Cursor Bugbot for commit f0a4eb8. Bugbot is set up for automated code reviews on this repo. Configure here.

@vercel

vercel Bot commented Jul 25, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Error Error Jul 25, 2026 1:04pm

@mintlify

mintlify Bot commented Jul 25, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
Kernel 🟢 Ready View Preview Jul 25, 2026, 12:39 PM

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

cursor[bot]
cursor Bot approved these changes Jul 25, 2026

@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

Verdict: Risk unchanged after synchronize. Prior approval remains valid; not re-approving.

Re-evaluation (post-update)

Previously approved at 3e75815 as Very Low. New commit f0a4eb8 only corrects the Homebrew install command (brew install kernel/tap/kernel). That does not increase blast radius or introduce runtime/infra changes.

Evidence (full diff)

  • 9 files, +134 / −3 — Mintlify CLI reference (.mdx) plus one docs.json nav entry for Organization Limits.
  • No application code, runtime config, auth/billing logic, infrastructure, schema, or prompt/instruction files modified.
  • Content documents CLI flags/commands and adds reference/cli/org.mdx.

Risk factors

  • Blast radius: Docs site content only; incorrect reference copy can mislead users but does not change product behavior.
  • Complexity: Straightforward reference additions; easy to reason about.
  • Infra / security / shared systems: None modified.

Decision

Very Low — documentation-only sync. Risk did not increase after the latest push, so approval is not revoked. Per policy, not re-approving an already-approved PR.

No CODEOWNERS file applies.

Open in Web View Automation 

Sent by Cursor Automation: Assign PR reviewers

@rgarcia
rgarcia merged commit eda27f2 into main Jul 25, 2026
6 of 7 checks passed
@rgarcia
rgarcia deleted the docs/sync-cli-reference-readme branch July 25, 2026 13:05
@mintlify

mintlify Bot commented Jul 25, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
Kernel 🟡 Building Jul 25, 2026, 12:38 PM

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

masnwilliams added a commit that referenced this pull request Jul 25, 2026
Carries main's CLI-reference sync (#463) and managed-auth tab-ownership
docs (#462) onto the migrated content/docs paths. New reference/cli/org
page relocated via directory-rename detection; the other CLI/auth edits
auto-merged, docs.json nav merged.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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