feat: default-tmux-sessions

CONTRIBUTING.md

@@ -11,7 +11,7 @@ cd devloop
 devloop doctor         # verify required dependencies
 ```
 
-Required to run a loop: Bash, git, `glow`, `gum`, `fzf`, and the `codex` and `claude` CLIs. The install scripts use Homebrew to install missing git/UI tools and the Codex/Claude Code casks when `brew` is available. The test suite itself needs only Bash, git, and coreutils, so you can develop and test without the agent CLIs installed.
+Required to run a loop: Bash, git, `glow`, `gum`, `fzf`, `tmux`, and the `codex` and `claude` CLIs. The install scripts use Homebrew to install missing git/UI tools and tmux, plus the Codex/Claude Code casks when `brew` is available. Interactive runs enter a named tmux session by default; use `--no-tmux` when debugging the foreground process. The test suite itself needs only Bash, git, and coreutils because tmux behavior is covered with a fake executable.
 
 ## Development loop
 

README.md

@@ -27,7 +27,7 @@ cd devloop
 ./scripts/install.sh
 ```
 
-> Requires Bash, git, `codex`, `claude`, `glow`, `gum`, and `fzf`. Run `devloop doctor` to check.
+> Requires Bash, git, `codex`, `claude`, `glow`, `gum`, `fzf`, and `tmux`. Run `devloop doctor` to check.
 > The installers use Homebrew to install missing git/UI tools and the Codex/Claude Code casks when `brew` is available.
 
 Uninstall with `./scripts/uninstall.sh` (`--dry-run` to preview).
@@ -40,6 +40,7 @@ Uninstall with `./scripts/uninstall.sh` (`--dry-run` to preview).
 | `devloop spec "..."` | Have an agent interview you and write a spec |
 | `devloop nightshift` | Survey configured repos, run selected specs headlessly, and write a morning digest |
 | `devloop <spec.md>` | Run a spec |
+| `devloop --no-tmux <spec.md>` | Run a spec in the current foreground terminal |
 | `devloop --create-pr <spec.md>` | Run a spec and maintain a draft PR (requires `gh`) |
 | `devloop update` | Install the latest released Devloop |
 | `devloop continue` | Resume a tracked run |
@@ -49,6 +50,8 @@ Uninstall with `./scripts/uninstall.sh` (`--dry-run` to preview).
 Each run writes an HTML report, spec, and reviews under `.devloop/`.
 When you pick a spec from the interactive menu, devloop uses your configured run defaults and only prompts for PR mode. The interactive **Settings** menu sets the default coder and reviewer agents (Codex or Claude Code), spec path, and run timeout, saved to `~/.devloop/config`. Use CLI flags such as `--coder`, `--reviewer`, `--in-place`, or `--timeout-minutes` to override those defaults per run.
 
+Interactive run and continue workflows start in a new named tmux session by default. Detach without stopping devloop with `Ctrl-b d`, list sessions with `tmux list-sessions`, and reconnect with `tmux attach -t <session>`. Pass `--no-tmux` to an explicit run or continue command to keep the existing foreground behavior. Redirected, piped, and scheduled runs stay in the foreground automatically.
+
 ## Specs
 
 A good spec is short, concrete, and verifiable. It includes a repository-grounded implementation map, invariants, credible failure modes, and a proof map linking every obligation to test evidence. Start from [`skills/devloop-spec/references/spec-template.md`](skills/devloop-spec/references/spec-template.md). The bundled `devloop-spec` skill can also render a sibling HTML companion with [`skills/devloop-spec/scripts/render.sh`](skills/devloop-spec/scripts/render.sh).