docs: Add tools overview page grouped by intent

why: Top MCP servers group tools by user intent, not implementation
module. Users scan for what they want to do, not where code lives.
what:
- Create docs/tools/index.md with intent-based grouping
- Groups: discovery, capture/search, session lifecycle, windows/panes,
  execution, options/env, server management
- One-line descriptions per tool
- Link to parameter reference and API docs

Author: tony

docs/tools/.gitkeep

@@ -0,0 +1,71 @@
+(tools-overview)=
+
+# Tools
+
+All tools accept an optional `socket_name` parameter for multi-server support. It defaults to the `LIBTMUX_SOCKET` env var. See {ref}`configuration`.
+
+## Discovery
+
+Find and inspect tmux objects.
+
+- **`list_sessions`** — List all sessions (with optional filters)
+- **`list_windows`** — List windows in a session or across all sessions
+- **`list_panes`** — List panes in a window or across all windows
+- **`get_server_info`** — Server status: version, socket path, session count, alive status
+- **`get_pane_info`** — Pane metadata: size, title, current command, PID
+
+## Capture and search
+
+Read and search terminal output.
+
+- **`capture_pane`** — Capture pane content as text (visible area or scrollback)
+- **`search_panes`** — Search across all pane contents for text or regex
+- **`wait_for_text`** — Wait for text to appear in a pane (polling with timeout)
+
+## Session lifecycle
+
+Create and manage sessions.
+
+- **`create_session`** — Create a new session with optional window name, size, and env vars
+- **`rename_session`** — Rename an existing session
+- **`kill_session`** — Kill a session (destructive)
+
+## Windows and panes
+
+Create, split, and organize.
+
+- **`create_window`** — Create a new window in a session
+- **`split_window`** — Split a window to create a new pane (horizontal or vertical)
+- **`rename_window`** — Rename a window
+- **`select_layout`** — Set layout: `even-horizontal`, `even-vertical`, `main-horizontal`, `main-vertical`, `tiled`
+- **`resize_window`** — Resize a window (width and/or height)
+- **`resize_pane`** — Resize a pane (width, height, or zoom toggle)
+- **`kill_window`** — Kill a window (destructive)
+- **`kill_pane`** — Kill a pane (destructive)
+
+## Execution
+
+Send commands and interact with terminals.
+
+- **`send_keys`** — Send keys or text to a pane (with optional Enter, literal mode, history suppression)
+- **`set_pane_title`** — Set a pane's title
+- **`clear_pane`** — Clear pane content and scrollback history
+
+## Options and environment
+
+Read and set tmux configuration.
+
+- **`show_option`** — Query a tmux option value (server, session, window, or pane scope)
+- **`set_option`** — Set a tmux option
+- **`show_environment`** — Show tmux environment variables
+- **`set_environment`** — Set a tmux environment variable
+
+## Server management
+
+- **`kill_server`** — Kill the tmux server (destructive)
+
+## Tool parameter reference
+
+For full parameter documentation (types, defaults, descriptions), see the {ref}`about <about>` page.
+
+For API-level documentation, see the {ref}`API reference <api>`.