docs(cli[stop,new,copy,delete]): Add command docs and API pages

why: New CLI commands need user-facing and API documentation.
what:
- Add CLI doc pages for stop, new, copy, delete
- Add API doc pages for stop, new, copy, delete
- Update toctrees in cli/index.md and api/cli/index.md

Author: tony

docs/api/cli/copy.md

@@ -0,0 +1,8 @@
+# tmuxp copy - `tmuxp.cli.copy`
+
+```{eval-rst}
+.. automodule:: tmuxp.cli.copy
+   :members:
+   :show-inheritance:
+   :undoc-members:
+```

docs/api/cli/delete.md

@@ -0,0 +1,8 @@
+# tmuxp delete - `tmuxp.cli.delete`
+
+```{eval-rst}
+.. automodule:: tmuxp.cli.delete
+   :members:
+   :show-inheritance:
+   :undoc-members:
+```

docs/api/cli/index.md

@@ -19,6 +19,10 @@ ls
 progress
 search
 shell
+stop
+new
+copy
+delete
 utils
 ```
 

docs/api/cli/new.md

@@ -0,0 +1,8 @@
+# tmuxp new - `tmuxp.cli.new`
+
+```{eval-rst}
+.. automodule:: tmuxp.cli.new
+   :members:
+   :show-inheritance:
+   :undoc-members:
+```

docs/api/cli/stop.md

@@ -0,0 +1,8 @@
+# tmuxp stop - `tmuxp.cli.stop`
+
+```{eval-rst}
+.. automodule:: tmuxp.cli.stop
+   :members:
+   :show-inheritance:
+   :undoc-members:
+```

docs/cli/copy.md

@@ -0,0 +1,25 @@
+(cli-copy)=
+
+(cli-copy-reference)=
+
+# tmuxp copy
+
+Copy an existing workspace config to a new name. Source is resolved using the same logic as `tmuxp load` (supports names, paths, and extensions).
+
+## Command
+
+```{eval-rst}
+.. argparse::
+    :module: tmuxp.cli
+    :func: create_parser
+    :prog: tmuxp
+    :path: copy
+```
+
+## Basic usage
+
+Copy a workspace:
+
+```console
+$ tmuxp copy myproject myproject-backup
+```

docs/cli/delete.md

@@ -0,0 +1,37 @@
+(cli-delete)=
+
+(cli-delete-reference)=
+
+# tmuxp delete
+
+Delete one or more workspace config files. Prompts for confirmation unless `-y` is passed.
+
+## Command
+
+```{eval-rst}
+.. argparse::
+    :module: tmuxp.cli
+    :func: create_parser
+    :prog: tmuxp
+    :path: delete
+```
+
+## Basic usage
+
+Delete a workspace:
+
+```console
+$ tmuxp delete old-project
+```
+
+Delete without confirmation:
+
+```console
+$ tmuxp delete -y old-project
+```
+
+Delete multiple workspaces:
+
+```console
+$ tmuxp delete proj1 proj2
+```

docs/cli/index.md

@@ -12,6 +12,7 @@ load
 shell
 ls
 search
+stop
 ```
 
 ```{toctree}
@@ -22,6 +23,9 @@ edit
 import
 convert
 freeze
+new
+copy
+delete
 ```
 
 ```{toctree}

docs/cli/new.md

@@ -0,0 +1,25 @@
+(cli-new)=
+
+(cli-new-reference)=
+
+# tmuxp new
+
+Create a new workspace configuration file from a minimal template and open it in `$EDITOR`. If the workspace already exists, it opens for editing.
+
+## Command
+
+```{eval-rst}
+.. argparse::
+    :module: tmuxp.cli
+    :func: create_parser
+    :prog: tmuxp
+    :path: new
+```
+
+## Basic usage
+
+Create a new workspace:
+
+```console
+$ tmuxp new myproject
+```

docs/cli/stop.md

@@ -0,0 +1,37 @@
+(cli-stop)=
+
+(cli-stop-reference)=
+
+# tmuxp stop
+
+Stop (kill) a running tmux session. If `on_project_stop` is defined in the workspace config, that hook runs before the session is killed.
+
+## Command
+
+```{eval-rst}
+.. argparse::
+    :module: tmuxp.cli
+    :func: create_parser
+    :prog: tmuxp
+    :path: stop
+```
+
+## Basic usage
+
+Stop a session by name:
+
+```console
+$ tmuxp stop mysession
+```
+
+Stop the currently attached session:
+
+```console
+$ tmuxp stop
+```
+
+Use a custom socket:
+
+```console
+$ tmuxp stop -L mysocket mysession
+```