docs(cli): Restructure command pages to match vcspull pattern

Add intro paragraphs, wrap argparse directives in `## Command` sections,
and rename generic `## Usage` to descriptive section names for consistent
documentation structure across projects.

Author: tony

docs/cli/convert.md

@@ -2,6 +2,10 @@
 
 # tmuxp convert
 
+Convert workspace configuration files between YAML and JSON formats.
+
+## Command
+
 ```{eval-rst}
 .. argparse::
     :module: tmuxp.cli
@@ -10,7 +14,7 @@
     :path: convert
 ```
 
-## Usage
+## Basic usage
 
 ````{tab} YAML -> JSON
 

docs/cli/debug-info.md

@@ -4,6 +4,10 @@
 
 # tmuxp debug-info
 
+Collect and display system information useful for debugging tmuxp issues and submitting bug reports.
+
+## Command
+
 ```{eval-rst}
 .. argparse::
     :module: tmuxp.cli
@@ -12,7 +16,7 @@
     :path: debug-info
 ```
 
-## Usage
+## Example output
 
 ```console
 

docs/cli/edit.md

@@ -4,6 +4,10 @@
 
 # tmuxp edit
 
+Open a workspace configuration file in your default editor for quick modifications.
+
+## Command
+
 ```{eval-rst}
 .. argparse::
     :module: tmuxp.cli

docs/cli/freeze.md

@@ -4,6 +4,10 @@
 
 # tmuxp freeze
 
+Export a running tmux session to a workspace configuration file. This allows you to save the current state of your tmux session for later restoration.
+
+## Command
+
 ```{eval-rst}
 .. argparse::
     :module: tmuxp.cli
@@ -12,23 +16,27 @@
     :path: freeze
 ```
 
-## Usage
+## Basic usage
 
-Freeze sessions
+Freeze the current session:
 
 ```console
 $ tmuxp freeze
 ```
 
+Freeze a specific session by name:
+
 ```console
 $ tmuxp freeze [session_name]
 ```
 
+Overwrite an existing workspace file:
+
 ```console
 $ tmuxp freeze --force [session_name]
 ```
 
-You can save the state of your tmux session by freezing it.
+## Output format
 
 Tmuxp will offer to save your session state to `.json` or `.yaml`.
 

docs/cli/import.md

@@ -2,10 +2,16 @@
 
 # tmuxp import
 
+Import and convert workspace configurations from other tmux session managers like teamocil and tmuxinator.
+
 (import-teamocil)=
 
 ## From teamocil
 
+Import teamocil configuration files and convert them to tmuxp format.
+
+### Command
+
 ```{eval-rst}
 .. argparse::
     :module: tmuxp.cli
@@ -14,6 +20,8 @@
     :path: import teamocil
 ```
 
+### Basic usage
+
 ````{tab} YAML
 
 ```console
@@ -34,6 +42,10 @@ $ tmuxp import teamocil /path/to/file.json
 
 ## From tmuxinator
 
+Import tmuxinator configuration files and convert them to tmuxp format.
+
+### Command
+
 ```{eval-rst}
 .. argparse::
     :module: tmuxp.cli
@@ -42,6 +54,8 @@ $ tmuxp import teamocil /path/to/file.json
     :path: import tmuxinator
 ```
 
+### Basic usage
+
 ````{tab} YAML
 
 ```console

docs/cli/index.md

@@ -42,7 +42,11 @@ completion
 
 (tmuxp-main)=
 
-## Command: `tmuxp`
+## Main command
+
+The `tmuxp` command is the entry point for all tmuxp operations. Use subcommands to load sessions, manage configurations, and interact with tmux.
+
+### Command
 
 ```{eval-rst}
 .. argparse::

docs/cli/load.md

@@ -6,6 +6,10 @@
 
 # tmuxp load
 
+Load tmux sessions from workspace configuration files. This is the primary command for starting sessions from YAML or JSON configurations.
+
+## Command
+
 ```{eval-rst}
 .. argparse::
     :module: tmuxp.cli
@@ -14,7 +18,7 @@
     :path: load
 ```
 
-## Usage
+## Basic usage
 
 You can load your tmuxp file and attach the tmux session via a few
 shorthands:

docs/cli/ls.md

@@ -4,6 +4,10 @@
 
 # tmuxp ls
 
+List available workspace configurations from your local project and global tmuxp directories.
+
+## Command
+
 ```{eval-rst}
 .. argparse::
     :module: tmuxp.cli

docs/cli/search.md

@@ -4,6 +4,10 @@
 
 # tmuxp search
 
+Search for workspace configurations by name or content across your tmuxp directories.
+
+## Command
+
 ```{eval-rst}
 .. argparse::
     :module: tmuxp.cli

docs/cli/shell.md

@@ -4,6 +4,10 @@
 
 # tmuxp shell
 
+Launch an interactive Python shell with [libtmux] objects pre-loaded. Similar to Django's shell command, this provides quick access to your tmux server, sessions, windows, and panes for scripting and debugging.
+
+## Command
+
 ```{eval-rst}
 .. argparse::
     :module: tmuxp.cli
@@ -22,7 +26,7 @@ $ tmuxp shell -c 'python code'
 :width: 100%
 ```
 
-## Guide
+## Interactive usage
 
 Launch into a Python console with [libtmux] objects. Compare to django's shell.
 
@@ -50,6 +54,8 @@ Window(@3 1:your_window, Session($1 your_project))
 Pane(%6 Window(@3 1:your_window, Session($1 your_project)))
 ```
 
+## Debugger integration
+
 Supports [PEP 553][pep 553]'s `PYTHONBREAKPOINT` and
 compatible debuggers, for instance [ipdb][ipdb]:
 
@@ -73,6 +79,8 @@ $ uvx --from ipdb ipdb3 --help
 $ env PYTHONBREAKPOINT=ipdb.set_trace tmuxp shell
 ```
 
+## Code execution
+
 You can also pass in python code directly, similar to `python -c`, do
 this via `tmuxp -c`: