diff --git a/.github/actions/build_docs/action.yml b/.github/actions/build_docs/action.yml
index 27f0f37d4f..19b8801123 100644
--- a/.github/actions/build_docs/action.yml
+++ b/.github/actions/build_docs/action.yml
@@ -19,6 +19,12 @@ runs:
       shell: bash -euxo pipefail {0}
       run: ./script/linux
 
+    - name: Check for broken links
+      uses: lycheeverse/lychee-action@82202e5e9c2f4ef1a55a3d02563e1cb6041e5332 # v2.4.1
+      with:
+        args: --no-progress './docs/src/**/*'
+        fail: true
+
     - name: Build book
       shell: bash -euxo pipefail {0}
       run: |
diff --git a/crates/assistant_tools/src/edit_agent/evals/fixtures/zode/prompt.md b/crates/assistant_tools/src/edit_agent/evals/fixtures/zode/prompt.md
index 2496c3582b..902e43857c 100644
--- a/crates/assistant_tools/src/edit_agent/evals/fixtures/zode/prompt.md
+++ b/crates/assistant_tools/src/edit_agent/evals/fixtures/zode/prompt.md
@@ -498,7 +498,7 @@ client.with_options(max_retries=5).messages.create(
 ### Timeouts
 
 By default requests time out after 10 minutes. You can configure this with a `timeout` option,
-which accepts a float or an [`httpx.Timeout`](https://www.python-httpx.org/advanced/#fine-tuning-the-configuration) object:
+which accepts a float or an [`httpx.Timeout`](https://www.python-httpx.org/advanced/timeouts/#fine-tuning-the-configuration) object:
 
 ```python
 from anthropic import Anthropic
diff --git a/docs/src/ai/agent-panel.md b/docs/src/ai/agent-panel.md
index e2bdc030c4..3c04ae5c43 100644
--- a/docs/src/ai/agent-panel.md
+++ b/docs/src/ai/agent-panel.md
@@ -3,7 +3,7 @@
 The Agent Panel provides you with a way to interact with LLMs.
 You can use it for various tasks, such as generating code, asking questions about your code base, and general inquiries such as emails and documentation.
 
-To open the Agent Panel, use the `agent: new thread` action in [the Command Palette](./getting-started.md#command-palette) or click the ✨ (sparkles) icon in the status bar.
+To open the Agent Panel, use the `agent: new thread` action in [the Command Palette](../getting-started.md#command-palette) or click the ✨ (sparkles) icon in the status bar.
 
 If you're using the Agent Panel for the first time, you'll need to [configure at least one LLM provider](./configuration.md).
 
diff --git a/docs/src/configuring-zed.md b/docs/src/configuring-zed.md
index d32cd87003..3c7167f980 100644
--- a/docs/src/configuring-zed.md
+++ b/docs/src/configuring-zed.md
@@ -112,7 +112,7 @@ Non-negative `float` values
 
 **Options**
 
-You can find the names of your currently installed extensions by listing the subfolders under the [extension installation location](./extensions/installing-extensions#installation-location):
+You can find the names of your currently installed extensions by listing the subfolders under the [extension installation location](./extensions/installing-extensions.md#installation-location):
 
 On MacOS:
 
diff --git a/docs/src/extensions/context-servers.md b/docs/src/extensions/context-servers.md
index bd4c16126b..52d1f0e442 100644
--- a/docs/src/extensions/context-servers.md
+++ b/docs/src/extensions/context-servers.md
@@ -6,7 +6,7 @@ Extensions may provide [context servers](../ai/mcp.md) for use in the Assistant.
 
 To see a working example of an extension that provides context servers, check out the [`postgres-context-server` extension](https://github.com/zed-extensions/postgres-context-server).
 
-This extension can be [installed as a dev extension](./developing-extensions.html#developing-an-extension-locally) if you want to try it out for yourself.
+This extension can be [installed as a dev extension](./developing-extensions.md#developing-an-extension-locally) if you want to try it out for yourself.
 
 ## Defining context servers
 
diff --git a/docs/src/extensions/slash-commands.md b/docs/src/extensions/slash-commands.md
index f9cf076f88..898649b327 100644
--- a/docs/src/extensions/slash-commands.md
+++ b/docs/src/extensions/slash-commands.md
@@ -6,7 +6,7 @@ Extensions may provide slash commands for use in the Assistant.
 
 To see a working example of an extension that provides slash commands, check out the [`slash-commands-example` extension](https://github.com/zed-industries/zed/tree/main/extensions/slash-commands-example).
 
-This extension can be [installed as a dev extension](./developing-extensions.html#developing-an-extension-locally) if you want to try it out for yourself.
+This extension can be [installed as a dev extension](./developing-extensions.md#developing-an-extension-locally) if you want to try it out for yourself.
 
 ## Defining slash commands
 
diff --git a/docs/src/languages/json.md b/docs/src/languages/json.md
index 166f96c719..94f56999d5 100644
--- a/docs/src/languages/json.md
+++ b/docs/src/languages/json.md
@@ -32,7 +32,7 @@ To workaround this behavior you can add the following to your `.prettierrc` conf
 
 ## JSON Language Server
 
-Zed automatically out of the box supports JSON Schema validation of `package.json` and `tsconfig.json` files, but `json-language-server` can use JSON Schema definitions in project files, from the [JSON Schema Store](https://www.schemastore.org/json/) or other publicly available URLs for JSON validation.
+Zed automatically out of the box supports JSON Schema validation of `package.json` and `tsconfig.json` files, but `json-language-server` can use JSON Schema definitions in project files, from the [JSON Schema Store](https://www.schemastore.org) or other publicly available URLs for JSON validation.
 
 ### Inline Schema Specification
 
diff --git a/docs/src/languages/lua.md b/docs/src/languages/lua.md
index db060033a6..8fdaaafedb 100644
--- a/docs/src/languages/lua.md
+++ b/docs/src/languages/lua.md
@@ -86,7 +86,7 @@ Then in your `.luarc.json`:
 
 ### Inlay Hints
 
-To enable [Inlay Hints](../configuring-languages#inlay-hints) for LuaLS in Zed
+To enable [Inlay Hints](../configuring-languages.md#inlay-hints) for LuaLS in Zed
 
 1. Add the following to your Zed settings.json:
 
diff --git a/docs/src/languages/markdown.md b/docs/src/languages/markdown.md
index ef6c4d38f6..38a2b1c43f 100644
--- a/docs/src/languages/markdown.md
+++ b/docs/src/languages/markdown.md
@@ -23,7 +23,7 @@ def fib(n):
 
 ### Format
 
-Zed supports using Prettier to automatically re-format Markdown documents. You can trigger this manually via the {#action editor::Format} action or via the {#kb editor::Format} keyboard shortcut. Alternately, you can automatically format by enabling [`format_on_save`](./configuring-zed.md#format-on-save) in your settings.json:
+Zed supports using Prettier to automatically re-format Markdown documents. You can trigger this manually via the {#action editor::Format} action or via the {#kb editor::Format} keyboard shortcut. Alternately, you can automatically format by enabling [`format_on_save`](../configuring-zed.md#format-on-save) in your settings.json:
 
 ```json
   "languages": {
diff --git a/legal/terms.md b/legal/terms.md
index 20fc638dc5..88afa36aa9 100644
--- a/legal/terms.md
+++ b/legal/terms.md
@@ -94,11 +94,11 @@ Output is provided "as is" without any warranties or guarantees of functionality
 
 When using Zed AI Services to provide Edit Predictions in connection with certain open source software projects, You may elect to share requests, responses and feedback comments (collectively "Model Improvement Feedback") with Zed, and Zed may use the same to improve Zed Edit Predictions models. You may opt-out of sharing Model Improvement Feedback at any time.
 
-For more information on Zed Edit Predictions please see: [https://zed.dev/docs/ai-improvement](https://zed.dev/docs/ai-improvement)
+For more information on Zed Edit Predictions please see: [https://zed.dev/docs/ai/ai-improvement](https://zed.dev/docs/ai/ai-improvement)
 
 When using Zed AI Services in connection with the Agent Panel, You may elect to share with Zed requests, responses and feedback regarding the Agent Panel and related Output (the “Agent Improvement Feedback”) with Zed, and Zed may use the same to improve the Agent Panel and related Output. Zed will only collect Agent Improvement Feedback when You elect to share the same.
 
-For more information regarding the Agent Panel please see: [https://zed.dev/docs/ai-improvement](https://zed.dev/docs/ai-improvement)
+For more information regarding the Agent Panel please see: [https://zed.dev/docs/ai/ai-improvement](https://zed.dev/docs/ai/ai-improvement)
 
 #### 3.4. Privacy Policy
 
diff --git a/lychee.toml b/lychee.toml
new file mode 100644
index 0000000000..a769ae3b20
--- /dev/null
+++ b/lychee.toml
@@ -0,0 +1,29 @@
+retry_wait_time = 5
+
+accept = ["200..=204", "429"]
+
+max_retries = 5
+
+timeout = 45
+
+exclude = [
+    # Don't fail CI check if collab is down
+    'https://staging-collab.zed.dev/',
+    "https://collab.zed.dev",
+
+    # Slow and unreliable server.
+    'https://repology.org',
+
+    # The following websites are rate limited or use bot detection and aren't nice enough to respond with 429:
+    'https://openai.com',
+    'https://claude.ai/download',
+    'https://www.perplexity.ai',
+    'https://platform.deepseek.com',
+    'https://console.anthropic.com',
+    'https://platform.openai.com',
+    'https://linux.die.net/man/1/sed',
+    'https://allaboutcookies.org',
+    'https://www.gnu.org',
+    'https://auth.mistral.ai',
+    'https://console.mistral.ai',
+]