From 17162dd07d1e658aad535fe7fccae3079fe43857 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20HOUZ=C3=89?= <sebastien.houze@fulll.fr>
Date: Sat, 19 Sep 2026 13:49:32 +0200
Subject: [PATCH] Clarify gh CLI shortcut on homepage, bump Bun version to
 >=1.4 in docs
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 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.
---
 CONTRIBUTING.md                          |  2 +-
 docs/.vitepress/theme/InstallSection.vue | 21 +++++++++++++++++++++
 docs/getting-started/index.md            |  2 +-
 docs/getting-started/installation.md     |  2 +-
 4 files changed, 24 insertions(+), 3 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 257a1b6..7e67162 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -4,7 +4,7 @@ Thank you for taking the time to contribute! This document describes how to set
 
 ## Prerequisites
 
-- [Bun](https://bun.sh) ≥ 1.0
+- [Bun](https://bun.sh) ≥ 1.4
 - A GitHub personal access token with `repo` scope (for integration testing)
 
 ## Development setup
diff --git a/docs/.vitepress/theme/InstallSection.vue b/docs/.vitepress/theme/InstallSection.vue
index 050b37f..df0e078 100644
--- a/docs/.vitepress/theme/InstallSection.vue
+++ b/docs/.vitepress/theme/InstallSection.vue
@@ -153,6 +153,27 @@ function copySearch() {
           <h3 class="is-step-label">
             <span class="sr-only">Step 2: </span>Export your GitHub token
           </h3>
+          <div class="is-token-hint is-token-hint-skip">
+            <svg
+              class="is-info-icon"
+              width="15"
+              height="15"
+              viewBox="0 0 24 24"
+              fill="none"
+              stroke="currentColor"
+              stroke-width="2"
+              stroke-linecap="round"
+              stroke-linejoin="round"
+              aria-hidden="true"
+            >
+              <circle cx="12" cy="12" r="10" />
+              <path d="M12 16v-4M12 8h.01" />
+            </svg>
+            Already using the
+            <a href="https://cli.github.com/" target="_blank" rel="noopener noreferrer"
+              >GitHub CLI</a
+            >? Skip this step — a token is retrieved automatically via <code>gh auth token</code>.
+          </div>
           <div class="is-token-hint">
             <svg
               class="is-info-icon"
diff --git a/docs/getting-started/index.md b/docs/getting-started/index.md
index bf6667a..1e15799 100644
--- a/docs/getting-started/index.md
+++ b/docs/getting-started/index.md
@@ -3,7 +3,7 @@
 The only runtime prerequisite is a **GitHub personal access token** (or the [GitHub CLI](https://cli.github.com/), see below). The pre-compiled binary is self-contained and has no runtime dependency — you do not need Bun to run it.
 
 ::: tip Building from source?
-If you want to build `github-code-search` from source, you will additionally need [Bun](https://bun.sh) ≥ 1.0. See the [Installation guide](/getting-started/installation#from-source).
+If you want to build `github-code-search` from source, you will additionally need [Bun](https://bun.sh) ≥ 1.4. See the [Installation guide](/getting-started/installation#from-source).
 :::
 
 ## GitHub token
diff --git a/docs/getting-started/installation.md b/docs/getting-started/installation.md
index b8846b1..96893f4 100644
--- a/docs/getting-started/installation.md
+++ b/docs/getting-started/installation.md
@@ -47,7 +47,7 @@ The script automatically adds the install directory to your user PATH. New termi
 
 ## From source
 
-Requires [Bun](https://bun.sh) ≥ 1.0.
+Requires [Bun](https://bun.sh) ≥ 1.4.
 
 ```bash
 git clone https://github.com/fulll/github-code-search