diff --git a/docs/cli/authentication.md b/docs/cli/authentication.md
index 4acdc9de58..3dcab5784b 100644
--- a/docs/cli/authentication.md
+++ b/docs/cli/authentication.md
@@ -173,4 +173,4 @@ following authentication methods if available:
 If none of these environment variables are set in a non-interactive session, the CLI will exit with an error.
 
 For comprehensive guidance on using Gemini CLI programmatically and in
-automation workflows, see the [Headless Mode Guide](./headless.md).
+automation workflows, see the [Headless Mode Guide](../headless.md).
diff --git a/docs/cli/index.md b/docs/cli/index.md
index 1ab6517f5a..13cf37470c 100644
--- a/docs/cli/index.md
+++ b/docs/cli/index.md
@@ -8,7 +8,7 @@ Within Gemini CLI, `packages/cli` is the frontend for users to send and receive
 - **[Commands](./commands.md):** A reference for Gemini CLI commands (e.g., `/help`, `/tools`, `/theme`).
 - **[Configuration](./configuration.md):** A guide to tailoring Gemini CLI behavior using configuration files.
 - **[Enterprise](./enterprise.md):** A guide to enterprise configuration.
-- **[Headless Mode](./headless.md):** A comprehensive guide to using Gemini CLI programmatically for scripting and automation.
+- **[Headless Mode](../headless.md):** A comprehensive guide to using Gemini CLI programmatically for scripting and automation.
 - **[Token Caching](./token-caching.md):** Optimize API costs through token caching.
 - **[Themes](./themes.md)**: A guide to customizing the CLI's appearance with different themes.
 - **[Tutorials](tutorials.md)**: A tutorial showing how to use Gemini CLI to automate a development task.
@@ -29,4 +29,4 @@ You can also use the `--prompt` or `-p` flag:
 gemini -p "What is fine tuning?"
 ```
 
-For comprehensive documentation on headless usage, scripting, automation, and advanced examples, see the **[Headless Mode](./headless.md)** guide.
+For comprehensive documentation on headless usage, scripting, automation, and advanced examples, see the **[Headless Mode](../headless.md)** guide.
diff --git a/docs/cli/headless.md b/docs/headless.md
similarity index 100%
rename from docs/cli/headless.md
rename to docs/headless.md