diff --git a/docs/cli/generate.md b/docs/cli/generate.md
deleted file mode 100644
index 7025033..0000000
--- a/docs/cli/generate.md
+++ /dev/null
@@ -1,12 +0,0 @@
-# `usage generate`
-
-- **Usage**: `usage generate <SUBCOMMAND>`
-- **Aliases**: `g`
-- **Source code**: [`cli/src/cli/generate.rs`](https://github.com/jdx/usage/blob/main/cli/src/cli/generate.rs)
-
-## Subcommands
-
-- [`usage generate completion [FLAGS] <SHELL> <BIN>`](/generate/completion.md)
-- [`usage generate fig [FLAGS]`](/generate/fig.md)
-- [`usage generate json [-f --file <FILE>] [--spec <SPEC>]`](/generate/json.md)
-- [`usage generate markdown <FLAGS>`](/generate/markdown.md)
diff --git a/docs/cli/generate/completion.md b/docs/cli/generate/completion.md
deleted file mode 100644
index 7a33c1b..0000000
--- a/docs/cli/generate/completion.md
+++ /dev/null
@@ -1,33 +0,0 @@
-# `usage generate completion`
-
-- **Usage**: `usage generate completion [FLAGS] <SHELL> <BIN>`
-- **Aliases**: `c`
-- **Source code**: [`cli/src/cli/generate/completion.rs`](https://github.com/jdx/usage/blob/main/cli/src/cli/generate/completion.rs)
-
-## Arguments
-
-### `<SHELL>`
-
-**Choices:**
-
-- `bash`
-- `fish`
-- `zsh`
-
-### `<BIN>`
-
-The CLI which we're generates completions for
-
-## Flags
-
-### `--cache-key <CACHE_KEY>`
-
-A cache key to use for storing the results of calling the CLI with --usage-cmd
-
-### `-f --file <FILE>`
-
-A .usage.kdl spec file to use for generating completions
-
-### `--usage-cmd <USAGE_CMD>`
-
-A command which generates a usage spec e.g.: `mycli --usage` or `mycli completion usage` Defaults to "$bin --usage"
diff --git a/docs/cli/generate/fig.md b/docs/cli/generate/fig.md
deleted file mode 100644
index b2dbbb3..0000000
--- a/docs/cli/generate/fig.md
+++ /dev/null
@@ -1,18 +0,0 @@
-# `usage generate fig`
-
-- **Usage**: `usage generate fig [FLAGS]`
-- **Source code**: [`cli/src/cli/generate/fig.rs`](https://github.com/jdx/usage/blob/main/cli/src/cli/generate/fig.rs)
-
-## Flags
-
-### `-f --file <FILE>`
-
-A usage spec taken in as a file
-
-### `--spec <SPEC>`
-
-raw string spec input
-
-### `--out-file <OUT_FILE>`
-
-File on where to save the generated Fig spec
diff --git a/docs/cli/generate/json.md b/docs/cli/generate/json.md
deleted file mode 100644
index fa8bd19..0000000
--- a/docs/cli/generate/json.md
+++ /dev/null
@@ -1,16 +0,0 @@
-# `usage generate json`
-
-- **Usage**: `usage generate json [-f --file <FILE>] [--spec <SPEC>]`
-- **Source code**: [`cli/src/cli/generate/json.rs`](https://github.com/jdx/usage/blob/main/cli/src/cli/generate/json.rs)
-
-Outputs a usage spec in json format
-
-## Flags
-
-### `-f --file <FILE>`
-
-A usage spec taken in as a file
-
-### `--spec <SPEC>`
-
-raw string spec input
diff --git a/docs/cli/generate/markdown.md b/docs/cli/generate/markdown.md
deleted file mode 100644
index 364e8c3..0000000
--- a/docs/cli/generate/markdown.md
+++ /dev/null
@@ -1,29 +0,0 @@
-# `usage generate markdown`
-
-- **Usage**: `usage generate markdown <FLAGS>`
-- **Aliases**: `md`
-- **Source code**: [`cli/src/cli/generate/markdown.rs`](https://github.com/jdx/usage/blob/main/cli/src/cli/generate/markdown.rs)
-
-## Flags
-
-### `-f --file <FILE>`
-
-A usage spec taken in as a file
-
-### `-m --multi`
-
-Render each subcommand as a separate markdown file
-
-### `--url-prefix <URL_PREFIX>`
-
-Prefix to add to all URLs
-
-### `--html-encode`
-
-Escape HTML in markdown
-
-### `--out-dir <OUT_DIR>`
-
-Output markdown files to this directory
-
-### `--out-file <OUT_FILE>`
diff --git a/docs/cli/reference/commands.json b/docs/cli/reference/commands.json
index 5f686d4..0579ff6 100644
--- a/docs/cli/reference/commands.json
+++ b/docs/cli/reference/commands.json
@@ -6,7 +6,9 @@
     "usage": "[--usage-spec] [COMPLETIONS] <SUBCOMMAND>",
     "subcommands": {
       "bash": {
-        "full_cmd": ["bash"],
+        "full_cmd": [
+          "bash"
+        ],
         "usage": "bash [-h] [--help] <SCRIPT> [ARGS]...",
         "subcommands": {},
         "args": [
@@ -32,7 +34,9 @@
             "usage": "-h",
             "help": "show help",
             "help_first_line": "show help",
-            "short": ["h"],
+            "short": [
+              "h"
+            ],
             "long": [],
             "hide": false,
             "global": false
@@ -43,7 +47,9 @@
             "help": "show help",
             "help_first_line": "show help",
             "short": [],
-            "long": ["help"],
+            "long": [
+              "help"
+            ],
             "hide": false,
             "global": false
           }
@@ -58,7 +64,9 @@
         "examples": []
       },
       "complete-word": {
-        "full_cmd": ["complete-word"],
+        "full_cmd": [
+          "complete-word"
+        ],
         "usage": "complete-word [FLAGS] [WORDS]...",
         "subcommands": {},
         "args": [
@@ -77,7 +85,9 @@
             "name": "shell",
             "usage": "--shell <SHELL>",
             "short": [],
-            "long": ["shell"],
+            "long": [
+              "shell"
+            ],
             "hide": false,
             "global": false,
             "arg": {
@@ -86,7 +96,11 @@
               "required": true,
               "hide": false,
               "choices": {
-                "choices": ["bash", "fish", "zsh"]
+                "choices": [
+                  "bash",
+                  "fish",
+                  "zsh"
+                ]
               }
             }
           },
@@ -95,8 +109,12 @@
             "usage": "-f --file <FILE>",
             "help": "usage spec file or script with usage shebang",
             "help_first_line": "usage spec file or script with usage shebang",
-            "short": ["f"],
-            "long": ["file"],
+            "short": [
+              "f"
+            ],
+            "long": [
+              "file"
+            ],
             "hide": false,
             "global": false,
             "arg": {
@@ -111,8 +129,12 @@
             "usage": "-s --spec <SPEC>",
             "help": "raw string spec input",
             "help_first_line": "raw string spec input",
-            "short": ["s"],
-            "long": ["spec"],
+            "short": [
+              "s"
+            ],
+            "long": [
+              "spec"
+            ],
             "hide": false,
             "global": false,
             "arg": {
@@ -128,7 +150,9 @@
             "help": "current word index",
             "help_first_line": "current word index",
             "short": [],
-            "long": ["cword"],
+            "long": [
+              "cword"
+            ],
             "hide": false,
             "global": false,
             "arg": {
@@ -142,12 +166,16 @@
         "mounts": [],
         "hide": false,
         "name": "complete-word",
-        "aliases": ["cw"],
+        "aliases": [
+          "cw"
+        ],
         "hidden_aliases": [],
         "examples": []
       },
       "exec": {
-        "full_cmd": ["exec"],
+        "full_cmd": [
+          "exec"
+        ],
         "usage": "exec <ARGS>…",
         "subcommands": {},
         "args": [
@@ -181,16 +209,23 @@
         "mounts": [],
         "hide": true,
         "name": "exec",
-        "aliases": ["x"],
+        "aliases": [
+          "x"
+        ],
         "hidden_aliases": [],
         "examples": []
       },
       "generate": {
-        "full_cmd": ["generate"],
+        "full_cmd": [
+          "generate"
+        ],
         "usage": "generate <SUBCOMMAND>",
         "subcommands": {
           "completion": {
-            "full_cmd": ["generate", "completion"],
+            "full_cmd": [
+              "generate",
+              "completion"
+            ],
             "usage": "generate completion [FLAGS] <SHELL> <BIN>",
             "subcommands": {},
             "args": [
@@ -200,7 +235,11 @@
                 "required": true,
                 "hide": false,
                 "choices": {
-                  "choices": ["bash", "fish", "zsh"]
+                  "choices": [
+                    "bash",
+                    "fish",
+                    "zsh"
+                  ]
                 }
               },
               {
@@ -219,7 +258,9 @@
                 "help": "A cache key to use for storing the results of calling the CLI with --usage-cmd",
                 "help_first_line": "A cache key to use for storing the results of calling the CLI with --usage-cmd",
                 "short": [],
-                "long": ["cache-key"],
+                "long": [
+                  "cache-key"
+                ],
                 "hide": false,
                 "global": false,
                 "arg": {
@@ -234,8 +275,12 @@
                 "usage": "-f --file <FILE>",
                 "help": "A .usage.kdl spec file to use for generating completions",
                 "help_first_line": "A .usage.kdl spec file to use for generating completions",
-                "short": ["f"],
-                "long": ["file"],
+                "short": [
+                  "f"
+                ],
+                "long": [
+                  "file"
+                ],
                 "hide": false,
                 "global": false,
                 "arg": {
@@ -251,7 +296,9 @@
                 "help": "A command which generates a usage spec e.g.: `mycli --usage` or `mycli completion usage` Defaults to \"$bin --usage\"",
                 "help_first_line": "A command which generates a usage spec e.g.: `mycli --usage` or `mycli completion usage` Defaults to \"$bin --usage\"",
                 "short": [],
-                "long": ["usage-cmd"],
+                "long": [
+                  "usage-cmd"
+                ],
                 "hide": false,
                 "global": false,
                 "arg": {
@@ -265,12 +312,20 @@
             "mounts": [],
             "hide": false,
             "name": "completion",
-            "aliases": ["c"],
-            "hidden_aliases": ["complete", "completions"],
+            "aliases": [
+              "c"
+            ],
+            "hidden_aliases": [
+              "complete",
+              "completions"
+            ],
             "examples": []
           },
           "fig": {
-            "full_cmd": ["generate", "fig"],
+            "full_cmd": [
+              "generate",
+              "fig"
+            ],
             "usage": "generate fig [FLAGS]",
             "subcommands": {},
             "args": [],
@@ -280,8 +335,12 @@
                 "usage": "-f --file <FILE>",
                 "help": "A usage spec taken in as a file",
                 "help_first_line": "A usage spec taken in as a file",
-                "short": ["f"],
-                "long": ["file"],
+                "short": [
+                  "f"
+                ],
+                "long": [
+                  "file"
+                ],
                 "hide": false,
                 "global": false,
                 "arg": {
@@ -297,7 +356,9 @@
                 "help": "raw string spec input",
                 "help_first_line": "raw string spec input",
                 "short": [],
-                "long": ["spec"],
+                "long": [
+                  "spec"
+                ],
                 "hide": false,
                 "global": false,
                 "arg": {
@@ -313,7 +374,9 @@
                 "help": "File on where to save the generated Fig spec",
                 "help_first_line": "File on where to save the generated Fig spec",
                 "short": [],
-                "long": ["out-file"],
+                "long": [
+                  "out-file"
+                ],
                 "hide": false,
                 "global": false,
                 "arg": {
@@ -332,7 +395,10 @@
             "examples": []
           },
           "json": {
-            "full_cmd": ["generate", "json"],
+            "full_cmd": [
+              "generate",
+              "json"
+            ],
             "usage": "generate json [-f --file <FILE>] [--spec <SPEC>]",
             "subcommands": {},
             "args": [],
@@ -342,8 +408,12 @@
                 "usage": "-f --file <FILE>",
                 "help": "A usage spec taken in as a file",
                 "help_first_line": "A usage spec taken in as a file",
-                "short": ["f"],
-                "long": ["file"],
+                "short": [
+                  "f"
+                ],
+                "long": [
+                  "file"
+                ],
                 "hide": false,
                 "global": false,
                 "arg": {
@@ -359,7 +429,9 @@
                 "help": "raw string spec input",
                 "help_first_line": "raw string spec input",
                 "short": [],
-                "long": ["spec"],
+                "long": [
+                  "spec"
+                ],
                 "hide": false,
                 "global": false,
                 "arg": {
@@ -379,7 +451,10 @@
             "examples": []
           },
           "markdown": {
-            "full_cmd": ["generate", "markdown"],
+            "full_cmd": [
+              "generate",
+              "markdown"
+            ],
             "usage": "generate markdown <FLAGS>",
             "subcommands": {},
             "args": [],
@@ -389,8 +464,12 @@
                 "usage": "-f --file <FILE>",
                 "help": "A usage spec taken in as a file",
                 "help_first_line": "A usage spec taken in as a file",
-                "short": ["f"],
-                "long": ["file"],
+                "short": [
+                  "f"
+                ],
+                "long": [
+                  "file"
+                ],
                 "required": true,
                 "hide": false,
                 "global": false,
@@ -406,8 +485,12 @@
                 "usage": "-m --multi",
                 "help": "Render each subcommand as a separate markdown file",
                 "help_first_line": "Render each subcommand as a separate markdown file",
-                "short": ["m"],
-                "long": ["multi"],
+                "short": [
+                  "m"
+                ],
+                "long": [
+                  "multi"
+                ],
                 "hide": false,
                 "global": false
               },
@@ -417,7 +500,9 @@
                 "help": "Prefix to add to all URLs",
                 "help_first_line": "Prefix to add to all URLs",
                 "short": [],
-                "long": ["url-prefix"],
+                "long": [
+                  "url-prefix"
+                ],
                 "hide": false,
                 "global": false,
                 "arg": {
@@ -433,7 +518,9 @@
                 "help": "Escape HTML in markdown",
                 "help_first_line": "Escape HTML in markdown",
                 "short": [],
-                "long": ["html-encode"],
+                "long": [
+                  "html-encode"
+                ],
                 "hide": false,
                 "global": false
               },
@@ -443,7 +530,9 @@
                 "help": "Output markdown files to this directory",
                 "help_first_line": "Output markdown files to this directory",
                 "short": [],
-                "long": ["out-dir"],
+                "long": [
+                  "out-dir"
+                ],
                 "hide": false,
                 "global": false,
                 "arg": {
@@ -457,7 +546,9 @@
                 "name": "out-file",
                 "usage": "--out-file <OUT_FILE>",
                 "short": [],
-                "long": ["out-file"],
+                "long": [
+                  "out-file"
+                ],
                 "hide": false,
                 "global": false,
                 "arg": {
@@ -471,7 +562,9 @@
             "mounts": [],
             "hide": false,
             "name": "markdown",
-            "aliases": ["md"],
+            "aliases": [
+              "md"
+            ],
             "hidden_aliases": [],
             "examples": []
           }
@@ -482,7 +575,9 @@
         "hide": false,
         "subcommand_required": true,
         "name": "generate",
-        "aliases": ["g"],
+        "aliases": [
+          "g"
+        ],
         "hidden_aliases": [],
         "examples": []
       }
@@ -504,7 +599,9 @@
         "help": "Outputs a `usage.kdl` spec for this CLI itself",
         "help_first_line": "Outputs a `usage.kdl` spec for this CLI itself",
         "short": [],
-        "long": ["usage-spec"],
+        "long": [
+          "usage-spec"
+        ],
         "hide": false,
         "global": false
       }
diff --git a/docs/cli/reference/generate.md b/docs/cli/reference/generate.md
index 1f0f577..3a888b4 100644
--- a/docs/cli/reference/generate.md
+++ b/docs/cli/reference/generate.md
@@ -6,7 +6,7 @@
 
 ## Subcommands
 
-- [`usage generate completion [FLAGS] <SHELL> <BIN>`](/cli/reference//generate/completion.md)
-- [`usage generate fig [FLAGS]`](/cli/reference//generate/fig.md)
-- [`usage generate json [-f --file <FILE>] [--spec <SPEC>]`](/cli/reference//generate/json.md)
-- [`usage generate markdown <FLAGS>`](/cli/reference//generate/markdown.md)
+- [`usage generate completion [FLAGS] <SHELL> <BIN>`](cli/reference//generate/completion.md)
+- [`usage generate fig [FLAGS]`](cli/reference//generate/fig.md)
+- [`usage generate json [-f --file <FILE>] [--spec <SPEC>]`](cli/reference//generate/json.md)
+- [`usage generate markdown <FLAGS>`](cli/reference//generate/markdown.md)
diff --git a/docs/cli/reference/index.md b/docs/cli/reference/index.md
index cc396f5..3b8bfbb 100644
--- a/docs/cli/reference/index.md
+++ b/docs/cli/reference/index.md
@@ -20,10 +20,10 @@ Outputs a `usage.kdl` spec for this CLI itself
 
 ## Subcommands
 
-- [`usage bash [-h] [--help] <SCRIPT> [ARGS]...`](/cli/reference//bash.md)
-- [`usage complete-word [FLAGS] [WORDS]...`](/cli/reference//complete-word.md)
-- [`usage generate <SUBCOMMAND>`](/cli/reference//generate.md)
-- [`usage generate completion [FLAGS] <SHELL> <BIN>`](/cli/reference//generate/completion.md)
-- [`usage generate fig [FLAGS]`](/cli/reference//generate/fig.md)
-- [`usage generate json [-f --file <FILE>] [--spec <SPEC>]`](/cli/reference//generate/json.md)
-- [`usage generate markdown <FLAGS>`](/cli/reference//generate/markdown.md)
+- [`usage bash [-h] [--help] <SCRIPT> [ARGS]...`](cli/reference//bash.md)
+- [`usage complete-word [FLAGS] [WORDS]...`](cli/reference//complete-word.md)
+- [`usage generate <SUBCOMMAND>`](cli/reference//generate.md)
+- [`usage generate completion [FLAGS] <SHELL> <BIN>`](cli/reference//generate/completion.md)
+- [`usage generate fig [FLAGS]`](cli/reference//generate/fig.md)
+- [`usage generate json [-f --file <FILE>] [--spec <SPEC>]`](cli/reference//generate/json.md)
+- [`usage generate markdown <FLAGS>`](cli/reference//generate/markdown.md)
diff --git a/mise.toml b/mise.toml
index 5acfbc6..46c9894 100644
--- a/mise.toml
+++ b/mise.toml
@@ -87,7 +87,7 @@ run = [
     'usage --usage-spec > cli/usage.usage.kdl',
     'rm -rf docs/cli/reference && mkdir -p docs/cli/reference',
     'usage g json -f cli/usage.usage.kdl > docs/cli/reference/commands.json',
-    'usage g md -mf cli/usage.usage.kdl --out-dir docs/cli/reference --url-prefix /cli/reference/',
+    'usage g md -mf cli/usage.usage.kdl --out-dir docs/cli/reference --url-prefix cli/reference/',
     'usage g completion bash usage --usage-cmd "usage --usage-spec" > cli/assets/completions/usage.bash',
     'usage g completion fish usage --usage-cmd "usage --usage-spec" > cli/assets/completions/usage.fish',
     'usage g completion zsh  usage --usage-cmd "usage --usage-spec" > cli/assets/completions/_usage',