From 0f851bfb0a6429b9140fd85e25518afc7ca3df07 Mon Sep 17 00:00:00 2001
From: LGUG2Z <LGUG2Z@fastmail.com>
Date: Sat, 31 Oct 2026 15:38:24 -0700
Subject: [PATCH] docs(cli): regenerate the stale Windows command pages

docs/cli lagged behind the Windows komorebic: 35 pages had out-of-date
help text (possible values now listed with their descriptions, new doc
comments, the Scrolling commands without the komorebic.exe usage name) and
3 pages did not exist yet. They are regenerated from the current Windows
CLI definition (komorebic-core docgen-all example, platform windows,
COLUMNS=1000 so nothing is re-wrapped like the existing pages), and the
page conventions of each file are kept: header line only where the page had
one, komorebic.exe as the binary name, trailing newline. The other 149
pages are byte-identical to the fresh output. The KDE and macOS pages are
untouched (decision D20: Windows was the only stale set).

Docs only, no behaviour. Verified: regenerated twice, second compare shows no
diff; the real Windows binary was not run (the pages come from the shared
definition rendered on Linux, class text normalised to the Windows one).
---
 docs/cli/adjust-container-padding.md          |  6 ++-
 docs/cli/adjust-workspace-padding.md          |  6 ++-
 docs/cli/animation-duration.md                |  9 ++--
 docs/cli/animation-style.md                   | 44 ++++++++++++++++---
 docs/cli/animation.md                         |  9 ++--
 docs/cli/border-colour.md                     | 11 ++++-
 docs/cli/center-focus.md                      |  4 +-
 docs/cli/change-layout.md                     | 13 +++++-
 docs/cli/consume.md                           |  4 +-
 docs/cli/expand.md                            |  2 +-
 docs/cli/expel.md                             |  7 ++-
 docs/cli/flip-layout.md                       |  7 ++-
 docs/cli/identify-layered-application.md      |  8 +++-
 ...identify-object-name-change-application.md |  8 +++-
 docs/cli/identify-tray-application.md         |  8 +++-
 docs/cli/ignore-rule.md                       |  8 +++-
 docs/cli/initial-named-workspace-rule.md      |  8 +++-
 docs/cli/initial-workspace-rule.md            |  8 +++-
 docs/cli/layout-ratios.md                     | 16 +++++++
 docs/cli/manage-rule.md                       |  8 +++-
 docs/cli/monocle-focus-behaviour.md           | 18 ++++++++
 docs/cli/named-workspace-layout-rule.md       | 13 +++++-
 docs/cli/named-workspace-layout.md            | 13 +++++-
 docs/cli/named-workspace-rule.md              |  8 +++-
 docs/cli/pan.md                               |  2 +-
 docs/cli/remove-title-bar.md                  |  8 +++-
 docs/cli/resize-axis.md                       | 11 +++--
 docs/cli/resize-edge.md                       |  6 ++-
 docs/cli/scrolling-layout-full-width.md       |  7 ++-
 docs/cli/stackbar-mode.md                     |  9 ++--
 docs/cli/start.md                             |  2 +-
 docs/cli/toggle-column-stack.md               |  7 ++-
 docs/cli/toggle-monocle-focus-behaviour.md    | 10 +++++
 .../unmanaged-window-operation-behaviour.md   |  4 +-
 docs/cli/window-hiding-behaviour.md           |  4 +-
 docs/cli/workspace-layout-rule.md             | 13 +++++-
 docs/cli/workspace-layout.md                  | 13 +++++-
 docs/cli/workspace-rule.md                    |  8 +++-
 38 files changed, 270 insertions(+), 80 deletions(-)
 create mode 100644 docs/cli/layout-ratios.md
 create mode 100644 docs/cli/monocle-focus-behaviour.md
 create mode 100644 docs/cli/toggle-monocle-focus-behaviour.md

diff --git a/docs/cli/adjust-container-padding.md b/docs/cli/adjust-container-padding.md
index f8bd2796..058231cc 100644
--- a/docs/cli/adjust-container-padding.md
+++ b/docs/cli/adjust-container-padding.md
@@ -7,13 +7,15 @@ Usage: komorebic.exe adjust-container-padding <SIZING> <ADJUSTMENT>
 
 Arguments:
   <SIZING>
-          [possible values: increase, decrease]
+          Possible values:
+          - increase: Increase
+          - decrease: Decrease
 
   <ADJUSTMENT>
           Pixels to adjust by as an integer
 
 Options:
   -h, --help
-          Print help
+          Print help (see a summary with '-h')
 
 ```
diff --git a/docs/cli/adjust-workspace-padding.md b/docs/cli/adjust-workspace-padding.md
index 09fe58c4..ac1aada6 100644
--- a/docs/cli/adjust-workspace-padding.md
+++ b/docs/cli/adjust-workspace-padding.md
@@ -7,13 +7,15 @@ Usage: komorebic.exe adjust-workspace-padding <SIZING> <ADJUSTMENT>
 
 Arguments:
   <SIZING>
-          [possible values: increase, decrease]
+          Possible values:
+          - increase: Increase
+          - decrease: Decrease
 
   <ADJUSTMENT>
           Pixels to adjust by as an integer
 
 Options:
   -h, --help
-          Print help
+          Print help (see a summary with '-h')
 
 ```
diff --git a/docs/cli/animation-duration.md b/docs/cli/animation-duration.md
index e0ec8d34..891e4969 100644
--- a/docs/cli/animation-duration.md
+++ b/docs/cli/animation-duration.md
@@ -12,10 +12,13 @@ Arguments:
 Options:
   -a, --animation-type <ANIMATION_TYPE>
           Animation type to apply the duration to. If not specified, sets global duration
-          
-          [possible values: movement, transparency, workspace]
+
+          Possible values:
+          - movement
+          - transparency
+          - workspace:    A workspace sliding in and out of a monitor when it is switched to
 
   -h, --help
-          Print help
+          Print help (see a summary with '-h')
 
 ```
diff --git a/docs/cli/animation-style.md b/docs/cli/animation-style.md
index 11cc3eae..e2f59a12 100644
--- a/docs/cli/animation-style.md
+++ b/docs/cli/animation-style.md
@@ -8,17 +8,51 @@ Usage: komorebic.exe animation-style [OPTIONS]
 Options:
   -s, --style <STYLE>
           Desired ease function for animation
+
+          Possible values:
+          - linear:              Linear
+          - ease-in-sine:        Ease in sine
+          - ease-out-sine:       Ease out sine
+          - ease-in-out-sine:    Ease in out sine
+          - ease-in-quad:        Ease in quad
+          - ease-out-quad:       Ease out quad
+          - ease-in-out-quad:    Ease in out quad
+          - ease-in-cubic:       Ease in cubic
+          - ease-out-cubic:      Ease out cubic
+          - ease-in-out-cubic:   Ease in out cubic
+          - ease-in-quart:       Ease in quart
+          - ease-out-quart:      Ease out quart
+          - ease-in-out-quart:   Ease in out quart
+          - ease-in-quint:       Ease in quint
+          - ease-out-quint:      Ease out quint
+          - ease-in-out-quint:   Ease in out quint
+          - ease-in-expo:        Ease in expo
+          - ease-out-expo:       Ease out expo
+          - ease-in-out-expo:    Ease in out expo
+          - ease-in-circ:        Ease in circ
+          - ease-out-circ:       Ease out circ
+          - ease-in-out-circ:    Ease in out circ
+          - ease-in-back:        Ease in back
+          - ease-out-back:       Ease out back
+          - ease-in-out-back:    Ease in out back
+          - ease-in-elastic:     Ease in elastic
+          - ease-out-elastic:    Ease out elastic
+          - ease-in-out-elastic: Ease in out elastic
+          - ease-in-bounce:      Ease in bounce
+          - ease-out-bounce:     Ease out bounce
+          - ease-in-out-bounce:  Ease in out bounce
           
           [default: linear]
-          [possible values: linear, ease-in-sine, ease-out-sine, ease-in-out-sine, ease-in-quad, ease-out-quad, ease-in-out-quad, ease-in-cubic, ease-in-out-cubic, ease-in-quart, ease-out-quart, ease-in-out-quart, ease-in-quint, ease-out-quint, ease-in-out-quint, ease-in-expo,
-          ease-out-expo, ease-in-out-expo, ease-in-circ, ease-out-circ, ease-in-out-circ, ease-in-back, ease-out-back, ease-in-out-back, ease-in-elastic, ease-out-elastic, ease-in-out-elastic, ease-in-bounce, ease-out-bounce, ease-in-out-bounce]
 
   -a, --animation-type <ANIMATION_TYPE>
           Animation type to apply the style to. If not specified, sets global style
-          
-          [possible values: movement, transparency, workspace]
+
+          Possible values:
+          - movement
+          - transparency
+          - workspace:    A workspace sliding in and out of a monitor when it is switched to
 
   -h, --help
-          Print help
+          Print help (see a summary with '-h')
 
 ```
diff --git a/docs/cli/animation.md b/docs/cli/animation.md
index 530bcaa8..ab38fe76 100644
--- a/docs/cli/animation.md
+++ b/docs/cli/animation.md
@@ -12,10 +12,13 @@ Arguments:
 Options:
   -a, --animation-type <ANIMATION_TYPE>
           Animation type to apply the state to. If not specified, sets global state
-          
-          [possible values: movement, transparency, workspace]
+
+          Possible values:
+          - movement
+          - transparency
+          - workspace:    A workspace sliding in and out of a monitor when it is switched to
 
   -h, --help
-          Print help
+          Print help (see a summary with '-h')
 
 ```
diff --git a/docs/cli/border-colour.md b/docs/cli/border-colour.md
index 55b84d34..84c70bff 100644
--- a/docs/cli/border-colour.md
+++ b/docs/cli/border-colour.md
@@ -17,10 +17,17 @@ Arguments:
 
 Options:
   -w, --window-kind <WINDOW_KIND>
+          Possible values:
+          - single:           Single window
+          - stack:            Stack container
+          - monocle:          Monocle container
+          - unfocused:        Unfocused window
+          - unfocused-locked: Unfocused locked container
+          - floating:         Floating window
+          
           [default: single]
-          [possible values: single, stack, monocle, unfocused, unfocused-locked, floating]
 
   -h, --help
-          Print help
+          Print help (see a summary with '-h')
 
 ```
diff --git a/docs/cli/center-focus.md b/docs/cli/center-focus.md
index 8d321dc9..0f2dfab7 100644
--- a/docs/cli/center-focus.md
+++ b/docs/cli/center-focus.md
@@ -1,10 +1,10 @@
 ```
 Scroll the Scrolling layout so that the focused column is in the middle of the screen, once
 
-Usage: center-focus
+Usage: komorebic.exe center-focus
 
 Options:
   -h, --help
           Print help
 
-```
\ No newline at end of file
+```
diff --git a/docs/cli/change-layout.md b/docs/cli/change-layout.md
index 873214b7..bed3196d 100644
--- a/docs/cli/change-layout.md
+++ b/docs/cli/change-layout.md
@@ -7,10 +7,19 @@ Usage: komorebic.exe change-layout <DEFAULT_LAYOUT>
 
 Arguments:
   <DEFAULT_LAYOUT>
-          [possible values: bsp, columns, rows, vertical-stack, horizontal-stack, ultrawide-vertical-stack, grid, right-main-vertical-stack, scrolling]
+          Possible values:
+          - bsp:                       BSP Layout
+          - columns:                   Columns Layout
+          - rows:                      Rows Layout
+          - vertical-stack:            Vertical Stack Layout
+          - horizontal-stack:          Horizontal Stack Layout
+          - ultrawide-vertical-stack:  Ultrawide Vertical Stack Layout
+          - grid:                      Grid Layout
+          - right-main-vertical-stack: Right Main Vertical Stack Layout
+          - scrolling:                 Scrolling Layout
 
 Options:
   -h, --help
-          Print help
+          Print help (see a summary with '-h')
 
 ```
diff --git a/docs/cli/consume.md b/docs/cli/consume.md
index 10397301..d66145a0 100644
--- a/docs/cli/consume.md
+++ b/docs/cli/consume.md
@@ -1,7 +1,7 @@
 ```
 Take the neighbouring window on one side into the focused column of the Scrolling layout
 
-Usage: consume <OPERATION_DIRECTION>
+Usage: komorebic.exe consume <OPERATION_DIRECTION>
 
 Arguments:
   <OPERATION_DIRECTION>
@@ -11,4 +11,4 @@ Options:
   -h, --help
           Print help
 
-```
\ No newline at end of file
+```
diff --git a/docs/cli/expand.md b/docs/cli/expand.md
index 6ad3eab3..6acaec9c 100644
--- a/docs/cli/expand.md
+++ b/docs/cli/expand.md
@@ -1,7 +1,7 @@
 ```
 Make the focused column of the Scrolling layout fill the room that the columns in view leave on the screen, which does nothing in any other layout
 
-Usage: expand
+Usage: komorebic.exe expand
 
 Options:
   -h, --help
diff --git a/docs/cli/expel.md b/docs/cli/expel.md
index 35c8c142..39b3bf4b 100644
--- a/docs/cli/expel.md
+++ b/docs/cli/expel.md
@@ -1,11 +1,10 @@
 ```
-Take the focused window out of its column in the Scrolling layout and put it in a column of its own
-on the right
+Take the focused window out of its column in the Scrolling layout and put it in a column of its own on the right
 
-Usage: expel
+Usage: komorebic.exe expel
 
 Options:
   -h, --help
           Print help
 
-```
\ No newline at end of file
+```
diff --git a/docs/cli/flip-layout.md b/docs/cli/flip-layout.md
index 18e1c265..83e9ada8 100644
--- a/docs/cli/flip-layout.md
+++ b/docs/cli/flip-layout.md
@@ -7,10 +7,13 @@ Usage: komorebic.exe flip-layout <AXIS>
 
 Arguments:
   <AXIS>
-          [possible values: horizontal, vertical, horizontal-and-vertical]
+          Possible values:
+          - horizontal:              Horizontal axis
+          - vertical:                Vertical axis
+          - horizontal-and-vertical: Both horizontal and vertical axes
 
 Options:
   -h, --help
-          Print help
+          Print help (see a summary with '-h')
 
 ```
diff --git a/docs/cli/identify-layered-application.md b/docs/cli/identify-layered-application.md
index 0aff6c60..0f88f2bf 100644
--- a/docs/cli/identify-layered-application.md
+++ b/docs/cli/identify-layered-application.md
@@ -7,13 +7,17 @@ Usage: komorebic.exe identify-layered-application <IDENTIFIER> <ID>
 
 Arguments:
   <IDENTIFIER>
-          [possible values: exe, class, title, path]
+          Possible values:
+          - exe:   Executable name
+          - class: Class
+          - title: Window title
+          - path:  Executable path
 
   <ID>
           Identifier as a string
 
 Options:
   -h, --help
-          Print help
+          Print help (see a summary with '-h')
 
 ```
diff --git a/docs/cli/identify-object-name-change-application.md b/docs/cli/identify-object-name-change-application.md
index 9be3c6cb..c97061bd 100644
--- a/docs/cli/identify-object-name-change-application.md
+++ b/docs/cli/identify-object-name-change-application.md
@@ -7,13 +7,17 @@ Usage: komorebic.exe identify-object-name-change-application <IDENTIFIER> <ID>
 
 Arguments:
   <IDENTIFIER>
-          [possible values: exe, class, title, path]
+          Possible values:
+          - exe:   Executable name
+          - class: Class
+          - title: Window title
+          - path:  Executable path
 
   <ID>
           Identifier as a string
 
 Options:
   -h, --help
-          Print help
+          Print help (see a summary with '-h')
 
 ```
diff --git a/docs/cli/identify-tray-application.md b/docs/cli/identify-tray-application.md
index 2ce0ab17..8892ce86 100644
--- a/docs/cli/identify-tray-application.md
+++ b/docs/cli/identify-tray-application.md
@@ -7,13 +7,17 @@ Usage: komorebic.exe identify-tray-application <IDENTIFIER> <ID>
 
 Arguments:
   <IDENTIFIER>
-          [possible values: exe, class, title, path]
+          Possible values:
+          - exe:   Executable name
+          - class: Class
+          - title: Window title
+          - path:  Executable path
 
   <ID>
           Identifier as a string
 
 Options:
   -h, --help
-          Print help
+          Print help (see a summary with '-h')
 
 ```
diff --git a/docs/cli/ignore-rule.md b/docs/cli/ignore-rule.md
index 34693f28..48120ba9 100644
--- a/docs/cli/ignore-rule.md
+++ b/docs/cli/ignore-rule.md
@@ -7,13 +7,17 @@ Usage: komorebic.exe ignore-rule <IDENTIFIER> <ID>
 
 Arguments:
   <IDENTIFIER>
-          [possible values: exe, class, title, path]
+          Possible values:
+          - exe:   Executable name
+          - class: Class
+          - title: Window title
+          - path:  Executable path
 
   <ID>
           Identifier as a string
 
 Options:
   -h, --help
-          Print help
+          Print help (see a summary with '-h')
 
 ```
diff --git a/docs/cli/initial-named-workspace-rule.md b/docs/cli/initial-named-workspace-rule.md
index 3a3418e3..01b8ee05 100644
--- a/docs/cli/initial-named-workspace-rule.md
+++ b/docs/cli/initial-named-workspace-rule.md
@@ -7,7 +7,11 @@ Usage: komorebic.exe initial-named-workspace-rule <IDENTIFIER> <ID> <WORKSPACE>
 
 Arguments:
   <IDENTIFIER>
-          [possible values: exe, class, title, path]
+          Possible values:
+          - exe:   Executable name
+          - class: Class
+          - title: Window title
+          - path:  Executable path
 
   <ID>
           Identifier as a string
@@ -17,6 +21,6 @@ Arguments:
 
 Options:
   -h, --help
-          Print help
+          Print help (see a summary with '-h')
 
 ```
diff --git a/docs/cli/initial-workspace-rule.md b/docs/cli/initial-workspace-rule.md
index f32b1387..57067407 100644
--- a/docs/cli/initial-workspace-rule.md
+++ b/docs/cli/initial-workspace-rule.md
@@ -7,7 +7,11 @@ Usage: komorebic.exe initial-workspace-rule <IDENTIFIER> <ID> <MONITOR> <WORKSPA
 
 Arguments:
   <IDENTIFIER>
-          [possible values: exe, class, title, path]
+          Possible values:
+          - exe:   Executable name
+          - class: Class
+          - title: Window title
+          - path:  Executable path
 
   <ID>
           Identifier as a string
@@ -20,6 +24,6 @@ Arguments:
 
 Options:
   -h, --help
-          Print help
+          Print help (see a summary with '-h')
 
 ```
diff --git a/docs/cli/layout-ratios.md b/docs/cli/layout-ratios.md
new file mode 100644
index 00000000..92d42da2
--- /dev/null
+++ b/docs/cli/layout-ratios.md
@@ -0,0 +1,16 @@
+```
+Set the layout column and row ratios for the focused workspace
+
+Usage: komorebic.exe layout-ratios [OPTIONS]
+
+Options:
+  -c, --columns <COLUMNS>...
+          Column width ratios (space-separated values between 0.1 and 0.9)
+
+  -r, --rows <ROWS>...
+          Row height ratios (space-separated values between 0.1 and 0.9)
+
+  -h, --help
+          Print help
+
+```
diff --git a/docs/cli/manage-rule.md b/docs/cli/manage-rule.md
index 84b08135..d7dac7c7 100644
--- a/docs/cli/manage-rule.md
+++ b/docs/cli/manage-rule.md
@@ -7,13 +7,17 @@ Usage: komorebic.exe manage-rule <IDENTIFIER> <ID>
 
 Arguments:
   <IDENTIFIER>
-          [possible values: exe, class, title, path]
+          Possible values:
+          - exe:   Executable name
+          - class: Class
+          - title: Window title
+          - path:  Executable path
 
   <ID>
           Identifier as a string
 
 Options:
   -h, --help
-          Print help
+          Print help (see a summary with '-h')
 
 ```
diff --git a/docs/cli/monocle-focus-behaviour.md b/docs/cli/monocle-focus-behaviour.md
new file mode 100644
index 00000000..95587fe3
--- /dev/null
+++ b/docs/cli/monocle-focus-behaviour.md
@@ -0,0 +1,18 @@
+```
+Set the behaviour when focusing in a direction while a monocle container is active
+
+Usage: komorebic.exe monocle-focus-behaviour <BEHAVIOUR>
+
+Arguments:
+  <BEHAVIOUR>
+          Desired monocle focus behaviour
+
+          Possible values:
+          - cycle: Cycle the monocle container to the next/previous container in the workspace
+          - no-op: Do nothing, allowing focus to fall through to cross-monitor logic
+
+Options:
+  -h, --help
+          Print help (see a summary with '-h')
+
+```
diff --git a/docs/cli/named-workspace-layout-rule.md b/docs/cli/named-workspace-layout-rule.md
index a61d77fd..e7599f4a 100644
--- a/docs/cli/named-workspace-layout-rule.md
+++ b/docs/cli/named-workspace-layout-rule.md
@@ -13,10 +13,19 @@ Arguments:
           The number of window containers on-screen required to trigger this layout rule
 
   <LAYOUT>
-          [possible values: bsp, columns, rows, vertical-stack, horizontal-stack, ultrawide-vertical-stack, grid, right-main-vertical-stack, scrolling]
+          Possible values:
+          - bsp:                       BSP Layout
+          - columns:                   Columns Layout
+          - rows:                      Rows Layout
+          - vertical-stack:            Vertical Stack Layout
+          - horizontal-stack:          Horizontal Stack Layout
+          - ultrawide-vertical-stack:  Ultrawide Vertical Stack Layout
+          - grid:                      Grid Layout
+          - right-main-vertical-stack: Right Main Vertical Stack Layout
+          - scrolling:                 Scrolling Layout
 
 Options:
   -h, --help
-          Print help
+          Print help (see a summary with '-h')
 
 ```
diff --git a/docs/cli/named-workspace-layout.md b/docs/cli/named-workspace-layout.md
index 4277fb67..aaa65a8c 100644
--- a/docs/cli/named-workspace-layout.md
+++ b/docs/cli/named-workspace-layout.md
@@ -10,10 +10,19 @@ Arguments:
           Target workspace name
 
   <VALUE>
-          [possible values: bsp, columns, rows, vertical-stack, horizontal-stack, ultrawide-vertical-stack, grid, right-main-vertical-stack, scrolling]
+          Possible values:
+          - bsp:                       BSP Layout
+          - columns:                   Columns Layout
+          - rows:                      Rows Layout
+          - vertical-stack:            Vertical Stack Layout
+          - horizontal-stack:          Horizontal Stack Layout
+          - ultrawide-vertical-stack:  Ultrawide Vertical Stack Layout
+          - grid:                      Grid Layout
+          - right-main-vertical-stack: Right Main Vertical Stack Layout
+          - scrolling:                 Scrolling Layout
 
 Options:
   -h, --help
-          Print help
+          Print help (see a summary with '-h')
 
 ```
diff --git a/docs/cli/named-workspace-rule.md b/docs/cli/named-workspace-rule.md
index e84ad6cf..8f94fe9f 100644
--- a/docs/cli/named-workspace-rule.md
+++ b/docs/cli/named-workspace-rule.md
@@ -7,7 +7,11 @@ Usage: komorebic.exe named-workspace-rule <IDENTIFIER> <ID> <WORKSPACE>
 
 Arguments:
   <IDENTIFIER>
-          [possible values: exe, class, title, path]
+          Possible values:
+          - exe:   Executable name
+          - class: Class
+          - title: Window title
+          - path:  Executable path
 
   <ID>
           Identifier as a string
@@ -17,6 +21,6 @@ Arguments:
 
 Options:
   -h, --help
-          Print help
+          Print help (see a summary with '-h')
 
 ```
diff --git a/docs/cli/pan.md b/docs/cli/pan.md
index 912077d6..4da0a016 100644
--- a/docs/cli/pan.md
+++ b/docs/cli/pan.md
@@ -1,7 +1,7 @@
 ```
 Move the view of the Scrolling layout a column to the left or the right, or with the fingers on a touchpad, which does nothing in any other layout
 
-Usage: pan [OPTIONS] [DIRECTION]
+Usage: komorebic.exe pan [OPTIONS] [DIRECTION]
 
 Arguments:
   [DIRECTION]
diff --git a/docs/cli/remove-title-bar.md b/docs/cli/remove-title-bar.md
index 08d19cd5..d0d4e780 100644
--- a/docs/cli/remove-title-bar.md
+++ b/docs/cli/remove-title-bar.md
@@ -7,13 +7,17 @@ Usage: komorebic.exe remove-title-bar <IDENTIFIER> <ID>
 
 Arguments:
   <IDENTIFIER>
-          [possible values: exe, class, title, path]
+          Possible values:
+          - exe:   Executable name
+          - class: Class
+          - title: Window title
+          - path:  Executable path
 
   <ID>
           Identifier as a string
 
 Options:
   -h, --help
-          Print help
+          Print help (see a summary with '-h')
 
 ```
diff --git a/docs/cli/resize-axis.md b/docs/cli/resize-axis.md
index 8d8a39a9..7ed29b1b 100644
--- a/docs/cli/resize-axis.md
+++ b/docs/cli/resize-axis.md
@@ -7,13 +7,18 @@ Usage: komorebic.exe resize-axis <AXIS> <SIZING>
 
 Arguments:
   <AXIS>
-          [possible values: horizontal, vertical, horizontal-and-vertical]
+          Possible values:
+          - horizontal:              Horizontal axis
+          - vertical:                Vertical axis
+          - horizontal-and-vertical: Both horizontal and vertical axes
 
   <SIZING>
-          [possible values: increase, decrease]
+          Possible values:
+          - increase: Increase
+          - decrease: Decrease
 
 Options:
   -h, --help
-          Print help
+          Print help (see a summary with '-h')
 
 ```
diff --git a/docs/cli/resize-edge.md b/docs/cli/resize-edge.md
index c2de22f9..ecf60a71 100644
--- a/docs/cli/resize-edge.md
+++ b/docs/cli/resize-edge.md
@@ -10,10 +10,12 @@ Arguments:
           [possible values: left, right, up, down]
 
   <SIZING>
-          [possible values: increase, decrease]
+          Possible values:
+          - increase: Increase
+          - decrease: Decrease
 
 Options:
   -h, --help
-          Print help
+          Print help (see a summary with '-h')
 
 ```
diff --git a/docs/cli/scrolling-layout-full-width.md b/docs/cli/scrolling-layout-full-width.md
index 8b244afe..7f726020 100644
--- a/docs/cli/scrolling-layout-full-width.md
+++ b/docs/cli/scrolling-layout-full-width.md
@@ -1,11 +1,10 @@
 ```
-Make the focused column of the Scrolling layout as wide as the screen, or put it back to the width
-that it had
+Make the focused column of the Scrolling layout as wide as the screen, or put it back to the width that it had
 
-Usage: scrolling-layout-full-width
+Usage: komorebic.exe scrolling-layout-full-width
 
 Options:
   -h, --help
           Print help
 
-```
\ No newline at end of file
+```
diff --git a/docs/cli/stackbar-mode.md b/docs/cli/stackbar-mode.md
index cb880179..c5ae6403 100644
--- a/docs/cli/stackbar-mode.md
+++ b/docs/cli/stackbar-mode.md
@@ -8,11 +8,14 @@ Usage: komorebic.exe stackbar-mode <MODE>
 Arguments:
   <MODE>
           Desired stackbar mode
-          
-          [possible values: always, never, on-stack]
+
+          Possible values:
+          - always:   Always show
+          - never:    Never show
+          - on-stack: Show on stack
 
 Options:
   -h, --help
-          Print help
+          Print help (see a summary with '-h')
 
 ```
diff --git a/docs/cli/start.md b/docs/cli/start.md
index 6cfd7cf1..136744b5 100644
--- a/docs/cli/start.md
+++ b/docs/cli/start.md
@@ -10,7 +10,7 @@ Options:
           Path to a static configuration JSON file
 
   -a, --await-configuration
-          Wait for 'komorebic complete-configuration' to be sent before processing events
+          Wait for `komorebic complete-configuration` to be sent before processing events
 
   -t, --tcp-port <TCP_PORT>
           Start a TCP server on the given port to allow the direct sending of SocketMessages
diff --git a/docs/cli/toggle-column-stack.md b/docs/cli/toggle-column-stack.md
index 3792569c..f3e46b57 100644
--- a/docs/cli/toggle-column-stack.md
+++ b/docs/cli/toggle-column-stack.md
@@ -1,11 +1,10 @@
 ```
-Stack the windows of the focused column of the Scrolling layout, or spread the focused stack out
-into a column with a window in each slot
+Stack the windows of the focused column of the Scrolling layout, or spread the focused stack out into a column with a window in each slot
 
-Usage: toggle-column-stack
+Usage: komorebic.exe toggle-column-stack
 
 Options:
   -h, --help
           Print help
 
-```
\ No newline at end of file
+```
diff --git a/docs/cli/toggle-monocle-focus-behaviour.md b/docs/cli/toggle-monocle-focus-behaviour.md
new file mode 100644
index 00000000..7051f12c
--- /dev/null
+++ b/docs/cli/toggle-monocle-focus-behaviour.md
@@ -0,0 +1,10 @@
+```
+Toggle the behaviour when focusing in a direction while a monocle container is active
+
+Usage: komorebic.exe toggle-monocle-focus-behaviour
+
+Options:
+  -h, --help
+          Print help
+
+```
diff --git a/docs/cli/unmanaged-window-operation-behaviour.md b/docs/cli/unmanaged-window-operation-behaviour.md
index c665ae88..5f420117 100644
--- a/docs/cli/unmanaged-window-operation-behaviour.md
+++ b/docs/cli/unmanaged-window-operation-behaviour.md
@@ -8,8 +8,8 @@ Usage: komorebic.exe unmanaged-window-operation-behaviour <OPERATION_BEHAVIOUR>
 Arguments:
   <OPERATION_BEHAVIOUR>
           Possible values:
-          - op:    Process komorebic commands on temporarily unmanaged/floated windows
-          - no-op: Ignore komorebic commands on temporarily unmanaged/floated windows
+          - op:    Process commands on temporarily unmanaged/floated windows
+          - no-op: Ignore commands on temporarily unmanaged/floated windows
 
 Options:
   -h, --help
diff --git a/docs/cli/window-hiding-behaviour.md b/docs/cli/window-hiding-behaviour.md
index 0aeea569..5c0f40b2 100644
--- a/docs/cli/window-hiding-behaviour.md
+++ b/docs/cli/window-hiding-behaviour.md
@@ -8,8 +8,8 @@ Usage: komorebic.exe window-hiding-behaviour <HIDING_BEHAVIOUR>
 Arguments:
   <HIDING_BEHAVIOUR>
           Possible values:
-          - hide:     END OF LIFE FEATURE: Use the SW_HIDE flag to hide windows when switching workspaces (has issues with Electron apps)
-          - minimize: Use the SW_MINIMIZE flag to hide windows when switching workspaces (has issues with frequent workspace switching)
+          - hide:     END OF LIFE FEATURE: Use the `SW_HIDE` flag to hide windows when switching workspaces (has issues with Electron apps)
+          - minimize: Use the `SW_MINIMIZE` flag to hide windows when switching workspaces (has issues with frequent workspace switching)
           - cloak:    Use the undocumented SetCloak Win32 function to hide windows when switching workspaces
 
 Options:
diff --git a/docs/cli/workspace-layout-rule.md b/docs/cli/workspace-layout-rule.md
index 849d8b33..ce48fffc 100644
--- a/docs/cli/workspace-layout-rule.md
+++ b/docs/cli/workspace-layout-rule.md
@@ -16,10 +16,19 @@ Arguments:
           The number of window containers on-screen required to trigger this layout rule
 
   <LAYOUT>
-          [possible values: bsp, columns, rows, vertical-stack, horizontal-stack, ultrawide-vertical-stack, grid, right-main-vertical-stack, scrolling]
+          Possible values:
+          - bsp:                       BSP Layout
+          - columns:                   Columns Layout
+          - rows:                      Rows Layout
+          - vertical-stack:            Vertical Stack Layout
+          - horizontal-stack:          Horizontal Stack Layout
+          - ultrawide-vertical-stack:  Ultrawide Vertical Stack Layout
+          - grid:                      Grid Layout
+          - right-main-vertical-stack: Right Main Vertical Stack Layout
+          - scrolling:                 Scrolling Layout
 
 Options:
   -h, --help
-          Print help
+          Print help (see a summary with '-h')
 
 ```
diff --git a/docs/cli/workspace-layout.md b/docs/cli/workspace-layout.md
index 7f6cac7f..8daeda07 100644
--- a/docs/cli/workspace-layout.md
+++ b/docs/cli/workspace-layout.md
@@ -13,10 +13,19 @@ Arguments:
           Workspace index on the specified monitor (zero-indexed)
 
   <VALUE>
-          [possible values: bsp, columns, rows, vertical-stack, horizontal-stack, ultrawide-vertical-stack, grid, right-main-vertical-stack, scrolling]
+          Possible values:
+          - bsp:                       BSP Layout
+          - columns:                   Columns Layout
+          - rows:                      Rows Layout
+          - vertical-stack:            Vertical Stack Layout
+          - horizontal-stack:          Horizontal Stack Layout
+          - ultrawide-vertical-stack:  Ultrawide Vertical Stack Layout
+          - grid:                      Grid Layout
+          - right-main-vertical-stack: Right Main Vertical Stack Layout
+          - scrolling:                 Scrolling Layout
 
 Options:
   -h, --help
-          Print help
+          Print help (see a summary with '-h')
 
 ```
diff --git a/docs/cli/workspace-rule.md b/docs/cli/workspace-rule.md
index db1a9841..f1a925bf 100644
--- a/docs/cli/workspace-rule.md
+++ b/docs/cli/workspace-rule.md
@@ -7,7 +7,11 @@ Usage: komorebic.exe workspace-rule <IDENTIFIER> <ID> <MONITOR> <WORKSPACE>
 
 Arguments:
   <IDENTIFIER>
-          [possible values: exe, class, title, path]
+          Possible values:
+          - exe:   Executable name
+          - class: Class
+          - title: Window title
+          - path:  Executable path
 
   <ID>
           Identifier as a string
@@ -20,6 +24,6 @@ Arguments:
 
 Options:
   -h, --help
-          Print help
+          Print help (see a summary with '-h')
 
 ```