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