# tmux Integration

Voxcode works well in tmux for persistent, resumable development sessions.

## Benefits

- Detach and reattach without interrupting Voxcode
- Split panes for agent output, test runners, and logs side by side
- Scrollback buffer preserves large debugging transcripts

## Recommended tmux Configuration

Add to `~/.tmux.conf`:

```tmux
# Enable true color
set -g default-terminal "tmux-256color"
set -ga terminal-overrides ",*256col*:Tc"

# Larger scrollback
set -g history-limit 50000

# Mouse support (optional)
set -g mouse on

# Status bar with session name
set -g status-left "#[fg=green]#S "
```

## Tips

- Use separate panes for agent output and test commands.
- Keep scrollback large enough for debugging transcripts.
- Name your tmux sessions: `tmux new -s voxcode-work`
- Detach with `Ctrl-b d`, reattach with `tmux attach -t voxcode-work`
- Run `vox` inside a tmux pane and use a second pane for `npm test` or `npm run check`

## Known Issues

- Mouse mode can interfere with Voxcode's built-in selection — enable only if your workflow needs it.
- Some terminal emulators may not forward true color through tmux correctly; verify with a color test script.
