Fix CLI help text formatting with newlines

- Add \\b markers in query command docstring for proper list formatting
- Add \\b markers in mcp serve command docstring for tools list and examples
- Regenerate CLI reference docs

Author: abrookins

docs/reference/cli.md

@@ -72,37 +72,42 @@ Generated from the Click command tree.
     Supports conversation threads for multi-turn interactions. Use --thread-id
     to continue an existing conversation, or omit it to start a new one.
 
+    
     The agent is automatically selected based on the query:
-    - Knowledge agent: General Redis questions (no instance)
-    - Chat agent: Quick questions with a Redis instance
-    - Triage agent: Full health checks or --triage flag
+      - Knowledge agent: General Redis questions (no instance)
+      - Chat agent: Quick questions with a Redis instance
+      - Triage agent: Full health checks or --triage flag
 - worker — Start the background worker.
 - mcp — MCP server commands - expose agent capabilities via Model Context Protocol.
 - mcp list-tools — List available MCP tools.
 - mcp serve — Start the MCP server.
 
     The MCP server exposes the Redis SRE Agent's capabilities to other
-    MCP-compatible AI agents. Available tools:
-
-    - triage: Start a Redis troubleshooting session
-    - get_task_status: Check if a triage task is complete
-    - get_thread: Get the full results from a triage
-    - knowledge_search: Search Redis documentation and runbooks
-    - list_instances: List configured Redis instances
-    - create_instance: Register a new Redis instance
-
+    MCP-compatible AI agents.
+
+    
+    Available tools:
+      - triage: Start a Redis troubleshooting session
+      - get_task_status: Check if a triage task is complete
+      - get_thread: Get the full results from a triage
+      - knowledge_search: Search Redis documentation and runbooks
+      - list_instances: List configured Redis instances
+      - create_instance: Register a new Redis instance
+
+    
     Examples:
-
-        # Run in stdio mode (for Claude Desktop local config)
-        redis-sre-agent mcp serve
-
-        # Run in HTTP mode (for Claude remote connector - RECOMMENDED)
-        redis-sre-agent mcp serve --transport http --port 8081
-        # Then add in Claude: Settings > Connectors > Add Custom Connector
-        # URL: http://your-host:8081/mcp
-
-        # Run in SSE mode (legacy, for older clients)
-        redis-sre-agent mcp serve --transport sse --port 8081
+      # Run in stdio mode (for Claude Desktop local config)
+      redis-sre-agent mcp serve
+
+    
+      # Run in HTTP mode (for Claude remote connector - RECOMMENDED)
+      redis-sre-agent mcp serve --transport http --port 8081
+      # Then add in Claude: Settings > Connectors > Add Custom Connector
+      # URL: http://your-host:8081/mcp
+
+    
+      # Run in SSE mode (legacy, for older clients)
+      redis-sre-agent mcp serve --transport sse --port 8081
 - index — RediSearch index management commands.
 - index list — List all SRE agent indices and their status.
 - index recreate — Drop and recreate RediSearch indices.

redis_sre_agent/cli/mcp.py

@@ -31,27 +31,31 @@ def serve(transport: str, host: str, port: int):
     """Start the MCP server.
 
     The MCP server exposes the Redis SRE Agent's capabilities to other
-    MCP-compatible AI agents. Available tools:
+    MCP-compatible AI agents.
 
-    - triage: Start a Redis troubleshooting session
-    - get_task_status: Check if a triage task is complete
-    - get_thread: Get the full results from a triage
-    - knowledge_search: Search Redis documentation and runbooks
-    - list_instances: List configured Redis instances
-    - create_instance: Register a new Redis instance
+    \b
+    Available tools:
+      - triage: Start a Redis troubleshooting session
+      - get_task_status: Check if a triage task is complete
+      - get_thread: Get the full results from a triage
+      - knowledge_search: Search Redis documentation and runbooks
+      - list_instances: List configured Redis instances
+      - create_instance: Register a new Redis instance
 
+    \b
     Examples:
+      # Run in stdio mode (for Claude Desktop local config)
+      redis-sre-agent mcp serve
 
-        # Run in stdio mode (for Claude Desktop local config)
-        redis-sre-agent mcp serve
+    \b
+      # Run in HTTP mode (for Claude remote connector - RECOMMENDED)
+      redis-sre-agent mcp serve --transport http --port 8081
+      # Then add in Claude: Settings > Connectors > Add Custom Connector
+      # URL: http://your-host:8081/mcp
 
-        # Run in HTTP mode (for Claude remote connector - RECOMMENDED)
-        redis-sre-agent mcp serve --transport http --port 8081
-        # Then add in Claude: Settings > Connectors > Add Custom Connector
-        # URL: http://your-host:8081/mcp
-
-        # Run in SSE mode (legacy, for older clients)
-        redis-sre-agent mcp serve --transport sse --port 8081
+    \b
+      # Run in SSE mode (legacy, for older clients)
+      redis-sre-agent mcp serve --transport sse --port 8081
     """
     from redis_sre_agent.mcp_server.server import run_http, run_sse, run_stdio
 

redis_sre_agent/cli/query.py

@@ -31,10 +31,11 @@ def query(query: str, redis_instance_id: Optional[str], thread_id: Optional[str]
     Supports conversation threads for multi-turn interactions. Use --thread-id
     to continue an existing conversation, or omit it to start a new one.
 
+    \b
     The agent is automatically selected based on the query:
-    - Knowledge agent: General Redis questions (no instance)
-    - Chat agent: Quick questions with a Redis instance
-    - Triage agent: Full health checks or --triage flag
+      - Knowledge agent: General Redis questions (no instance)
+      - Chat agent: Quick questions with a Redis instance
+      - Triage agent: Full health checks or --triage flag
     """
 
     async def _query():