🤖 fix: complete mintlify migration

- Remove mdbook workflow (.github/workflows/docs.yml)
- Remove mdbook-specific files (book.toml, SUMMARY.md)
- Remove mdbook build scripts (docs_build.sh, docs.sh)
- Update Makefile docs targets for Mintlify
- Fix formatting issues in docs

_Generated with mux_

Author: ammar-agent

.github/workflows/docs.yml

@@ -49,7 +49,7 @@ include fmt.mk
 .PHONY: test test-unit test-integration test-watch test-coverage test-e2e smoke-test
 .PHONY: dist dist-mac dist-win dist-linux
 .PHONY: vscode-ext vscode-ext-install
-.PHONY: docs docs-server docs-watch check-docs-links
+.PHONY: docs docs-server
 .PHONY: storybook storybook-build test-storybook chromatic
 .PHONY: benchmark-terminal
 .PHONY: ensure-deps rebuild-native
@@ -213,7 +213,7 @@ build/icon.png: docs/img/logo.webp scripts/generate-icons.ts
 	@bun scripts/generate-icons.ts png
 
 ## Quality checks (can run in parallel)
-static-check: lint typecheck fmt-check check-eager-imports check-bench-agent check-docs-links ## Run all static checks (includes startup performance checks)
+static-check: lint typecheck fmt-check check-eager-imports check-bench-agent ## Run all static checks
 
 check-bench-agent: ## Verify terminal-bench agent configuration and imports
 	@./scripts/check-bench-agent.sh
@@ -337,23 +337,11 @@ vscode-ext-install: ## Build and install VS Code extension locally
 	@$(MAKE) -C vscode install
 
 ## Documentation
-docs: ## Build documentation
-	@./scripts/docs_build.sh
+docs: ## Build documentation (Mintlify)
+	@cd docs && npx mintlify build
 
-docs-server: ## Serve documentation locally (opens browser)
-	@./scripts/docs.sh
-
-docs-watch: ## Watch and rebuild documentation
-	@cd docs && mdbook watch
-
-check-docs-links: ## Check documentation for broken links (requires mdbook tools via nix)
-	@if command -v mdbook >/dev/null 2>&1 && command -v mdbook-linkcheck >/dev/null 2>&1; then \
-		$(MAKE) docs && \
-		echo "🔗 Checking documentation links..." && \
-		cd docs && mdbook-linkcheck --standalone .; \
-	else \
-		echo "⏭️  Skipping docs link check (mdbook tools not installed - use 'nix develop' for full checks)"; \
-	fi
+docs-server: node_modules/.installed ## Serve documentation locally (opens browser)
+	@cd docs && npx mintlify dev
 
 ## Storybook
 storybook: node_modules/.installed ## Start Storybook development server

Makefile

@@ -156,7 +156,7 @@ Avoid mock-heavy tests that verify implementation details rather than behavior.
 - Prefer fixes that simplify existing code; such simplifications often do not need new tests.
 - When adding complexity, add or extend tests. If coverage requires new infrastructure, propose the harness and then add the tests there.
 
-{/* IMPORTANT: Do not rename these Mode headings; the parser extracts them verbatim. */}
+{/_ IMPORTANT: Do not rename these Mode headings; the parser extracts them verbatim. _/}
 
 ## Mode: Exec
 

docs/AGENTS.md

@@ -3,7 +3,6 @@ title: Mux Codes
 description: Redeem free LLM token credits for evaluating Mux
 ---
 
-
 Mux codes are free LLM token credits for evaluating Mux. Coder employees disburse them at events to users we think will enjoy Mux. If you want to get your hands on a code, ask the nearest Coder employee.
 
 A code looks like `ABC-123`.

docs/SUMMARY.md

@@ -3,6 +3,8 @@ title: System Prompt
 description: How mux constructs the system prompt for AI models
 ---
 
+# System Prompt
+
 `mux` is interested in supporting a variety of models at different levels of performance.
 
 To that end, we're built on the [Vercel AI SDK](https://ai-sdk.dev/providers/ai-sdk-providers) which does most of the heavy lifting in creating a unified API for all models.
@@ -11,7 +13,7 @@ Even with consistent support at the protocol layer, we have found that different
 
 Here's a snippet from `src/node/services/systemMessage.ts` which is our shared system prompt (minus tools).
 
-{/* BEGIN SYSTEM_PROMPT_DOCS */}
+<!-- BEGIN SYSTEM_PROMPT_DOCS -->
 
 ```typescript
 // The PRELUDE is intentionally minimal to not conflict with the user's instructions.
@@ -59,4 +61,4 @@ You are in a git worktree at ${workspacePath}
 }
 ```
 
-{/* END SYSTEM_PROMPT_DOCS */}
+<!-- END SYSTEM_PROMPT_DOCS -->

docs/book.toml

@@ -3,11 +3,8 @@ title: Vim Mode
 description: Vim-style editing in the mux chat input
 ---
 
-{/* Keep this file in sync with:
-     - src/components/VimTextArea.tsx (implementation)
-     - src/utils/vim.ts (core logic)
-     - src/utils/vim.test.ts (test suite)
-*/}
+{/_ Keep this file in sync with: - src/components/VimTextArea.tsx (implementation) - src/utils/vim.ts (core logic) - src/utils/vim.test.ts (test suite)
+_/}
 
 mux includes a built-in Vim mode for the chat input, providing familiar Vim-style editing for power users.