Skip to content

Add managed auth CLI reference page#396

Merged
masnwilliams merged 4 commits into
mainfrom
hypeship/cli-docs-auth-connections
Jun 3, 2026
Merged

Add managed auth CLI reference page#396
masnwilliams merged 4 commits into
mainfrom
hypeship/cli-docs-auth-connections

Conversation

@masnwilliams
Copy link
Copy Markdown
Contributor

@masnwilliams masnwilliams commented Jun 3, 2026

Summary

  • Adds a Managed Auth CLI reference page (reference/cli/managed-auth.mdx) documenting kernel auth connections, kernel credentials, and kernel credential-providers — none of which were previously documented.
  • Adds the page to the CLI nav, ordered after Browsers and Apps (so Browsers comes first, not managed auth).
  • Documents kernel status, kernel upgrade, and kernel completion on the CLI index.

Keeps the existing single-page-per-area CLI layout — managed auth is its own page rather than living under the CLI Authentication page (which covers authenticating the CLI itself).

Flags were taken directly from kernel <command> --help of a local build.

Notes

  • docs.json validated; all CLI nav pages resolve to files.
  • Did not render with mintlify dev (no preview env here).

Test plan

  • mintlify dev renders the new page without MDX errors
  • Managed Auth appears after Browsers/Apps in the CLI sidebar
  • Cross-links to /auth/overview, /auth/programmatic, /auth/credentials, /auth/profiles resolve

Note

Low Risk
Documentation-only changes; no application or CLI behavior is modified.

Overview
Adds Managed Auth to the CLI docs: a new reference/cli/managed-auth page in the CLI tab nav, a homepage card linking to it, and a Utility Commands section on the CLI index for kernel status, kernel upgrade, and kernel completion.

The new page documents managed auth connections (kernel auth connections CRUD, login, submit, follow), credentials (kernel credentials including TOTP), and credential providers (kernel credential-providers), with flags aligned to the shipped CLI and links to the existing /auth/* guides.

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

Add CLI reference for `kernel auth connections`, `kernel credentials`,
and `kernel credential-providers`, plus `kernel status`, `kernel upgrade`,
and `kernel completion` on the CLI index.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@mintlify
Copy link
Copy Markdown
Contributor

mintlify Bot commented Jun 3, 2026

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

Project Status Preview Updated (UTC)
Kernel 🟢 Ready View Preview Jun 3, 2026, 1:55 PM

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

@masnwilliams masnwilliams marked this pull request as ready for review June 3, 2026 13:56
@firetiger-agent
Copy link
Copy Markdown

Firetiger deploy monitoring skipped

This PR didn't match the auto-monitor filter configured on your GitHub connection:

PRs in the kernel, infra, hypeman, and hypeship repos. kernel is a ~mono repo with many logical services underneath, ensure to focus on the implicated service for the PR

Reason: This PR only edits documentation (MDX files in docs), not the kernel service code itself, so it doesn't require deploy monitoring.

To monitor this PR anyway, reply with @firetiger monitor this.

Copy link
Copy Markdown

@cursor cursor Bot left a comment

Choose a reason for hiding this comment

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

Risk assessment: Very Low

Evidence from the diff: this PR only updates reference/cli.mdx and reference/cli/auth.mdx with CLI reference documentation for managed auth connections, credentials, credential providers, and utility commands. There are no executable code changes, config changes, infrastructure changes, model prompt/instruction changes, schema changes, or auth/permission logic changes.

I did not find a CODEOWNERS file in the repository, and the PR did not already have an approval in the review metadata I checked, so approval is appropriate for this risk level.

Open in Web View Automation 

Sent by Cursor Automation: Assign PR reviewers

Split managed auth connections, credentials, and credential-providers
out of the CLI Authentication page (which covers authenticating the CLI
itself) into a dedicated Managed Auth page, and add it to the nav.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@masnwilliams masnwilliams changed the title Document managed auth, credentials, and utility CLI commands Add Managed Auth CLI page + document utility commands Jun 3, 2026
Copy link
Copy Markdown

@cursor cursor Bot left a comment

Choose a reason for hiding this comment

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

Risk assessment: Very Low

Evidence from the actual diff: the current head changes only Mintlify documentation/navigation files: docs.json, reference/cli.mdx, and a new reference/cli/managed-auth.mdx. The update adds a sidebar entry, a CLI index card/utility-command docs, and a new managed-auth CLI reference page. There are no executable code changes, infrastructure changes, schema changes, prompt/instruction-file changes, or production auth/permission logic changes.

I also compared the new head against the previously approved commit. The synchronized update primarily moves managed-auth CLI documentation out of reference/cli/auth.mdx into its own page and adds it to navigation, so the risk has not increased. I found no CODEOWNERS file in the repository, and the PR already has an approval, so I’m leaving this comment-only assessment rather than re-approving.

Open in Web View Automation 

Sent by Cursor Automation: Assign PR reviewers

Split the consolidated browsers, apps, and managed-auth pages into one
page per API tag, grouped and ordered to match the OpenAPI spec
(browser controls, observability, resources & auth, deploy, org). Adds
previously undocumented commands surfaced by the split: browser
telemetry, curl, update, deploy github/get/delete, invoke
get/history/browsers/update, and app delete.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@masnwilliams masnwilliams changed the title Add Managed Auth CLI page + document utility commands Reorganize CLI reference to mirror OpenAPI tag structure Jun 3, 2026
Copy link
Copy Markdown

@cursor cursor Bot left a comment

Choose a reason for hiding this comment

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

Risk assessment: Very Low

Evidence from the actual diff: the synchronized PR still only changes Mintlify documentation and docs navigation. The current head modifies docs.json to reorganize the CLI sidebar and adds/splits CLI reference MDX pages under reference/cli/* for browsers, managed auth, credentials, deployments, invocations, profiles, proxies, and related commands. I found no executable code changes, infrastructure changes, schema changes, model prompt/instruction changes, or production auth/permission logic changes.

The larger synchronized diff is a docs reorganization, but it doesn't expand beyond the documentation surface, so the risk has not increased out of the prior Very Low category. I found no CODEOWNERS file in the repository. The PR already has an approval recorded, so I’m leaving this comment-only reassessment rather than re-approving.

Open in Web View Automation 

Sent by Cursor Automation: Assign PR reviewers

Revert the per-tag page split; restore the consolidated browsers/apps
pages and the single managed-auth page. Reorder the CLI nav and index
cards so Browsers comes before Managed Auth.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@masnwilliams masnwilliams changed the title Reorganize CLI reference to mirror OpenAPI tag structure Add managed auth CLI reference page Jun 3, 2026
Copy link
Copy Markdown

@cursor cursor Bot left a comment

Choose a reason for hiding this comment

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

Risk assessment: Very Low

Evidence from the actual diff: the current head changes only Mintlify documentation/navigation files: docs.json, reference/cli.mdx, and the new reference/cli/managed-auth.mdx. The diff adds one CLI sidebar entry, one CLI index card plus utility-command docs, and a managed-auth CLI reference page. I found no executable code changes, infrastructure changes, schema changes, model prompt/instruction changes, or production auth/permission logic changes.

The PR is already approved in GitHub review metadata, and I found no CODEOWNERS file in the repository, so I’m leaving this comment-only reassessment rather than re-approving. The synchronized update does not increase risk; it narrows the previous broader CLI docs split back to this docs-only surface.

Open in Web View Automation 

Sent by Cursor Automation: Assign PR reviewers

@masnwilliams masnwilliams merged commit a33ae0f into main Jun 3, 2026
4 checks passed
@masnwilliams masnwilliams deleted the hypeship/cli-docs-auth-connections branch June 3, 2026 15:29
jarugupj added a commit that referenced this pull request Jun 3, 2026
Reconciles with #396 (managed auth CLI page) and the cli.mdx utility
commands section now on main. Drops the now-duplicate auth-connections,
credentials, status, and upgrade pages; keeps the unique additions
(proxies, browser-pools, profiles), the brew tap fix, the create
template refresh, the browsers-page trim, and the grouped CLI nav.
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