TMUX-Aware Process Management

Overview

When running inside a TMUX session, manage services in dedicated panes without cluttering the current view. All Claude-created panes go in a dedicated "claude-controlled" window.

For the visual workflow diagram, see ./references/workflow.mmd.

Key Principles

1. Never clutter the current window - Always create panes in the "claude-controlled" window
2. Find panes by name - Search for existing panes/windows by title, not by process
3. Verify commands worked - Capture output after sending commands to detect errors
4. Ask when uncertain - If a pane can't be found by name, list options and ask the user

Starting a Service

When the user asks to start a service (e.g., "start the API server"):