Skip to content

Clarify gh CLI shortcut on homepage, bump Bun version requirement to >=1.4 - #212

Merged
shouze merged 1 commit into
mainfrom
docs/homepage-gh-cli-and-bun-version
Sep 19, 2026
Merged

shouze merged 1 commit into
mainfrom
docs/homepage-gh-cli-and-bun-version

Conversation

@shouze

@shouze shouze commented Sep 19, 2026

Copy link
Copy Markdown
Contributor

What does this PR do?

  • Homepage install steps (docs/.vitepress/theme/InstallSection.vue): step 2 ("Export your GitHub token") now includes a hint that this step can be skipped entirely if the GitHub CLI is already installed and authenticated — github-code-search retrieves a token automatically via gh auth token.
  • Bumped the documented Bun requirement from >= 1.0 to >= 1.4 in CONTRIBUTING.md, docs/getting-started/index.md and docs/getting-started/installation.md, matching what README.md/AGENTS.md already state — the codebase uses native Bun 1.4+ APIs (Bun.stringWidth/stripANSI/sliceAnsi, node:util's styleText).

How did you verify your code works?

  • Visually verified the homepage change in a local vitepress preview (both hint boxes render correctly, consistent styling).
  • bun test (1016 passing), bun run lint, bun run format:check, bun run knip, bun run build.ts all green.
  • bun run docs:build succeeds.

Copilot AI lite review requested due to automatic review settings September 19, 2026 11:49
@github-actions

Copy link
Copy Markdown
Contributor

Coverage after merging docs/homepage-gh-cli-and-bun-version into main will be

96.86%

Coverage Report
FileStmtsBranchesFuncsLinesUncovered Lines
src
   aggregate.ts100%100%100%100%
   api-utils.ts93.20%100%93.75%93.13%101–103, 65, 73, 86–87, 91–92
   api.ts94.74%100%100%94.07%340–344, 405, 422, 63–69
   cache.ts94.67%100%100%94.29%139–141, 39
   completions.ts99.46%100%100%99.41%282
   group.ts98.92%100%98.33%99.03%263–265, 525, 531, 864
   output.ts99.38%100%95.83%99.66%88
   regex.ts99.42%100%100%99.38%360
   render.ts90.99%100%88.24%91.09%177, 201–206, 208–210, 212–213, 234, 427–428, 528–532, 562–569, 571–579, 581–584
   scroll-cooldown.ts100%100%100%100%
   style.ts100%100%100%100%
   upgrade.ts88.38%100%94.44%87.89%128, 131, 133, 153, 167–168, 188–195, 198–204, 209, 214, 250–253
src/render
   filter-match.ts97.44%100%92.31%100%
   filter.ts100%100%100%100%
   highlight.ts96.63%100%90.40%99.31%284–285
   layout-constants.ts100%100%100%100%
   mouse-hit.ts100%100%100%100%
   mouse.ts100%100%100%100%
   rows.ts99.42%100%100%99.38%239
   selection.ts100%100%100%100%
   summary.ts100%100%100%100%
   team-pick.ts100%100%100%100%
   terminal.ts100%100%100%100%

- InstallSection.vue: add a hint to step 2 noting the export-token step can
  be skipped entirely when the GitHub CLI is installed and authenticated
  (gh auth token is used automatically).
- CONTRIBUTING.md, docs/getting-started/index.md, installation.md: bump the
  documented Bun requirement from >=1.0 to >=1.4, matching README.md and
  AGENTS.md — native Bun 1.4+ APIs (stringWidth/stripANSI/sliceAnsi, styleText)
  are used throughout the codebase.
@shouze
shouze force-pushed the docs/homepage-gh-cli-and-bun-version branch from 0dd8be0 to 17162dd Compare September 19, 2026 11:51
@github-actions

Copy link
Copy Markdown
Contributor

Coverage after merging docs/homepage-gh-cli-and-bun-version into main will be

96.88%

Coverage Report
FileStmtsBranchesFuncsLinesUncovered Lines
src
   aggregate.ts100%100%100%100%
   api-utils.ts93.20%100%93.75%93.13%101–103, 65, 73, 86–87, 91–92
   api.ts94.74%100%100%94.07%340–344, 405, 422, 63–69
   cache.ts94.67%100%100%94.29%139–141, 39
   completions.ts99.46%100%100%99.41%282
   gh-cli.ts100%100%100%100%
   group.ts98.92%100%98.33%99.03%263–265, 525, 531, 864
   output.ts99.38%100%95.83%99.66%88
   regex.ts99.42%100%100%99.38%360
   render.ts90.99%100%88.24%91.09%177, 201–206, 208–210, 212–213, 234, 427–428, 528–532, 562–569, 571–579, 581–584
   scroll-cooldown.ts100%100%100%100%
   style.ts100%100%100%100%
   upgrade.ts88.38%100%94.44%87.89%128, 131, 133, 153, 167–168, 188–195, 198–204, 209, 214, 250–253
src/render
   filter-match.ts97.44%100%92.31%100%
   filter.ts100%100%100%100%
   highlight.ts96.63%100%90.40%99.31%284–285
   layout-constants.ts100%100%100%100%
   mouse-hit.ts100%100%100%100%
   mouse.ts100%100%100%100%
   rows.ts99.42%100%100%99.38%239
   selection.ts100%100%100%100%
   summary.ts100%100%100%100%
   team-pick.ts100%100%100%100%
   terminal.ts100%100%100%100%

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Copilot review overview

🟡 Changes recommended

The advertised token fallback is not implemented, and the external link needs an accessible new-tab indication.

Get a fresh assessment by requesting another Copilot review.

Review effort: Lite
Findings: 1 Medium severity

Open (1)
What changed in this PR

This PR updates onboarding documentation for Bun ≥1.4 and adds GitHub CLI token guidance to the homepage.

Changes:

  • Updates Bun requirements in contributor and getting-started documentation.
  • Adds a GitHub CLI token shortcut hint.
  • Requires fixes for the unsupported gh auth token fallback and missing new-tab accessibility label.
File Summary
docs/​getting-started/​installation.md Updates Bun requirement.
docs/​getting-started/​index.md Updates Bun requirement.
docs/​.vitepress/​theme/​InstallSection.vue Adds GitHub CLI guidance; contains one moderate issue and one nit.
CONTRIBUTING.md Updates Bun prerequisite.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread docs/.vitepress/theme/InstallSection.vue
@github-actions

Copy link
Copy Markdown
Contributor

🔦 Lighthouse Report

Page ⚡ Perf ♿ A11y 🛡️ BP 🔍 SEO Report
/github-code-search/getting-started/ 🟢 99 (≥96) 🟢 100 (≥99) 🟢 100 (≥99) 🟢 100 (≥99) 🔗 view
/github-code-search/ 🟢 96 (≥96) 🟢 100 (≥99) 🟢 100 (≥99) 🟢 100 (≥99) 🔗 view

Thresholds: Perf ≥ 96 · A11y ≥ 99 · BP ≥ 99 · SEO ≥ 99
commit 3f8b5a1 · full workflow run

@shouze
shouze merged commit 4847232 into main Sep 19, 2026
8 checks passed
@shouze
shouze deleted the docs/homepage-gh-cli-and-bun-version branch September 19, 2026 12:03
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.

2 participants