Guide
Native sessions, worktrees or a manager?
We make Hormesis Workspace. This compares documented workflows on one example task, read 29 Oct 2026; we did not benchmark the tools.
If you can follow the work, answer the questions and review the changes comfortably in your existing sessions, keep that setup. Consider a worktree tool when managing separate checkouts is the recurring chore. Consider a session manager when finding the right session or decision is the recurring chore. These are overlapping choices: claude-squad, for example, manages sessions using tmux and Git worktrees. Git worktrees, tmux, Worktrunk, claude-squad.
One task, the same finish line
Imagine fixing a CSV export bug. One agent changes the application, another reviews the resulting diff, and a third updates the export guide in a separate documentation repository. The open product question is whether an empty export should produce a file containing only headings or show a message instead. You make that decision. The finish line is the same for every setup: the agreed behaviour works, the relevant checks pass, the review findings are resolved and the guide matches the result.
| Setup for this same task | What the documented tools provide | When we would stop here |
|---|---|---|
| Plain agent sessions, with checkouts you arrange | Sessions can remain in your existing terminals. Git worktrees let you check out separate branches of one repository at the same time. You arrange the directories and pass the candidate to the reviewer. Git documentation | You can keep track of the application change, review and guide update, and returning to the right conversation is easy. Running the review after the edit may be sufficient. |
| Claude Code’s own agent view | claude agents opens one screen for your background Claude Code sessions, across projects, with a Needs input group. In a Git repository, a session you dispatch from it moves into its own worktree before editing. It’s a research preview and covers Claude sessions only; interactive sessions in other terminals appear once you background them. Agent view, ways to run agents in parallel | All three pieces of work run in Claude Code, and a list of sessions with their state is enough for you. |
| tmux plus Git worktrees | tmux switches between terminal programs and lets you detach and reattach while they keep running. Worktrees provide the separate working directories. tmux, Git | Keeping the sessions available and the edits apart addresses your difficulty; you are comfortable coordinating the question and review yourself. |
| Worktrunk alongside your agent sessions | A CLI for creating, switching, listing, merging and removing worktrees. Its agent integrations also document working and waiting/idle markers in the worktree list. Overview, agent integration | Creating and navigating the application/review checkouts is the repetitive part. Those documented status markers may already give you enough visibility. |
| claude-squad | A terminal interface that manages agents using tmux sessions and Git worktrees, with each session on its own branch. Its README describes session navigation and change previews. Project README | You want session management around the terminal workflow you already use. Try whether its navigation and previews make this task comfortable before adding another interface. |
| Hormesis Workspace | A Mac app running the official Claude Code and Codex CLIs in terminal panes, with a map across projects, hand-off lines and decision cards. It recognises worktrees but provides no isolation by default. | Your difficulty is following the application worker, reviewer and documentation work across projects, or distinguishing a question for you from a wait between agents. Its map and Needs-you presentation address that problem. |
When plain sessions are enough
For the export fix, you might already know where the change is, which diff the reviewer has and where the product question will arrive. In that situation, our recommendation is to keep your existing workflow. If the missing piece is simply an alert, Claude Code’s own documentation explains notification hooks for when it needs input. A separate manager is not a prerequisite for that alert. Claude Code hooks guide.
If you prefer to leave the sessions running while you move between terminals, tmux documents detach and reattach. If you need different branches checked out concurrently, Git worktrees document that capability. Use the export task to decide whether those two tools cover your review and decision workflow. tmux documentation, Git worktree documentation.
Claude Code can also create the worktree for you: claude --worktree feature-auth starts a session in its own checkout on a new branch, and a second name in another terminal starts a second one. Worktrees separate file edits only. Claude Code worktrees
When a manager is worth trying
Try one when you repeatedly lose time locating the session that needs an answer, identifying the candidate being reviewed or returning to the documentation work. Worktrunk offers worktree lifecycle and activity views; claude-squad offers terminal session management; Workspace offers a map and a Needs-you list across projects. Worktrunk, claude-squad.
For a personal trial, keep the export task, candidate diff, review requirement and product decision the same. Note whether you can find the waiting agent, see who owns the next answer and return to the right work. Keep setup effort and manual coordination in that record too.
Where Hormesis Workspace fits
Workspace puts the projects and agent hand-offs on one map. It can present a decision as a card with pictures or a before/after view, return your answer to the agent and retain the decision history. For our export example, that gives a place to present the two proposed empty-state behaviours.
Its state words make a useful distinction for this task: Needs you means a permission prompt or a question addressed to you; Waiting can mean a question for a lead or an outstanding hand-off. Idle means the agent is at its prompt with nothing pending. Finished work appears in the Work list; “Finished” is not an agent-card state.
A worker’s ordinary question goes to its lead first when it has one; some questions go directly to the human. Decisions appear in-app. Items routed for immediate attention can produce a macOS notification when no Workspace window is focused, or the screen is locked, with notifications enabled. Routine progress, finished turns and idle states do not generate those notifications. These are public 1.0.2 behaviours.
Worktrees still need to be arranged: Workspace does not supply isolation by default. Review also needs to be set up; its separate reviewer can record PASS or FAIL, but the presence of a manager does not mean every result has been reviewed. If your present sessions and worktrees already handle the export task well, that is a reasonable place to stay.
Dates and evidence behind this comparison
| Source | Date / version used | What it supports |
|---|---|---|
| Git worktree manual and tmux project wiki | Read 29 Oct 2026 | Concurrent branch checkouts; terminal switching, detach and reattach. |
| Worktrunk documentation and agent integration | Read 29 Oct 2026; v0.81.0 release, 20 Oct 2026 | Worktree lifecycle and documented agent activity markers. |
| claude-squad README | Read 29 Oct 2026; v1.0.20 release page, dated 20 Aug, inspected on the same date | tmux/worktree architecture, session navigation and previews. |
| Claude Code hooks guide | Read 29 Oct 2026 | A documented notification route in the CLI workflow. |
| Claude Code agent view and worktrees | Read 30 Oct 2026 | Background sessions across projects; the worktree flag and what it isolates. |