Revert "🤖 docs: generate first-class models table from knownModels.ts (#948)"

This reverts commit eb52bd4.

Author: ammario

docs/AGENTS.md

@@ -36,7 +36,7 @@ gh pr view <number> --json mergeable,mergeStateStatus | jq '.'
 
 ## Documentation Rules
 
-- No free-floating Markdown. User docs live in `docs/` (read `docs/README.mdx`, add pages to `docs.json` navigation, use standard Markdown + mermaid). Developer/test notes belong inline as comments.
+- No free-floating Markdown. User docs live in `docs/` (read `docs/README.md`, add pages to `docs.json` navigation, use standard Markdown + mermaid). Developer/test notes belong inline as comments.
 - For planning artifacts, use the `propose_plan` tool or inline comments instead of ad-hoc docs.
 - Do not add new root-level docs without explicit request; during feature work rely on code + tests + inline comments.
 - Test documentation stays inside the relevant test file as commentary explaining setup/edge cases.
@@ -168,10 +168,6 @@ Avoid mock-heavy tests that verify implementation details rather than behavior.
 - When Plan Mode is requested, assume the user wants the actual completed plan; do not merely describe how you would devise one.
 - Attach a net LoC estimate (product code only) to each recommended approach.
 
-## Model: openai.\*
-
-- Use the `gh` CLI for GitHub operations (e.g., opening/submitting PRs).
-
 ## Tool: status_set
 
 - Set status url to the Pull Request once opened

docs/README.md

@@ -24,12 +24,12 @@ docs/
 ├── docs.json        # Mintlify configuration (navigation, theme, etc.)
 ├── custom.css       # Custom styling
 ├── img/             # Images and logos
-└── *.mdx            # Documentation pages
+└── *.md             # Documentation pages
 ```
 
 ## Adding Content
 
-1. Create a new `.mdx` file in `docs/`
+1. Create a new `.md` file in `docs/`
 2. Add frontmatter with title and description
 3. Add the page to `docs.json` navigation
 4. Use standard markdown + mermaid diagrams
@@ -45,7 +45,7 @@ description: Brief description for SEO
 
 ## Writing Guidelines
 
-See [STYLE.mdx](./STYLE.mdx) for documentation writing guidelines.
+See [STYLE.md](./STYLE.md) for documentation writing guidelines.
 
 ## CI/CD
 

docs/agentic-git-identity.md

@@ -26,9 +26,7 @@ Create a separate GitHub account for your agent:
 2. Use a distinctive username (e.g., `yourname-agent`, `yourname-ai`)
 3. Use a separate email (GitHub allows plus-addressing: `yourname+ai@example.com`)
 
-<Info>
-  This is optional but recommended. You can also use your main account with a different email/name.
-</Info>
+<Info>This is optional but recommended. You can also use your main account with a different email/name.</Info>
 
 ## Step 2: Generate Classic GitHub Token
 
@@ -59,10 +57,7 @@ Add the Git identity environment variables as [Project Secrets](/project-secrets
 
 These environment variables will be automatically injected when the agent runs Git commands in that project.
 
-<Info>
-  If you need the agent identity outside of mux, you can alternatively set these as global
-  environment variables in your shell configuration (`~/.zshrc`, `~/.bashrc`, etc.)
-</Info>
+<Info>If you need the agent identity outside of mux, you can alternatively set these as global environment variables in your shell configuration (`~/.zshrc`, `~/.bashrc`, etc.)</Info>
 
 ## Step 4: Configure GitHub Authentication
 
@@ -106,7 +101,4 @@ git config --global credential.helper ""
 git config --global --add credential.helper '!gh auth git-credential'
 ```
 
-<Warning>
-  The "replace all" approach will disable platform keychain helpers and may break Git authentication
-  for non-GitHub remotes (GitLab, Bitbucket, etc.).
-</Warning>
+<Warning>The "replace all" approach will disable platform keychain helpers and may break Git authentication for non-GitHub remotes (GitLab, Bitbucket, etc.).</Warning>

docs/context-management.md

@@ -152,9 +152,7 @@ Remove oldest 50% of messages.
 
 ### OpenAI Responses API Limitation
 
-<Warning>
-  `/truncate` does not work with OpenAI models due to the Responses API architecture:
-</Warning>
+<Warning>`/truncate` does not work with OpenAI models due to the Responses API architecture:</Warning>
 
 - OpenAI's Responses API stores conversation state server-side
 - Manual message deletion via `/truncate` doesn't affect the server-side state

docs/install.md

@@ -22,10 +22,7 @@ Download pre-built binaries of `main` from [GitHub Actions](https://github.com/c
   - `macos-dmg-arm64` (Apple Silicon)
 - **Linux**: AppImage (portable, works on most distros)
 
-<Info>
-  Windows builds are only available from [releases](https://github.com/coder/mux/releases), not from
-  development builds.
-</Info>
+<Info>Windows builds are only available from [releases](https://github.com/coder/mux/releases), not from development builds.</Info>
 
 To download:
 
@@ -60,17 +57,11 @@ The app is code-signed and notarized by Apple, so it will open without security
 3. Follow the installation prompts
 4. Launch Mux from the Start menu or desktop shortcut
 
-<Warning>
-  Windows support is currently in alpha. Please [report any
-  issues](https://github.com/coder/mux/issues) you encounter.
-</Warning>
+<Warning>Windows support is currently in alpha. Please [report any issues](https://github.com/coder/mux/issues) you encounter.</Warning>
 
 ### Testing Pre-Release Builds
 
-<Warning>
-  Only builds from the `main` branch are signed and notarized. If you're testing a build from a pull
-  request or other branch, you'll need to bypass macOS Gatekeeper:
-</Warning>
+<Warning>Only builds from the `main` branch are signed and notarized. If you're testing a build from a pull request or other branch, you'll need to bypass macOS Gatekeeper:</Warning>
 
 1. After installing, open Terminal
 2. Run: `xattr -cr /Applications/Mux.app`

docs/keybinds.md

@@ -5,10 +5,7 @@ description: Complete keyboard shortcut reference for mux
 
 mux is designed to be keyboard-driven for maximum efficiency. All major actions have keyboard shortcuts.
 
-<Info>
-  This document should be kept in sync with `src/utils/ui/keybinds.ts`, which is the source of truth
-  for keybind definitions.
-</Info>
+<Info>This document should be kept in sync with `src/utils/ui/keybinds.ts`, which is the source of truth for keybind definitions.</Info>
 
 ## Platform Conventions
 

docs/models.mdx docs/models.mddocs/models.mdx renamed to docs/models.md

@@ -9,28 +9,6 @@ See also:
 
 mux supports multiple AI providers through its flexible provider architecture.
 
-### First-class models
-
-mux ships with a curated set of first-class models that we keep up to date with the frontier. You can also use any custom model from a supported provider with `/model <provider:model_id>`.
-
-{/* BEGIN KNOWN_MODELS_TABLE */}
-
-| Model                | ID                            | Aliases                                  | Default |
-| -------------------- | ----------------------------- | ---------------------------------------- | ------- |
-| Opus 4.5             | `anthropic:claude-opus-4-5`   | `opus`                                   | Yes     |
-| Sonnet 4.5           | `anthropic:claude-sonnet-4-5` | `sonnet`                                 | —       |
-| Haiku 4.5            | `anthropic:claude-haiku-4-5`  | `haiku`                                  | —       |
-| GPT-5.1              | `openai:gpt-5.1`              | `gpt-5.1`                                | —       |
-| GPT-5 Pro            | `openai:gpt-5-pro`            | `gpt-5-pro`                              | —       |
-| GPT-5.1 Codex        | `openai:gpt-5.1-codex`        | `codex`                                  | —       |
-| GPT-5.1 Codex Mini   | `openai:gpt-5.1-codex-mini`   | `codex-mini`                             | —       |
-| GPT-5.1 Codex Max    | `openai:gpt-5.1-codex-max`    | `codex-max`                              | —       |
-| Gemini 3 Pro Preview | `google:gemini-3-pro-preview` | `gemini-3`, `gemini-3-pro`               | —       |
-| Grok 4 1 Fast        | `xai:grok-4-1-fast`           | `grok`, `grok-4`, `grok-4.1`, `grok-4-1` | —       |
-| Grok Code Fast 1     | `xai:grok-code-fast-1`        | `grok-code`                              | —       |
-
-{/* END KNOWN_MODELS_TABLE */}
-
 ### Supported Providers
 
 #### Anthropic (Cloud)

docs/runtime/local.md

@@ -13,15 +13,9 @@ Local runtime runs the agent directly in your project directory—the same direc
 
 ## Caveats
 
-<Warning>
-  **No isolation**: Multiple local workspaces for the same project see and modify the same files.
-  Running them simultaneously can cause conflicts. mux shows a warning when another local workspace
-  is actively streaming.
-</Warning>
-
-<Warning>
-  **Affects your working copy**: Agent changes happen in your actual project directory.
-</Warning>
+<Warning>**No isolation**: Multiple local workspaces for the same project see and modify the same files. Running them simultaneously can cause conflicts. mux shows a warning when another local workspace is actively streaming.</Warning>
+
+<Warning>**Affects your working copy**: Agent changes happen in your actual project directory.</Warning>
 
 ## Filesystem
 

docs/runtime/ssh.md

@@ -36,9 +36,7 @@ Host ovh-1
 
 ## Authentication
 
-<Info>
-  As we delegate to `ssh`, this is really an abbreviated reference of how `ssh` authenticates.
-</Info>
+<Info>As we delegate to `ssh`, this is really an abbreviated reference of how `ssh` authenticates.</Info>
 
 There are a few practical ways to set up authentication.
 

docs/system-prompt.mdx docs/system-prompt.mddocs/system-prompt.mdx renamed to docs/system-prompt.md

@@ -13,6 +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 */}
 
 ```typescript