docs(tools): Add response examples to 15 tools that lacked them

why: 15 of 27 tools had no response examples, making it hard for
agents and humans to predict output shapes without trial calls.
what:
- panes.md: get_pane_info, set_pane_title, clear_pane, resize_pane, kill_pane
- sessions.md: get_server_info, kill_session, kill_server
- windows.md: list_panes, rename_window, select_layout, resize_window, kill_window
- options.md: show_environment, set_environment
- All responses derived from real MCP outputs, anonymized

Author: tony

docs/tools/options.md

@@ -42,6 +42,29 @@ Response:
 
 **Side effects:** None. Readonly.
 
+**Example:**
+
+```json
+{
+  "tool": "show_environment",
+  "arguments": {}
+}
+```
+
+Response:
+
+```json
+{
+  "variables": {
+    "SHELL": "/bin/zsh",
+    "TERM": "xterm-256color",
+    "HOME": "/home/user",
+    "USER": "user",
+    "LANG": "C.UTF-8"
+  }
+}
+```
+
 ```{fastmcp-tool-input} env_tools.show_environment
 ```
 
@@ -89,5 +112,27 @@ Response:
 
 **Side effects:** Sets the variable in the tmux server.
 
+**Example:**
+
+```json
+{
+  "tool": "set_environment",
+  "arguments": {
+    "name": "MY_VAR",
+    "value": "hello"
+  }
+}
+```
+
+Response:
+
+```json
+{
+  "name": "MY_VAR",
+  "value": "hello",
+  "status": "set"
+}
+```
+
 ```{fastmcp-tool-input} env_tools.set_environment
 ```

docs/tools/panes.md

@@ -55,6 +55,36 @@ other metadata without reading the terminal content.
 
 **Side effects:** None. Readonly.
 
+**Example:**
+
+```json
+{
+  "tool": "get_pane_info",
+  "arguments": {
+    "pane_id": "%0"
+  }
+}
+```
+
+Response:
+
+```json
+{
+  "pane_id": "%0",
+  "pane_index": "0",
+  "pane_width": "80",
+  "pane_height": "24",
+  "pane_current_command": "zsh",
+  "pane_current_path": "/home/user/myproject",
+  "pane_pid": "12345",
+  "pane_title": "",
+  "pane_active": "1",
+  "window_id": "@0",
+  "session_id": "$0",
+  "is_caller": null
+}
+```
+
 ```{fastmcp-tool-input} pane_tools.get_pane_info
 ```
 
@@ -195,6 +225,37 @@ Keys sent to pane %2
 
 **Side effects:** Changes the pane title.
 
+**Example:**
+
+```json
+{
+  "tool": "set_pane_title",
+  "arguments": {
+    "pane_id": "%0",
+    "title": "build"
+  }
+}
+```
+
+Response:
+
+```json
+{
+  "pane_id": "%0",
+  "pane_index": "0",
+  "pane_width": "80",
+  "pane_height": "24",
+  "pane_current_command": "zsh",
+  "pane_current_path": "/home/user/myproject",
+  "pane_pid": "12345",
+  "pane_title": "build",
+  "pane_active": "1",
+  "window_id": "@0",
+  "session_id": "$0",
+  "is_caller": null
+}
+```
+
 ```{fastmcp-tool-input} pane_tools.set_pane_title
 ```
 
@@ -207,6 +268,23 @@ Keys sent to pane %2
 
 **Side effects:** Clears the pane's visible content.
 
+**Example:**
+
+```json
+{
+  "tool": "clear_pane",
+  "arguments": {
+    "pane_id": "%0"
+  }
+}
+```
+
+Response (string):
+
+```text
+Pane cleared: %0
+```
+
 ```{fastmcp-tool-input} pane_tools.clear_pane
 ```
 
@@ -219,6 +297,37 @@ Keys sent to pane %2
 
 **Side effects:** Changes pane size. May affect adjacent panes.
 
+**Example:**
+
+```json
+{
+  "tool": "resize_pane",
+  "arguments": {
+    "pane_id": "%0",
+    "height": 15
+  }
+}
+```
+
+Response:
+
+```json
+{
+  "pane_id": "%0",
+  "pane_index": "0",
+  "pane_width": "80",
+  "pane_height": "15",
+  "pane_current_command": "zsh",
+  "pane_current_path": "/home/user/myproject",
+  "pane_pid": "12345",
+  "pane_title": "",
+  "pane_active": "1",
+  "window_id": "@0",
+  "session_id": "$0",
+  "is_caller": null
+}
+```
+
 ```{fastmcp-tool-input} pane_tools.resize_pane
 ```
 
@@ -234,5 +343,22 @@ without affecting sibling panes.
 
 **Side effects:** Destroys the pane. Not reversible.
 
+**Example:**
+
+```json
+{
+  "tool": "kill_pane",
+  "arguments": {
+    "pane_id": "%1"
+  }
+}
+```
+
+Response (string):
+
+```text
+Pane killed: %1
+```
+
 ```{fastmcp-tool-input} pane_tools.kill_pane
 ```

docs/tools/sessions.md

@@ -51,6 +51,27 @@ or inspect server-level state before creating sessions.
 
 **Side effects:** None. Readonly.
 
+**Example:**
+
+```json
+{
+  "tool": "get_server_info",
+  "arguments": {}
+}
+```
+
+Response:
+
+```json
+{
+  "is_alive": true,
+  "socket_name": null,
+  "socket_path": null,
+  "session_count": 2,
+  "version": "3.6a"
+}
+```
+
 ```{fastmcp-tool-input} server_tools.get_server_info
 ```
 
@@ -141,6 +162,23 @@ windows and panes in the session.
 
 **Side effects:** Destroys the session and all its contents. Not reversible.
 
+**Example:**
+
+```json
+{
+  "tool": "kill_session",
+  "arguments": {
+    "session_name": "old-workspace"
+  }
+}
+```
+
+Response (string):
+
+```text
+Session killed: old-workspace
+```
+
 ```{fastmcp-tool-input} session_tools.kill_session
 ```
 
@@ -156,5 +194,20 @@ session, window, and pane.
 
 **Side effects:** Destroys everything. Not reversible.
 
+**Example:**
+
+```json
+{
+  "tool": "kill_server",
+  "arguments": {}
+}
+```
+
+Response (string):
+
+```text
+Server killed
+```
+
 ```{fastmcp-tool-input} server_tools.kill_server
 ```