tmux-interactive-processes

Files (1)

• SKILL.md

SKILL.md (first lines)

# Tmux Interactive Processes

Use tmux when a command needs to keep running, accept later input, show ongoing output, or remain available for human attachment.

Prefer tmux over raw background shell patterns because the process stays visible, inspectable, attachable, and controllable.

## Avoid Background Bash

Do not use these patterns for long-running or interactive work:

```bash
command &
nohup command &
command > log.txt 2>&1 &
disown
tail -f log.txt
```

Use normal shell execution only when the command runs to completion and prints final output.

## Session Names

Use stable, descriptive names:

```bash
agent-<repo-or-project>-<purpose>
```

Examples:

```bash
agent-myapp-dev
agent-myapp-tests
agent-myapp-debug
agent-myapp-repl
```

Check existing sessions before creating a new one:

```bash
tmux list-sessions
```

Reuse a matching session when appropriate.

## Start Commands

Create a detached session from the current working directory:

```bash
tmux new-session -d -s agent-myapp-dev -c "$PWD" 'npm run dev'
```

For commands with tricky quoting, start a shell first:

```bash
tmux new-session -d -s agent-myapp-dev -c "$PWD" bash
tmux send-keys -t agent-myapp-dev 'npm run dev' C-m
```

Inspect the pane after startup before claiming success.

## Inspect Output

Capture recent output:

```bash
tmux capture-pane -pt agent-myapp-dev -S -200
```

Capture more history:

```bash
tmux capture-pane -pt agent-myapp-dev -S -1000
```

Use `capture-pane` to verify readiness, failures, prompts, and current state.

## Send Input

Send text followed by Enter:

```bash
tmux send-keys -t agent-myapp-dev 'help' C-m
```

Send control keys:

```bash
tmux send-keys -t agent-myapp-dev C-c
```

Use `send-keys` for REPLs, debuggers, prompts, and graceful shutdown.

## User Attachment

When useful, report the session name and attach command:

```bash
tmux attach -t agent-myapp-dev
```

## Stop Sessions

Prefer graceful shutdown first:

```bash
tmux send-keys -t agent-myapp-dev C-c
```

Inspect after shutdown:

```bash
tmux capture-pane -pt agent-myapp-dev -S -100
```

Remove the session only when it is no longer needed:

```bash

From adampoit/ai, MIT.

More from adampoit/ai