Module terminal 

Terminal spawning functionality

Spawns AI coding agents in tmux sessions for parallel task execution. Supports multiple AI harnesses: Claude Code, OpenCode.

Enums

Harness

Supported AI coding harnesses

Functions

check_tmux_available

Check if tmux is available

find_claude_binary

Find the full path to the claude binary (convenience wrapper).

find_harness_binary

Find the full path to a harness binary. Caches the result for subsequent calls.

kill_tmux_window

Kill a specific tmux window

setup_tmux_control_window

Setup the control window in a tmux session with monitoring script

spawn_in_tmux

Spawn a command in a tmux window (simpler than spawn_tmux which does more setup)

spawn_terminal

Spawn a new tmux window with the given command Returns the tmux window index for easy attachment (e.g., “3” for session:3)

spawn_terminal_ralph

Spawn a new tmux window with Ralph loop enabled The agent will keep running until the completion promise is detected

spawn_terminal_ralph_with_harness

Spawn a new tmux window with Ralph loop enabled using a specific harness

spawn_terminal_with_harness

Spawn a new tmux window with the given command using a specific harness Returns the tmux window index for easy attachment (e.g., “3” for session:3)

spawn_terminal_with_harness_and_model

Spawn a new tmux window with the given command using a specific harness and model Returns the tmux window index for easy attachment (e.g., “3” for session:3)

spawn_terminal_with_task_list

Spawn a new tmux window with Claude Code task list integration Returns the tmux window index for easy attachment (e.g., “3” for session:3)

tmux_attach

Attach to a tmux session

tmux_session_exists

Check if a tmux session exists

tmux_window_exists

Check if a specific window exists in a tmux session