# workmux

Podium publishes this catalog and sells an agent development environment. Podium chooses the products, criteria, sources and wording, so treat these pages as vendor-authored research. Check important claims against the linked primary sources. The same evidence rules apply to Podium and its competitors, but they do not remove this conflict of interest.

Page: https://adecomparison.com/ade/workmux/
Website: https://workmux.dev/
Research: covered

Method: https://adecomparison.com/method/

Rank by must-haves met, then preferences, then name. Read each finding's checked date. Findings stay published after their scheduled recheck. Checks over six months old may be outdated.

## workmux:ACC-01

Finding: Terminal-native access: macOS/Linux CLI plus tmux dashboard TUI and sidebar pane; kitty/WezTerm/Zellij backends experimental. No desktop GUI, mobile apps, browser client, or editor extensions. Windows explicitly unsupported.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-12-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

Only the cited atomic findings are established; no hands-on client matrix was run.
Windows is explicitly unsupported; no mobile, browser, or editor-extension clients exist in the documented inventory.

Source: https://workmux.dev/
Locator: Hero; Remote servers; How it works; Skills; Setup sections
Finding: Terminal-first workflow for parallel AI agents using git worktrees: one task per worktree and tmux window, sidebar and dashboard for agent status, sandbox containment, SSH remote servers, agent skills; described as free and open source.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/installation/
Locator: Bash/Homebrew/Cargo/mise/Nix methods; Shell alias; Completions; Uninstalling
Finding: Install via install script, Homebrew (macOS/Linux), Cargo, mise, Nix, or prebuilt binaries; shell completions for bash/zsh/fish; uninstall script removes data dirs; no account, signup, or payment step.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/quick-start/
Locator: Prerequisites; steps 1-5; The parallel AI workflow
Finding: Prerequisites: Git 2.5+ and tmux (or WezTerm/kitty/Zellij); flow is install, optional workmux init, workmux add (creates worktree + window + panes + setup), work, workmux merge cleanup; /worktree skill recommended from inside agent sessions.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/status-tracking/
Locator: Agent support table; Status icons; Automated setup; Pi subagents; Interrupted detection; last-done/last-agent
Finding: Supported: Claude Code, OpenCode, Codex, Copilot CLI, Pi, Oh My Pi, Gemini CLI, Grok, Antigravity agy (with version/capability footnotes); Kiro and Mistral Vibe are tracking-issues only; icons working/waiting/done; workmux setup installs hooks; last-done/last-agent navigation; nested-agent opt-out via WORKMUX_DISABLE_SET_WINDOW_STATUS=1.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/dashboard/
Locator: Setup; Agents/Worktrees views; Keybindings; Columns; Live preview; Input mode; Sort modes; Sweep
Finding: Optional TUI popup (tmux display-popup binding) requiring status hooks; Agents view (status, git info, PR checks, live preview) and Worktrees view; input mode sends keystrokes to agent; keys jump/diff/commit/merge/kill/remove/sweep; sort by priority/project/recency; sweep bulk-removes merged/gone worktrees.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/sidebar/
Locator: Setup; What it shows; Layouts; Sleeping agents; Session filter; Views
Finding: Always-visible agent overview pinned to tmux windows (or Zellij tabs): per-agent tile with status icon, worktree, elapsed time, project, git diff stats, optional PR number/checks, task description; toggle via workmux sidebar; session scoping and named views; requires status hooks.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/
Locator: Overview (Experimental); How it fits together; Quick start
Finding: Experimental: run agents on user-reachable Linux servers over SSH; each remote agent keeps a local tmux window and appears in dashboard/sidebar/status/list as handle@remote; agent keeps working while local machine sleeps, loses network, or closes the window; window reconnects by itself; workmux merge brings work home; local machine stays Git source of truth.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/workflows/
Locator: From terminal; From agent session; Forking; Coordinating; Direct merge; PR-based
Finding: add -A auto-names from prompt; /worktree spins off from running agents; --fork resumes conversations (Claude/Codex/Pi); /coordinator plans+delegates+merges; /merge for direct merge; /open-pr + git push + gh pr create then workmux remove/--gone for PR flow.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/
Locator: Commands overview table
Finding: Command reference inventory: 24 documented command pages (add merge rebase remove rename list status open close resurrect sync-files path shell dashboard sidebar reap-agents config edit init claude prune sandbox remote completions docs update last-done) plus additional CLI-only commands (setup, send, wait, capture, run); no REST API, SDK, MCP server, webhook, or scheduling commands appear in the reference or full docs.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/add/
Locator: Arguments; Options table
Finding: Creates worktree + multiplexer window; --pr checks out GitHub PRs (gh) or GitLab MRs (glab 1.37+, --forge); -A auto-name via llm CLI; --fork/--continue resume; -n/--foreach/--agent multi-generation; -l layouts; --remote/--local placement; -b background; --with-changes moves uncommitted work.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/merge/
Locator: When to use merge vs remove; Options; Merge strategies; What happens
Finding: Local git merge into main (or --into) with merge/rebase/squash strategies plus worktree+window+branch cleanup; --keep/merge_keep; --notification system notification; PR workflows merge remotely and use remove for cleanup instead.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/update/
Locator: Supported platforms; Automatic update check; Requirements
Finding: Prebuilt binaries for macOS (Apple Silicon/Intel) and Linux (x86_64/ARM64); background update check at most daily, disableable via auto_update_check:false or WORKMUX_NO_UPDATE_CHECK=1; update verifies checksums, Homebrew installs defer to brew.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/kitty/
Locator: Experimental; Differences from tmux; Requirements
Finding: Experimental kitty backend (remote-control API, Unix socket); Unix-like OS with named pipes required; Windows is not supported.
Retrieved: 2026-11-12

## workmux:ACC-02

Finding: Eleven built-in harnesses (claude, codex, copilot, opencode, gemini, agy, kiro-cli, vibe, pi, omp, grok) launched as installed CLIs with prompt injection and status hooks; global named profiles allow custom commands/env; multi-harness layouts documented but not observed here.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-12-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

Model-provider choice is inherited from each harness; no provider catalog was established.
Mixed-harness operation is documented (multi-agent generation, mixed layouts) but no two-harness run was observed in this pass.

Source: https://workmux.dev/guide/configuration/
Locator: Two-level system; Remotes; placement; Panes and agent placeholders; File operations; Lifecycle hooks
Finding: Global ~/.config/workmux/config.yaml plus per-project .workmux.yaml; remotes and named agents are global-only; placement selects local or a named remote; panes support <agent> placeholders, splits, sizes; files copy/symlink; post_create/pre_merge/pre_remove hooks.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/agents/
Locator: Agent integration; Named agents; Per-pane agents; Parallel workflows
Finding: Built-in agents: claude, codex, copilot, opencode, gemini, agy, kiro-cli, vibe, pi, omp, grok; prompt injection via -p/-P/-e without config changes; named global profiles with type/command/args/env (incl. from_env); multi-worktree generation (-a/-n/--foreach) e.g. one worktree each for claude and gemini.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/status-tracking/
Locator: Agent support table; Status icons; Automated setup; Pi subagents; Interrupted detection; last-done/last-agent
Finding: Supported: Claude Code, OpenCode, Codex, Copilot CLI, Pi, Oh My Pi, Gemini CLI, Grok, Antigravity agy (with version/capability footnotes); Kiro and Mistral Vibe are tracking-issues only; icons working/waiting/done; workmux setup installs hooks; last-done/last-agent navigation; nested-agent opt-out via WORKMUX_DISABLE_SET_WINDOW_STATUS=1.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/workflows/
Locator: From terminal; From agent session; Forking; Coordinating; Direct merge; PR-based
Finding: add -A auto-names from prompt; /worktree spins off from running agents; --fork resumes conversations (Claude/Codex/Pi); /coordinator plans+delegates+merges; /merge for direct merge; /open-pr + git push + gh pr create then workmux remove/--gone for PR flow.
Retrieved: 2026-11-12

## workmux:ACC-03

Finding: Bring your own agent subscriptions and logins: local runs reuse installed CLI logins; remote login executes each agent native login flow. No workmux account, credits, or local-model route; agent switching via named profiles.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-12-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

API-key and local-model routes were not established beyond proxy-style env examples.
No vendor billing exists, so credits/overage behavior is not applicable.

Source: https://workmux.dev/guide/installation/
Locator: Bash/Homebrew/Cargo/mise/Nix methods; Shell alias; Completions; Uninstalling
Finding: Install via install script, Homebrew (macOS/Linux), Cargo, mise, Nix, or prebuilt binaries; shell completions for bash/zsh/fish; uninstall script removes data dirs; no account, signup, or payment step.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/agents/
Locator: Agent integration; Named agents; Per-pane agents; Parallel workflows
Finding: Built-in agents: claude, codex, copilot, opencode, gemini, agy, kiro-cli, vibe, pi, omp, grok; prompt injection via -p/-P/-e without config changes; named global profiles with type/command/args/env (incl. from_env); multi-worktree generation (-a/-n/--foreach) e.g. one worktree each for claude and gemini.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/claude-code/
Locator: Share permissions; Skip permission prompts (yolo mode); Multiple configurations
Finding: Permission options: symlink .claude/settings.local.json across worktrees, or named agent shadowing claude with --dangerously-skip-permissions; separate work/personal configs via named agents or CLAUDE_CONFIG_DIR.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/status-tracking/
Locator: Agent support table; Status icons; Automated setup; Pi subagents; Interrupted detection; last-done/last-agent
Finding: Supported: Claude Code, OpenCode, Codex, Copilot CLI, Pi, Oh My Pi, Gemini CLI, Grok, Antigravity agy (with version/capability footnotes); Kiro and Mistral Vibe are tracking-issues only; icons working/waiting/done; workmux setup installs hooks; last-done/last-agent navigation; nested-agent opt-out via WORKMUX_DISABLE_SET_WINDOW_STATUS=1.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/setup/
Locator: Requirements; Server or Docker; Install and check; Supplemental files; Security
Finding: Requires Linux x86-64/ARM64, promptless SSH, git, tmux 3.3+, systemd linger, API access; host mode (no sandbox) vs Docker mode per sandbox.enabled/isolation; server never talks to Git hosting and gets no origin; remote_files allowlist (64 MiB cap); no host-command proxying on servers.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/logins/
Locator: Per-agent login table; Copy logins; Claude long-lived token; Environment variables
Finding: remote login runs each agent native login flow (claude/codex/gemini/opencode/pi/omp) with localhost port forwarding; --import does a one-time credential copy (with rotation caveats); setup-token for Claude; sandbox env passthrough read once per workspace and stored privately on server.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/add/
Locator: Arguments; Options table
Finding: Creates worktree + multiplexer window; --pr checks out GitHub PRs (gh) or GitLab MRs (glab 1.37+, --forge); -A auto-name via llm CLI; --fork/--continue resume; -n/--foreach/--agent multi-generation; -l layouts; --remote/--local placement; -b background; --with-changes moves uncommitted work.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/zellij/
Locator: Experimental; Differences from tmux; Sidebar; Requirements
Finding: Experimental Zellij backend requiring 0.44.1+; operates in current session; window-mode only; no dashboard preview (dump-screen covers focused pane only); sidebar supported; Windows is not supported.
Retrieved: 2026-11-12

## workmux:ACC-04

Finding: Install binary, optional init, then workmux add; works with local Git (local-state main detection) and hosted remotes (fetch refs, PR checkout). Requires an existing Git repo and tmux; no managed cloud exists; BYO-server onboarding via setup/doctor/login is experimental.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-12-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

Remote-server onboarding is explicitly experimental.
Behavior in a non-Git directory and managed-cloud setup (no such offering) bound the result; see atoms.

Source: https://workmux.dev/guide/installation/
Locator: Bash/Homebrew/Cargo/mise/Nix methods; Shell alias; Completions; Uninstalling
Finding: Install via install script, Homebrew (macOS/Linux), Cargo, mise, Nix, or prebuilt binaries; shell completions for bash/zsh/fish; uninstall script removes data dirs; no account, signup, or payment step.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/quick-start/
Locator: Prerequisites; steps 1-5; The parallel AI workflow
Finding: Prerequisites: Git 2.5+ and tmux (or WezTerm/kitty/Zellij); flow is install, optional workmux init, workmux add (creates worktree + window + panes + setup), work, workmux merge cleanup; /worktree skill recommended from inside agent sessions.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/configuration/
Locator: Two-level system; Remotes; placement; Panes and agent placeholders; File operations; Lifecycle hooks
Finding: Global ~/.config/workmux/config.yaml plus per-project .workmux.yaml; remotes and named agents are global-only; placement selects local or a named remote; panes support <agent> placeholders, splits, sizes; files copy/symlink; post_create/pre_merge/pre_remove hooks.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/
Locator: Overview (Experimental); How it fits together; Quick start
Finding: Experimental: run agents on user-reachable Linux servers over SSH; each remote agent keeps a local tmux window and appears in dashboard/sidebar/status/list as handle@remote; agent keeps working while local machine sleeps, loses network, or closes the window; window reconnects by itself; workmux merge brings work home; local machine stays Git source of truth.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/setup/
Locator: Requirements; Server or Docker; Install and check; Supplemental files; Security
Finding: Requires Linux x86-64/ARM64, promptless SSH, git, tmux 3.3+, systemd linger, API access; host mode (no sandbox) vs Docker mode per sandbox.enabled/isolation; server never talks to Git hosting and gets no origin; remote_files allowlist (64 MiB cap); no host-command proxying on servers.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/workflows/
Locator: From terminal; From agent session; Forking; Coordinating; Direct merge; PR-based
Finding: add -A auto-names from prompt; /worktree spins off from running agents; --fork resumes conversations (Claude/Codex/Pi); /coordinator plans+delegates+merges; /merge for direct merge; /open-pr + git push + gh pr create then workmux remove/--gone for PR flow.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/add/
Locator: Arguments; Options table
Finding: Creates worktree + multiplexer window; --pr checks out GitHub PRs (gh) or GitLab MRs (glab 1.37+, --forge); -A auto-name via llm CLI; --fork/--continue resume; -n/--foreach/--agent multi-generation; -l layouts; --remote/--local placement; -b background; --with-changes moves uncommitted work.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/merge/
Locator: When to use merge vs remove; Options; Merge strategies; What happens
Finding: Local git merge into main (or --into) with merge/rebase/squash strategies plus worktree+window+branch cleanup; --keep/merge_keep; --notification system notification; PR workflows merge remotely and use remove for cleanup instead.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/remote/
Locator: remote/setup/doctor/login reference
Finding: remote lists servers and placement default; setup installs matching node + status hooks; doctor runs 10 checks (ssh/arch/node/git/tmux/linger/mode/hooks/logins/image) with fixes; login runs native agent flows with --import/--setup-token options.
Retrieved: 2026-11-12

## workmux:ACC-05

Finding: Product CLI covers create/inspect/steer/stop/review with JSON output for status/list and agent-facing ops (status/send/wait/capture/run). No REST API, SDK, MCP server, or webhooks exist in the complete command inventory and docs.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-12-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

No API/SDK/MCP-server/webhook surface: automation goes through the CLI.
No published API-stability policy beyond versioned releases and remote protocol checks.

Source: https://workmux.dev/guide/installation/
Locator: Bash/Homebrew/Cargo/mise/Nix methods; Shell alias; Completions; Uninstalling
Finding: Install via install script, Homebrew (macOS/Linux), Cargo, mise, Nix, or prebuilt binaries; shell completions for bash/zsh/fish; uninstall script removes data dirs; no account, signup, or payment step.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/dashboard/
Locator: Setup; Agents/Worktrees views; Keybindings; Columns; Live preview; Input mode; Sort modes; Sweep
Finding: Optional TUI popup (tmux display-popup binding) requiring status hooks; Agents view (status, git info, PR checks, live preview) and Worktrees view; input mode sends keystrokes to agent; keys jump/diff/commit/merge/kill/remove/sweep; sort by priority/project/recency; sweep bulk-removes merged/gone worktrees.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/sandbox/
Locator: Security model; Agent permission prompts; Container/Lima backends; Threat model
Finding: Container (Docker/Podman/Apple Container) and Lima VM backends isolate agents from host secrets; sandboxed agents get noninteractive prompts with sandbox as boundary; status/dashboard/merge work the same via RPC bridge; documented limits: edits untrusted, host git ops and hooks outside boundary, no hostile-code-containment promise.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/setup/
Locator: Requirements; Server or Docker; Install and check; Supplemental files; Security
Finding: Requires Linux x86-64/ARM64, promptless SSH, git, tmux 3.3+, systemd linger, API access; host mode (no sandbox) vs Docker mode per sandbox.enabled/isolation; server never talks to Git hosting and gets no origin; remote_files allowlist (64 MiB cap); no host-command proxying on servers.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/logins/
Locator: Per-agent login table; Copy logins; Claude long-lived token; Environment variables
Finding: remote login runs each agent native login flow (claude/codex/gemini/opencode/pi/omp) with localhost port forwarding; --import does a one-time credential copy (with rotation caveats); setup-token for Claude; sandbox env passthrough read once per workspace and stored privately on server.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/
Locator: Commands overview table
Finding: Command reference inventory: 24 documented command pages (add merge rebase remove rename list status open close resurrect sync-files path shell dashboard sidebar reap-agents config edit init claude prune sandbox remote completions docs update last-done) plus additional CLI-only commands (setup, send, wait, capture, run); no REST API, SDK, MCP server, webhook, or scheduling commands appear in the reference or full docs.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/list/
Locator: Options; Example output; Key; Remote workspaces
Finding: Lists worktrees with AGE, AGENT status icons (incl. counts, text labels when piped), MUX window presence, UNMERGED marker; --pr shows PR status (gh); --json output; remote workspaces listed with remote name, last-known state, and exited reasons such as host reboot.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/status/
Locator: Options; JSON output schema
Finding: Reports tracked agents per repository (or --all/project:handle); --json emits observation with backend context, state-file reconciliation counts, per-agent worktree/branch/status/elapsed/title/pane/git, and target_errors with stable codes.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/remote/
Locator: remote/setup/doctor/login reference
Finding: remote lists servers and placement default; setup installs matching node + status hooks; doctor runs 10 checks (ssh/arch/node/git/tmux/linger/mode/hooks/logins/image) with fixes; login runs native agent flows with --import/--setup-token options.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/skills/coordinator/SKILL.md
Locator: Core Concepts; Command Reference (Spawn/Monitor/Wait/Capture); Cross-project targeting
Finding: Coordinator agent uses workmux add/status/send/capture/wait/run; write-prompts-first-then-spawn; workmux wait with --timeout/--any and exit codes 0/1/2/3; continuous-monitoring invariant across interruptions; cross-project project:handle targeting.
Retrieved: 2026-11-12

## workmux:ACC-06

Finding: Agents extend via six product-shipped skills and status plugins; integrations are product-managed through workmux setup with scoped credential mounts. workmux itself consumes no MCP and brokers no third-party OAuth.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-12-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

MCP consumption belongs to the underlying harness; workmux only mounts agent MCP config into sandboxes.
Permission scoping is via sandbox mounts, global-only agent definitions, and agent prompts rather than a product permission matrix.

Source: https://workmux.dev/guide/configuration/
Locator: Two-level system; Remotes; placement; Panes and agent placeholders; File operations; Lifecycle hooks
Finding: Global ~/.config/workmux/config.yaml plus per-project .workmux.yaml; remotes and named agents are global-only; placement selects local or a named remote; panes support <agent> placeholders, splits, sizes; files copy/symlink; post_create/pre_merge/pre_remove hooks.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/agents/
Locator: Agent integration; Named agents; Per-pane agents; Parallel workflows
Finding: Built-in agents: claude, codex, copilot, opencode, gemini, agy, kiro-cli, vibe, pi, omp, grok; prompt injection via -p/-P/-e without config changes; named global profiles with type/command/args/env (incl. from_env); multi-worktree generation (-a/-n/--foreach) e.g. one worktree each for claude and gemini.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/status-tracking/
Locator: Agent support table; Status icons; Automated setup; Pi subagents; Interrupted detection; last-done/last-agent
Finding: Supported: Claude Code, OpenCode, Codex, Copilot CLI, Pi, Oh My Pi, Gemini CLI, Grok, Antigravity agy (with version/capability footnotes); Kiro and Mistral Vibe are tracking-issues only; icons working/waiting/done; workmux setup installs hooks; last-done/last-agent navigation; nested-agent opt-out via WORKMUX_DISABLE_SET_WINDOW_STATUS=1.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/sandbox/
Locator: Security model; Agent permission prompts; Container/Lima backends; Threat model
Finding: Container (Docker/Podman/Apple Container) and Lima VM backends isolate agents from host secrets; sandboxed agents get noninteractive prompts with sandbox as boundary; status/dashboard/merge work the same via RPC bridge; documented limits: edits untrusted, host git ops and hooks outside boundary, no hostile-code-containment promise.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/logins/
Locator: Per-agent login table; Copy logins; Claude long-lived token; Environment variables
Finding: remote login runs each agent native login flow (claude/codex/gemini/opencode/pi/omp) with localhost port forwarding; --import does a one-time credential copy (with rotation caveats); setup-token for Claude; sandbox env passthrough read once per workspace and stored privately on server.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/skills/
Locator: Installation; /workmux /merge /rebase /worktree /coordinator /open-pr
Finding: Six product-shipped skills; workmux setup --skills installs to Claude/OpenCode/Pi/OMP dirs (manual copy documented); dashboard m keybinding triggers /merge; /merge commits/rebases/merges with conflict review; /worktree delegates with --fork option; /coordinator manages full lifecycle.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/workflows/
Locator: From terminal; From agent session; Forking; Coordinating; Direct merge; PR-based
Finding: add -A auto-names from prompt; /worktree spins off from running agents; --fork resumes conversations (Claude/Codex/Pi); /coordinator plans+delegates+merges; /merge for direct merge; /open-pr + git push + gh pr create then workmux remove/--gone for PR flow.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/
Locator: Commands overview table
Finding: Command reference inventory: 24 documented command pages (add merge rebase remove rename list status open close resurrect sync-files path shell dashboard sidebar reap-agents config edit init claude prune sandbox remote completions docs update last-done) plus additional CLI-only commands (setup, send, wait, capture, run); no REST API, SDK, MCP server, webhook, or scheduling commands appear in the reference or full docs.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/skills/coordinator/SKILL.md
Locator: Core Concepts; Command Reference (Spawn/Monitor/Wait/Capture); Cross-project targeting
Finding: Coordinator agent uses workmux add/status/send/capture/wait/run; write-prompts-first-then-spawn; workmux wait with --timeout/--any and exit codes 0/1/2/3; continuous-monitoring invariant across interruptions; cross-project project:handle targeting.
Retrieved: 2026-11-12

## workmux:ACC-07

Finding: Rust CLI/TUI binary (Cargo, edition 2024) with prebuilt macOS/Linux binaries; no Electron/Tauri/native-GUI or mobile clients.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2027-02-10
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

No desktop GUI or mobile clients exist; the client is the terminal binary plus tmux/sidebar/dashboard surfaces.

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/Cargo.toml
Locator: package name/version/edition/license/documentation fields
Finding: Rust binary crate name workmux, version 0.1.282, edition 2024, license MIT; homepage and repository point at github.com/raine/workmux.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/installation/
Locator: Bash/Homebrew/Cargo/mise/Nix methods; Shell alias; Completions; Uninstalling
Finding: Install via install script, Homebrew (macOS/Linux), Cargo, mise, Nix, or prebuilt binaries; shell completions for bash/zsh/fish; uninstall script removes data dirs; no account, signup, or payment step.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/update/
Locator: Supported platforms; Automatic update check; Requirements
Finding: Prebuilt binaries for macOS (Apple Silicon/Intel) and Linux (x86_64/ARM64); background update check at most daily, disableable via auto_update_check:false or WORKMUX_NO_UPDATE_CHECK=1; update verifies checksums, Homebrew installs defer to brew.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/kitty/
Locator: Experimental; Differences from tmux; Requirements
Finding: Experimental kitty backend (remote-control API, Unix socket); Unix-like OS with named pipes required; Windows is not supported.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/zellij/
Locator: Experimental; Differences from tmux; Sidebar; Requirements
Finding: Experimental Zellij backend requiring 0.44.1+; operates in current session; window-mode only; no dashboard preview (dump-screen covers focused pane only); sidebar supported; Windows is not supported.
Retrieved: 2026-11-12

## workmux:PLAN-01

Finding: Local creation via add with prompt intake; PR/MR branch checkout (not issue import); git branches are the source of truth with branch-derived handles; PR awareness is read-only with remote cleanup.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-12-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

No Linear/Jira-style issue import or two-way sync: external import is branch checkout only.
No product-level plan editors; supported edits happen in git or the hosting UI.

Source: https://workmux.dev/guide/quick-start/
Locator: Prerequisites; steps 1-5; The parallel AI workflow
Finding: Prerequisites: Git 2.5+ and tmux (or WezTerm/kitty/Zellij); flow is install, optional workmux init, workmux add (creates worktree + window + panes + setup), work, workmux merge cleanup; /worktree skill recommended from inside agent sessions.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/configuration/
Locator: Two-level system; Remotes; placement; Panes and agent placeholders; File operations; Lifecycle hooks
Finding: Global ~/.config/workmux/config.yaml plus per-project .workmux.yaml; remotes and named agents are global-only; placement selects local or a named remote; panes support <agent> placeholders, splits, sizes; files copy/symlink; post_create/pre_merge/pre_remove hooks.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/agents/
Locator: Agent integration; Named agents; Per-pane agents; Parallel workflows
Finding: Built-in agents: claude, codex, copilot, opencode, gemini, agy, kiro-cli, vibe, pi, omp, grok; prompt injection via -p/-P/-e without config changes; named global profiles with type/command/args/env (incl. from_env); multi-worktree generation (-a/-n/--foreach) e.g. one worktree each for claude and gemini.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/dashboard/
Locator: Setup; Agents/Worktrees views; Keybindings; Columns; Live preview; Input mode; Sort modes; Sweep
Finding: Optional TUI popup (tmux display-popup binding) requiring status hooks; Agents view (status, git info, PR checks, live preview) and Worktrees view; input mode sends keystrokes to agent; keys jump/diff/commit/merge/kill/remove/sweep; sort by priority/project/recency; sweep bulk-removes merged/gone worktrees.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/
Locator: Overview (Experimental); How it fits together; Quick start
Finding: Experimental: run agents on user-reachable Linux servers over SSH; each remote agent keeps a local tmux window and appears in dashboard/sidebar/status/list as handle@remote; agent keeps working while local machine sleeps, loses network, or closes the window; window reconnects by itself; workmux merge brings work home; local machine stays Git source of truth.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/skills/
Locator: Installation; /workmux /merge /rebase /worktree /coordinator /open-pr
Finding: Six product-shipped skills; workmux setup --skills installs to Claude/OpenCode/Pi/OMP dirs (manual copy documented); dashboard m keybinding triggers /merge; /merge commits/rebases/merges with conflict review; /worktree delegates with --fork option; /coordinator manages full lifecycle.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/workflows/
Locator: From terminal; From agent session; Forking; Coordinating; Direct merge; PR-based
Finding: add -A auto-names from prompt; /worktree spins off from running agents; --fork resumes conversations (Claude/Codex/Pi); /coordinator plans+delegates+merges; /merge for direct merge; /open-pr + git push + gh pr create then workmux remove/--gone for PR flow.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/add/
Locator: Arguments; Options table
Finding: Creates worktree + multiplexer window; --pr checks out GitHub PRs (gh) or GitLab MRs (glab 1.37+, --forge); -A auto-name via llm CLI; --fork/--continue resume; -n/--foreach/--agent multi-generation; -l layouts; --remote/--local placement; -b background; --with-changes moves uncommitted work.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/merge/
Locator: When to use merge vs remove; Options; Merge strategies; What happens
Finding: Local git merge into main (or --into) with merge/rebase/squash strategies plus worktree+window+branch cleanup; --keep/merge_keep; --notification system notification; PR workflows merge remotely and use remove for cleanup instead.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/list/
Locator: Options; Example output; Key; Remote workspaces
Finding: Lists worktrees with AGE, AGENT status icons (incl. counts, text labels when piped), MUX window presence, UNMERGED marker; --pr shows PR status (gh); --json output; remote workspaces listed with remote name, last-known state, and exited reasons such as host reboot.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/skills/coordinator/SKILL.md
Locator: Core Concepts; Command Reference (Spawn/Monitor/Wait/Capture); Cross-project targeting
Finding: Coordinator agent uses workmux add/status/send/capture/wait/run; write-prompts-first-then-spawn; workmux wait with --timeout/--any and exit codes 0/1/2/3; continuous-monitoring invariant across interruptions; cross-project project:handle targeting.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/skills/open-pr/SKILL.md
Locator: Gather context; Write PR description; Create the PR
Finding: Template skill that drafts PR description from diff/commits and runs gh pr create --web to open creation in the browser; explicitly does not create the PR directly.
Retrieved: 2026-11-12

## workmux:PLAN-02

Finding: Durable task plans do not exist in the pinned release: prompts are one-shot launch briefs written to git-excluded `.workmux/PROMPT-<branch>.md` files (prompt.rs, prompt_loader.rs, setup.rs); the state store keeps pane-level status only (state/types.rs); dashboard/sidebar show agents and worktrees, not plans. Bounded inspection of raine/workmux at e72fd59 (homebrew-workmux tap holds packaging only) for plan/acceptance/revision/spec found no plan objects, editors, revision history, or implementation links.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2027-03-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12



Source: https://workmux.dev/reference/commands/
Locator: Commands overview table
Finding: Command reference inventory: 24 documented command pages (add merge rebase remove rename list status open close resurrect sync-files path shell dashboard sidebar reap-agents config edit init claude prune sandbox remote completions docs update last-done) plus additional CLI-only commands (setup, send, wait, capture, run); no REST API, SDK, MCP server, webhook, or scheduling commands appear in the reference or full docs.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/list/
Locator: Options; Example output; Key; Remote workspaces
Finding: Lists worktrees with AGE, AGENT status icons (incl. counts, text labels when piped), MUX window presence, UNMERGED marker; --pr shows PR status (gh); --json output; remote workspaces listed with remote name, last-known state, and exited reasons such as host reboot.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/src/workflow/setup.rs
Locator: setup.rs write_prompt_file/prompt_file_name; prompt.rs Prompt/PromptMetadata; state/types.rs AgentState; dashboard/sidebar views
Finding: Bounded inspection of raine/workmux at e72fd59 (homebrew-workmux tap holds packaging only, no product code): prompts are one-shot launch briefs written to git-excluded .workmux/PROMPT-<branch>.md (setup.rs write_prompt_file); prompt frontmatter parses only a foreach matrix (prompt.rs PromptMetadata); the state store keeps pane-level status/activity timestamps only (state/types.rs AgentState); dashboard/sidebar list agents and worktrees, not plans. Searched plan/acceptance/revision/spec across src/, skills/, docs/: no plan objects, acceptance criteria, editors, revision history, or implementation links.
Retrieved: 2026-11-12

## workmux:PLAN-03

Finding: Hierarchy machinery does not exist in the pinned release: work is flat branches/worktrees; `merge --into` merges into any base branch (stacked git branches, not a product hierarchy); the state store has no parent/child/blocker/dependency fields; pre_merge/pre_remove are shell lifecycle gates; coordinator merge ordering is an agent prompt convention. Bounded inspection of raine/workmux at e72fd59 for epic/hierarchy/blocker/depend/readiness found no epics, blockers, readiness gates, dependency enforcement, or mandatory workflows.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2027-03-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12



Source: https://workmux.dev/guide/configuration/
Locator: Two-level system; Remotes; placement; Panes and agent placeholders; File operations; Lifecycle hooks
Finding: Global ~/.config/workmux/config.yaml plus per-project .workmux.yaml; remotes and named agents are global-only; placement selects local or a named remote; panes support <agent> placeholders, splits, sizes; files copy/symlink; post_create/pre_merge/pre_remove hooks.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/status-tracking/
Locator: Agent support table; Status icons; Automated setup; Pi subagents; Interrupted detection; last-done/last-agent
Finding: Supported: Claude Code, OpenCode, Codex, Copilot CLI, Pi, Oh My Pi, Gemini CLI, Grok, Antigravity agy (with version/capability footnotes); Kiro and Mistral Vibe are tracking-issues only; icons working/waiting/done; workmux setup installs hooks; last-done/last-agent navigation; nested-agent opt-out via WORKMUX_DISABLE_SET_WINDOW_STATUS=1.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/
Locator: Commands overview table
Finding: Command reference inventory: 24 documented command pages (add merge rebase remove rename list status open close resurrect sync-files path shell dashboard sidebar reap-agents config edit init claude prune sandbox remote completions docs update last-done) plus additional CLI-only commands (setup, send, wait, capture, run); no REST API, SDK, MCP server, webhook, or scheduling commands appear in the reference or full docs.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/add/
Locator: Arguments; Options table
Finding: Creates worktree + multiplexer window; --pr checks out GitHub PRs (gh) or GitLab MRs (glab 1.37+, --forge); -A auto-name via llm CLI; --fork/--continue resume; -n/--foreach/--agent multi-generation; -l layouts; --remote/--local placement; -b background; --with-changes moves uncommitted work.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/merge/
Locator: When to use merge vs remove; Options; Merge strategies; What happens
Finding: Local git merge into main (or --into) with merge/rebase/squash strategies plus worktree+window+branch cleanup; --keep/merge_keep; --notification system notification; PR workflows merge remotely and use remove for cleanup instead.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/list/
Locator: Options; Example output; Key; Remote workspaces
Finding: Lists worktrees with AGE, AGENT status icons (incl. counts, text labels when piped), MUX window presence, UNMERGED marker; --pr shows PR status (gh); --json output; remote workspaces listed with remote name, last-known state, and exited reasons such as host reboot.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/skills/coordinator/SKILL.md
Locator: Core Concepts; Command Reference (Spawn/Monitor/Wait/Capture); Cross-project targeting
Finding: Coordinator agent uses workmux add/status/send/capture/wait/run; write-prompts-first-then-spawn; workmux wait with --timeout/--any and exit codes 0/1/2/3; continuous-monitoring invariant across interruptions; cross-project project:handle targeting.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/src/workflow/merge.rs
Locator: merge.rs merge()/MergeConflict; command/merge.rs --into; state/types.rs AgentState; config.rs pre_merge/pre_remove; skills/coordinator/SKILL.md
Finding: raine/workmux at e72fd59: merge --into targets any base branch (stacked git branches, not a product hierarchy); the state store is flat per-pane records with no parent/child/blocker/dependency fields; pre_merge/pre_remove are shell lifecycle gates, not dependency enforcement; coordinator merge ordering is an agent prompt convention (SKILL.md); multiplexer readiness is a shell-handshake wait (handshake.rs), not dispatch gating. Searched epic/hierarchy/blocker/depend/readiness/enforce across src/, skills/, docs/: no epics, blockers, readiness gates, dependency enforcement, state propagation, or mandatory workflows.
Retrieved: 2026-11-12

## workmux:PLAN-04

Finding: Shared context and memory do not exist as a product surface in the pinned release: named-agent config and per-worktree PROMPT briefs are launch inputs, not a managed store; the config schema has no memory keys; the 6 bundled skills are static prompt files; sandbox and file seeding only mount or copy files. Bounded inspection of raine/workmux at e72fd59 for memory/instruction/provenance/retriev/index found no memory store and no scope, provenance, correction, deletion, or freshness controls.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2027-03-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12



Source: https://workmux.dev/guide/configuration/
Locator: Two-level system; Remotes; placement; Panes and agent placeholders; File operations; Lifecycle hooks
Finding: Global ~/.config/workmux/config.yaml plus per-project .workmux.yaml; remotes and named agents are global-only; placement selects local or a named remote; panes support <agent> placeholders, splits, sizes; files copy/symlink; post_create/pre_merge/pre_remove hooks.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/skills/
Locator: Installation; /workmux /merge /rebase /worktree /coordinator /open-pr
Finding: Six product-shipped skills; workmux setup --skills installs to Claude/OpenCode/Pi/OMP dirs (manual copy documented); dashboard m keybinding triggers /merge; /merge commits/rebases/merges with conflict review; /worktree delegates with --fork option; /coordinator manages full lifecycle.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/workflows/
Locator: From terminal; From agent session; Forking; Coordinating; Direct merge; PR-based
Finding: add -A auto-names from prompt; /worktree spins off from running agents; --fork resumes conversations (Claude/Codex/Pi); /coordinator plans+delegates+merges; /merge for direct merge; /open-pr + git push + gh pr create then workmux remove/--gone for PR flow.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/skills/coordinator/SKILL.md
Locator: Core Concepts; Command Reference (Spawn/Monitor/Wait/Capture); Cross-project targeting
Finding: Coordinator agent uses workmux add/status/send/capture/wait/run; write-prompts-first-then-spawn; workmux wait with --timeout/--any and exit codes 0/1/2/3; continuous-monitoring invariant across interruptions; cross-project project:handle targeting.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/src/config.rs
Locator: config.rs full key inventory; skills.rs BUNDLED_SKILLS; sandbox credential mounts; workflow/file_ops.rs copy/symlink seeding
Finding: raine/workmux at e72fd59: the config schema holds named agents, remotes, hooks, layouts, and status icons with no memory/instruction/role keys (the only `memory` is Lima VM RAM); the 6 bundled skills are static prompt files installed to agent directories (skills.rs), not a managed store; sandbox mounts and file_ops only mount or seed credential, config, and prompt files. Searched memory/instruction/provenance/retriev/index across src/, skills/, docs/: no managed memory store and no scope, provenance, correction, deletion, or freshness controls.
Retrieved: 2026-11-12

## workmux:PLAN-05

Finding: Architecture and API awareness do not exist as a product surface in the pinned release: the only built-in model call generates branch names (llm.rs); dashboard/sidebar filters match agent/worktree names; list columns carry git/status data only. Bounded inspection of raine/workmux at e72fd59 for search/index/retriev/citation/conflict/semantic found no code search, indexing, external-knowledge retrieval, citations, conflict detection, or review-time enforcement; those belong to the launched harnesses.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2027-03-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12



Source: https://workmux.dev/guide/configuration/
Locator: Two-level system; Remotes; placement; Panes and agent placeholders; File operations; Lifecycle hooks
Finding: Global ~/.config/workmux/config.yaml plus per-project .workmux.yaml; remotes and named agents are global-only; placement selects local or a named remote; panes support <agent> placeholders, splits, sizes; files copy/symlink; post_create/pre_merge/pre_remove hooks.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/sandbox/
Locator: Security model; Agent permission prompts; Container/Lima backends; Threat model
Finding: Container (Docker/Podman/Apple Container) and Lima VM backends isolate agents from host secrets; sandboxed agents get noninteractive prompts with sandbox as boundary; status/dashboard/merge work the same via RPC bridge; documented limits: edits untrusted, host git ops and hooks outside boundary, no hostile-code-containment promise.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/setup/
Locator: Requirements; Server or Docker; Install and check; Supplemental files; Security
Finding: Requires Linux x86-64/ARM64, promptless SSH, git, tmux 3.3+, systemd linger, API access; host mode (no sandbox) vs Docker mode per sandbox.enabled/isolation; server never talks to Git hosting and gets no origin; remote_files allowlist (64 MiB cap); no host-command proxying on servers.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/skills/
Locator: Installation; /workmux /merge /rebase /worktree /coordinator /open-pr
Finding: Six product-shipped skills; workmux setup --skills installs to Claude/OpenCode/Pi/OMP dirs (manual copy documented); dashboard m keybinding triggers /merge; /merge commits/rebases/merges with conflict review; /worktree delegates with --fork option; /coordinator manages full lifecycle.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/src/llm.rs
Locator: llm.rs generate_branch_name; dashboard/sidebar name filters; command/list.rs WorktreeRow columns
Finding: raine/workmux at e72fd59: the only built-in model call generates kebab-case git branch names (llm.rs generate_branch_name); dashboard/sidebar filters match agent/worktree names only; list columns are PROJECT/BRANCH/AGE/PR/AGENT/MUX/UNMERGED/PATH (git/status data). Searched search/index/retriev/citation/conflict/semantic/embed across src/, skills/, docs/: no product code search, repository indexing, external-knowledge retrieval, citations, conflict detection, or review-time enforcement; those belong to the launched harnesses.
Retrieved: 2026-11-12

## workmux:PLAN-06

Finding: No issue objects exist: tracking is branch/worktree-based. Worktrees persist independently of windows, carry branch/age/status metadata, and need no external tracker; idea parking, discussion, and prioritization are absent.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-12-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

Workmux tracks worktrees/branches, not issues: no create/edit/discuss/prioritize/label/assign/search/filter/archive/reopen semantics.
Findings rest on the CLI command inventory and docs; no hands-on fixture was run.

Source: https://workmux.dev/guide/status-tracking/
Locator: Agent support table; Status icons; Automated setup; Pi subagents; Interrupted detection; last-done/last-agent
Finding: Supported: Claude Code, OpenCode, Codex, Copilot CLI, Pi, Oh My Pi, Gemini CLI, Grok, Antigravity agy (with version/capability footnotes); Kiro and Mistral Vibe are tracking-issues only; icons working/waiting/done; workmux setup installs hooks; last-done/last-agent navigation; nested-agent opt-out via WORKMUX_DISABLE_SET_WINDOW_STATUS=1.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/dashboard/
Locator: Setup; Agents/Worktrees views; Keybindings; Columns; Live preview; Input mode; Sort modes; Sweep
Finding: Optional TUI popup (tmux display-popup binding) requiring status hooks; Agents view (status, git info, PR checks, live preview) and Worktrees view; input mode sends keystrokes to agent; keys jump/diff/commit/merge/kill/remove/sweep; sort by priority/project/recency; sweep bulk-removes merged/gone worktrees.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/workflows/
Locator: From terminal; From agent session; Forking; Coordinating; Direct merge; PR-based
Finding: add -A auto-names from prompt; /worktree spins off from running agents; --fork resumes conversations (Claude/Codex/Pi); /coordinator plans+delegates+merges; /merge for direct merge; /open-pr + git push + gh pr create then workmux remove/--gone for PR flow.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/
Locator: Commands overview table
Finding: Command reference inventory: 24 documented command pages (add merge rebase remove rename list status open close resurrect sync-files path shell dashboard sidebar reap-agents config edit init claude prune sandbox remote completions docs update last-done) plus additional CLI-only commands (setup, send, wait, capture, run); no REST API, SDK, MCP server, webhook, or scheduling commands appear in the reference or full docs.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/add/
Locator: Arguments; Options table
Finding: Creates worktree + multiplexer window; --pr checks out GitHub PRs (gh) or GitLab MRs (glab 1.37+, --forge); -A auto-name via llm CLI; --fork/--continue resume; -n/--foreach/--agent multi-generation; -l layouts; --remote/--local placement; -b background; --with-changes moves uncommitted work.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/merge/
Locator: When to use merge vs remove; Options; Merge strategies; What happens
Finding: Local git merge into main (or --into) with merge/rebase/squash strategies plus worktree+window+branch cleanup; --keep/merge_keep; --notification system notification; PR workflows merge remotely and use remove for cleanup instead.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/list/
Locator: Options; Example output; Key; Remote workspaces
Finding: Lists worktrees with AGE, AGENT status icons (incl. counts, text labels when piped), MUX window presence, UNMERGED marker; --pr shows PR status (gh); --json output; remote workspaces listed with remote name, last-known state, and exited reasons such as host reboot.
Retrieved: 2026-11-12

## workmux:PLAN-07

Finding: Agents operate shared worktree handles through documented CLI ops (add/status/send/capture/wait/run) taught by product skills; human dashboard/sidebar/list views reflect agent-created work. No issue field model, claims, attribution, or conflict handling.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-12-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

Handles are branch names, not issue records: no field edits, claims, assignment, or conflict semantics.
Agent CLI surface (send/capture/wait/run) is documented in the skill, not the CLI reference; no hands-on verification here.

Source: https://workmux.dev/guide/status-tracking/
Locator: Agent support table; Status icons; Automated setup; Pi subagents; Interrupted detection; last-done/last-agent
Finding: Supported: Claude Code, OpenCode, Codex, Copilot CLI, Pi, Oh My Pi, Gemini CLI, Grok, Antigravity agy (with version/capability footnotes); Kiro and Mistral Vibe are tracking-issues only; icons working/waiting/done; workmux setup installs hooks; last-done/last-agent navigation; nested-agent opt-out via WORKMUX_DISABLE_SET_WINDOW_STATUS=1.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/dashboard/
Locator: Setup; Agents/Worktrees views; Keybindings; Columns; Live preview; Input mode; Sort modes; Sweep
Finding: Optional TUI popup (tmux display-popup binding) requiring status hooks; Agents view (status, git info, PR checks, live preview) and Worktrees view; input mode sends keystrokes to agent; keys jump/diff/commit/merge/kill/remove/sweep; sort by priority/project/recency; sweep bulk-removes merged/gone worktrees.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/sidebar/
Locator: Setup; What it shows; Layouts; Sleeping agents; Session filter; Views
Finding: Always-visible agent overview pinned to tmux windows (or Zellij tabs): per-agent tile with status icon, worktree, elapsed time, project, git diff stats, optional PR number/checks, task description; toggle via workmux sidebar; session scoping and named views; requires status hooks.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/sandbox/
Locator: Security model; Agent permission prompts; Container/Lima backends; Threat model
Finding: Container (Docker/Podman/Apple Container) and Lima VM backends isolate agents from host secrets; sandboxed agents get noninteractive prompts with sandbox as boundary; status/dashboard/merge work the same via RPC bridge; documented limits: edits untrusted, host git ops and hooks outside boundary, no hostile-code-containment promise.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/setup/
Locator: Requirements; Server or Docker; Install and check; Supplemental files; Security
Finding: Requires Linux x86-64/ARM64, promptless SSH, git, tmux 3.3+, systemd linger, API access; host mode (no sandbox) vs Docker mode per sandbox.enabled/isolation; server never talks to Git hosting and gets no origin; remote_files allowlist (64 MiB cap); no host-command proxying on servers.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/skills/
Locator: Installation; /workmux /merge /rebase /worktree /coordinator /open-pr
Finding: Six product-shipped skills; workmux setup --skills installs to Claude/OpenCode/Pi/OMP dirs (manual copy documented); dashboard m keybinding triggers /merge; /merge commits/rebases/merges with conflict review; /worktree delegates with --fork option; /coordinator manages full lifecycle.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/workflows/
Locator: From terminal; From agent session; Forking; Coordinating; Direct merge; PR-based
Finding: add -A auto-names from prompt; /worktree spins off from running agents; --fork resumes conversations (Claude/Codex/Pi); /coordinator plans+delegates+merges; /merge for direct merge; /open-pr + git push + gh pr create then workmux remove/--gone for PR flow.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/list/
Locator: Options; Example output; Key; Remote workspaces
Finding: Lists worktrees with AGE, AGENT status icons (incl. counts, text labels when piped), MUX window presence, UNMERGED marker; --pr shows PR status (gh); --json output; remote workspaces listed with remote name, last-known state, and exited reasons such as host reboot.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/status/
Locator: Options; JSON output schema
Finding: Reports tracked agents per repository (or --all/project:handle); --json emits observation with backend context, state-file reconciliation counts, per-agent worktree/branch/status/elapsed/title/pane/git, and target_errors with stable codes.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/skills/coordinator/SKILL.md
Locator: Core Concepts; Command Reference (Spawn/Monitor/Wait/Capture); Cross-project targeting
Finding: Coordinator agent uses workmux add/status/send/capture/wait/run; write-prompts-first-then-spawn; workmux wait with --timeout/--any and exit codes 0/1/2/3; continuous-monitoring invariant across interruptions; cross-project project:handle targeting.
Retrieved: 2026-11-12

## workmux:PLAN-08

Finding: Living product specifications do not exist in the pinned release: PROMPT briefs are per-task launch files with no cross-task persistence, revisions, approvals, retrieval, or drift detection; the state store and dashboard hold no requirement objects. Bounded inspection of raine/workmux at e72fd59 for spec/requirement/persistent/approval/drift found no product-spec surface.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2027-03-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12



Source: https://workmux.dev/guide/dashboard/
Locator: Setup; Agents/Worktrees views; Keybindings; Columns; Live preview; Input mode; Sort modes; Sweep
Finding: Optional TUI popup (tmux display-popup binding) requiring status hooks; Agents view (status, git info, PR checks, live preview) and Worktrees view; input mode sends keystrokes to agent; keys jump/diff/commit/merge/kill/remove/sweep; sort by priority/project/recency; sweep bulk-removes merged/gone worktrees.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/skills/
Locator: Installation; /workmux /merge /rebase /worktree /coordinator /open-pr
Finding: Six product-shipped skills; workmux setup --skills installs to Claude/OpenCode/Pi/OMP dirs (manual copy documented); dashboard m keybinding triggers /merge; /merge commits/rebases/merges with conflict review; /worktree delegates with --fork option; /coordinator manages full lifecycle.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/workflows/
Locator: From terminal; From agent session; Forking; Coordinating; Direct merge; PR-based
Finding: add -A auto-names from prompt; /worktree spins off from running agents; --fork resumes conversations (Claude/Codex/Pi); /coordinator plans+delegates+merges; /merge for direct merge; /open-pr + git push + gh pr create then workmux remove/--gone for PR flow.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/add/
Locator: Arguments; Options table
Finding: Creates worktree + multiplexer window; --pr checks out GitHub PRs (gh) or GitLab MRs (glab 1.37+, --forge); -A auto-name via llm CLI; --fork/--continue resume; -n/--foreach/--agent multi-generation; -l layouts; --remote/--local placement; -b background; --with-changes moves uncommitted work.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/list/
Locator: Options; Example output; Key; Remote workspaces
Finding: Lists worktrees with AGE, AGENT status icons (incl. counts, text labels when piped), MUX window presence, UNMERGED marker; --pr shows PR status (gh); --json output; remote workspaces listed with remote name, last-known state, and exited reasons such as host reboot.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/skills/worktree/SKILL.md
Locator: skills/worktree/SKILL.md dispatcher flow; setup.rs write_prompt_file; state/types.rs; dashboard views
Finding: raine/workmux at e72fd59: the /worktree skill dispatches by writing a per-task brief and running `workmux add`; the brief persists only as a git-excluded file in its worktree with no cross-task store, revisions, approvals, retrieval, or drift detection; the state store and dashboard hold no requirement objects. Searched spec/requirement/persistent/approval/drift across src/, skills/, docs/: no living product specification surface.
Retrieved: 2026-11-12

## workmux:COORD-01

Finding: Independent agents run concurrently, each in its own worktree and multiplexer window/session; --max-concurrent bounds worker pools; running/waiting/failed/finished visible across dashboard, sidebar, list, and status.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-12-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

Concurrency is documented, not observed: no multi-agent run was executed in this pass.
No documented CPU/RAM quotas; throttling is count-based only.

Source: https://raw.githubusercontent.com/raine/workmux/main/README.md
Locator: Why workmux; Features; Installation; Community videos
Finding: Manages git worktrees + tmux windows for parallel AI agents; features dashboard, sidebar, /worktree skill, agent status tracking, sandbox, remote servers, branch-name generation; install via script/Homebrew/Cargo/mise/Nix; philosophy "tmux is the interface".
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/agents/
Locator: Agent integration; Named agents; Per-pane agents; Parallel workflows
Finding: Built-in agents: claude, codex, copilot, opencode, gemini, agy, kiro-cli, vibe, pi, omp, grok; prompt injection via -p/-P/-e without config changes; named global profiles with type/command/args/env (incl. from_env); multi-worktree generation (-a/-n/--foreach) e.g. one worktree each for claude and gemini.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/dashboard/
Locator: Setup; Agents/Worktrees views; Keybindings; Columns; Live preview; Input mode; Sort modes; Sweep
Finding: Optional TUI popup (tmux display-popup binding) requiring status hooks; Agents view (status, git info, PR checks, live preview) and Worktrees view; input mode sends keystrokes to agent; keys jump/diff/commit/merge/kill/remove/sweep; sort by priority/project/recency; sweep bulk-removes merged/gone worktrees.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/sidebar/
Locator: Setup; What it shows; Layouts; Sleeping agents; Session filter; Views
Finding: Always-visible agent overview pinned to tmux windows (or Zellij tabs): per-agent tile with status icon, worktree, elapsed time, project, git diff stats, optional PR number/checks, task description; toggle via workmux sidebar; session scoping and named views; requires status hooks.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/add/
Locator: Arguments; Options table
Finding: Creates worktree + multiplexer window; --pr checks out GitHub PRs (gh) or GitLab MRs (glab 1.37+, --forge); -A auto-name via llm CLI; --fork/--continue resume; -n/--foreach/--agent multi-generation; -l layouts; --remote/--local placement; -b background; --with-changes moves uncommitted work.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/list/
Locator: Options; Example output; Key; Remote workspaces
Finding: Lists worktrees with AGE, AGENT status icons (incl. counts, text labels when piped), MUX window presence, UNMERGED marker; --pr shows PR status (gh); --json output; remote workspaces listed with remote name, last-known state, and exited reasons such as host reboot.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/status/
Locator: Options; JSON output schema
Finding: Reports tracked agents per repository (or --all/project:handle); --json emits observation with backend context, state-file reconciliation counts, per-agent worktree/branch/status/elapsed/title/pane/git, and target_errors with stable codes.
Retrieved: 2026-11-12

Source: https://workmux.dev/changelog/
Locator: v0.1.282 through v0.1.1 entries with dates
Finding: Latest v0.1.282 (2026-11-10); near-weekly releases through 2026; recent additions: remote servers (v0.1.278), branch auto-name, coordinator commands, Zellij sidebar, Copilot/Grok/agy support; entries describe shipped releases only, no future-dated commitments found.
Retrieved: 2026-11-12

## workmux:COORD-02

Finding: Agents are placed per worktree with local/remote routing and worker-pool throttling; coordinator agents delegate via skills. No human assignment, claims, queues UI, or duplicate-work prevention.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-12-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

Single-user tool: no human assignment or membership.
Duplicate claims on the same task have no documented prevention; conflicts guidance is advisory.

Source: https://workmux.dev/guide/configuration/
Locator: Two-level system; Remotes; placement; Panes and agent placeholders; File operations; Lifecycle hooks
Finding: Global ~/.config/workmux/config.yaml plus per-project .workmux.yaml; remotes and named agents are global-only; placement selects local or a named remote; panes support <agent> placeholders, splits, sizes; files copy/symlink; post_create/pre_merge/pre_remove hooks.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/agents/
Locator: Agent integration; Named agents; Per-pane agents; Parallel workflows
Finding: Built-in agents: claude, codex, copilot, opencode, gemini, agy, kiro-cli, vibe, pi, omp, grok; prompt injection via -p/-P/-e without config changes; named global profiles with type/command/args/env (incl. from_env); multi-worktree generation (-a/-n/--foreach) e.g. one worktree each for claude and gemini.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/add/
Locator: Arguments; Options table
Finding: Creates worktree + multiplexer window; --pr checks out GitHub PRs (gh) or GitLab MRs (glab 1.37+, --forge); -A auto-name via llm CLI; --fork/--continue resume; -n/--foreach/--agent multi-generation; -l layouts; --remote/--local placement; -b background; --with-changes moves uncommitted work.
Retrieved: 2026-11-12

Source: https://workmux.dev/changelog/
Locator: v0.1.282 through v0.1.1 entries with dates
Finding: Latest v0.1.282 (2026-11-10); near-weekly releases through 2026; recent additions: remote servers (v0.1.278), branch auto-name, coordinator commands, Zellij sidebar, Copilot/Grok/agy support; entries describe shipped releases only, no future-dated commitments found.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/skills/coordinator/SKILL.md
Locator: Core Concepts; Command Reference (Spawn/Monitor/Wait/Capture); Cross-project targeting
Finding: Coordinator agent uses workmux add/status/send/capture/wait/run; write-prompts-first-then-spawn; workmux wait with --timeout/--any and exit codes 0/1/2/3; continuous-monitoring invariant across interruptions; cross-project project:handle targeting.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/git-worktree-caveats/
Locator: Gitignored files; Conflicts; Package manager considerations
Finding: New worktrees are clean checkouts needing files copy/symlink config; parallel branches can still conflict on merge; per-worktree installs recommended; node_modules cleanup handled in background.
Retrieved: 2026-11-12

## workmux:COORD-03

Finding: Product-shipped /coordinator and /worktree skills define a coordinator role that spawns worktree agents with prompt files, monitors via status/wait, sends follow-ups, reviews output, and merges. Mixed-harness and retained-relationship depth untested.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-12-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

Delegation behavior is documented in the skill, not observed hands-on in this pass.
Cross-harness teams and persistent relationship records were not established.

Source: https://workmux.dev/guide/agents/
Locator: Agent integration; Named agents; Per-pane agents; Parallel workflows
Finding: Built-in agents: claude, codex, copilot, opencode, gemini, agy, kiro-cli, vibe, pi, omp, grok; prompt injection via -p/-P/-e without config changes; named global profiles with type/command/args/env (incl. from_env); multi-worktree generation (-a/-n/--foreach) e.g. one worktree each for claude and gemini.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/status-tracking/
Locator: Agent support table; Status icons; Automated setup; Pi subagents; Interrupted detection; last-done/last-agent
Finding: Supported: Claude Code, OpenCode, Codex, Copilot CLI, Pi, Oh My Pi, Gemini CLI, Grok, Antigravity agy (with version/capability footnotes); Kiro and Mistral Vibe are tracking-issues only; icons working/waiting/done; workmux setup installs hooks; last-done/last-agent navigation; nested-agent opt-out via WORKMUX_DISABLE_SET_WINDOW_STATUS=1.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/dashboard/
Locator: Setup; Agents/Worktrees views; Keybindings; Columns; Live preview; Input mode; Sort modes; Sweep
Finding: Optional TUI popup (tmux display-popup binding) requiring status hooks; Agents view (status, git info, PR checks, live preview) and Worktrees view; input mode sends keystrokes to agent; keys jump/diff/commit/merge/kill/remove/sweep; sort by priority/project/recency; sweep bulk-removes merged/gone worktrees.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/sidebar/
Locator: Setup; What it shows; Layouts; Sleeping agents; Session filter; Views
Finding: Always-visible agent overview pinned to tmux windows (or Zellij tabs): per-agent tile with status icon, worktree, elapsed time, project, git diff stats, optional PR number/checks, task description; toggle via workmux sidebar; session scoping and named views; requires status hooks.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/sandbox/
Locator: Security model; Agent permission prompts; Container/Lima backends; Threat model
Finding: Container (Docker/Podman/Apple Container) and Lima VM backends isolate agents from host secrets; sandboxed agents get noninteractive prompts with sandbox as boundary; status/dashboard/merge work the same via RPC bridge; documented limits: edits untrusted, host git ops and hooks outside boundary, no hostile-code-containment promise.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/skills/
Locator: Installation; /workmux /merge /rebase /worktree /coordinator /open-pr
Finding: Six product-shipped skills; workmux setup --skills installs to Claude/OpenCode/Pi/OMP dirs (manual copy documented); dashboard m keybinding triggers /merge; /merge commits/rebases/merges with conflict review; /worktree delegates with --fork option; /coordinator manages full lifecycle.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/workflows/
Locator: From terminal; From agent session; Forking; Coordinating; Direct merge; PR-based
Finding: add -A auto-names from prompt; /worktree spins off from running agents; --fork resumes conversations (Claude/Codex/Pi); /coordinator plans+delegates+merges; /merge for direct merge; /open-pr + git push + gh pr create then workmux remove/--gone for PR flow.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/add/
Locator: Arguments; Options table
Finding: Creates worktree + multiplexer window; --pr checks out GitHub PRs (gh) or GitLab MRs (glab 1.37+, --forge); -A auto-name via llm CLI; --fork/--continue resume; -n/--foreach/--agent multi-generation; -l layouts; --remote/--local placement; -b background; --with-changes moves uncommitted work.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/status/
Locator: Options; JSON output schema
Finding: Reports tracked agents per repository (or --all/project:handle); --json emits observation with backend context, state-file reconciliation counts, per-agent worktree/branch/status/elapsed/title/pane/git, and target_errors with stable codes.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/skills/coordinator/SKILL.md
Locator: Core Concepts; Command Reference (Spawn/Monitor/Wait/Capture); Cross-project targeting
Finding: Coordinator agent uses workmux add/status/send/capture/wait/run; write-prompts-first-then-spawn; workmux wait with --timeout/--any and exit codes 0/1/2/3; continuous-monitoring invariant across interruptions; cross-project project:handle targeting.
Retrieved: 2026-11-12

## workmux:COORD-04

Finding: Unattended triggers: the command reference pages plus additional CLI commands and the docs contain no schedules, event triggers, recurring tasks, or completion conditions; work starts from human or agent CLI invocations.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-12-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary)
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12



Source: https://workmux.dev/guide/configuration/
Locator: Two-level system; Remotes; placement; Panes and agent placeholders; File operations; Lifecycle hooks
Finding: Global ~/.config/workmux/config.yaml plus per-project .workmux.yaml; remotes and named agents are global-only; placement selects local or a named remote; panes support <agent> placeholders, splits, sizes; files copy/symlink; post_create/pre_merge/pre_remove hooks.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/
Locator: Overview (Experimental); How it fits together; Quick start
Finding: Experimental: run agents on user-reachable Linux servers over SSH; each remote agent keeps a local tmux window and appears in dashboard/sidebar/status/list as handle@remote; agent keeps working while local machine sleeps, loses network, or closes the window; window reconnects by itself; workmux merge brings work home; local machine stays Git source of truth.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/setup/
Locator: Requirements; Server or Docker; Install and check; Supplemental files; Security
Finding: Requires Linux x86-64/ARM64, promptless SSH, git, tmux 3.3+, systemd linger, API access; host mode (no sandbox) vs Docker mode per sandbox.enabled/isolation; server never talks to Git hosting and gets no origin; remote_files allowlist (64 MiB cap); no host-command proxying on servers.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/
Locator: Commands overview table
Finding: Command reference inventory: 24 documented command pages (add merge rebase remove rename list status open close resurrect sync-files path shell dashboard sidebar reap-agents config edit init claude prune sandbox remote completions docs update last-done) plus additional CLI-only commands (setup, send, wait, capture, run); no REST API, SDK, MCP server, webhook, or scheduling commands appear in the reference or full docs.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/remote/
Locator: remote/setup/doctor/login reference
Finding: remote lists servers and placement default; setup installs matching node + status hooks; doctor runs 10 checks (ssh/arch/node/git/tmux/linger/mode/hooks/logins/image) with fixes; login runs native agent flows with --import/--setup-token options.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/skills/coordinator/SKILL.md
Locator: Core Concepts; Command Reference (Spawn/Monitor/Wait/Capture); Cross-project targeting
Finding: Coordinator agent uses workmux add/status/send/capture/wait/run; write-prompts-first-then-spawn; workmux wait with --timeout/--any and exit codes 0/1/2/3; continuous-monitoring invariant across interruptions; cross-project project:handle targeting.
Retrieved: 2026-11-12

## workmux:COORD-05

Finding: Stop (dashboard kill/remove/reap-agents), resume (resurrect/--continue/--fork/reconnect), steer (input mode/send), and waiting-state attention (priority sort, last-done) all documented; no pause or escalation chain.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-12-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

No pause primitive and no escalation chain documented.
Error visibility rests on documented diagnostics (status --json, doctor); silent-wait behavior untested hands-on.

Source: https://workmux.dev/guide/status-tracking/
Locator: Agent support table; Status icons; Automated setup; Pi subagents; Interrupted detection; last-done/last-agent
Finding: Supported: Claude Code, OpenCode, Codex, Copilot CLI, Pi, Oh My Pi, Gemini CLI, Grok, Antigravity agy (with version/capability footnotes); Kiro and Mistral Vibe are tracking-issues only; icons working/waiting/done; workmux setup installs hooks; last-done/last-agent navigation; nested-agent opt-out via WORKMUX_DISABLE_SET_WINDOW_STATUS=1.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/dashboard/
Locator: Setup; Agents/Worktrees views; Keybindings; Columns; Live preview; Input mode; Sort modes; Sweep
Finding: Optional TUI popup (tmux display-popup binding) requiring status hooks; Agents view (status, git info, PR checks, live preview) and Worktrees view; input mode sends keystrokes to agent; keys jump/diff/commit/merge/kill/remove/sweep; sort by priority/project/recency; sweep bulk-removes merged/gone worktrees.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/
Locator: Overview (Experimental); How it fits together; Quick start
Finding: Experimental: run agents on user-reachable Linux servers over SSH; each remote agent keeps a local tmux window and appears in dashboard/sidebar/status/list as handle@remote; agent keeps working while local machine sleeps, loses network, or closes the window; window reconnects by itself; workmux merge brings work home; local machine stays Git source of truth.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/workflows/
Locator: From terminal; From agent session; Forking; Coordinating; Direct merge; PR-based
Finding: add -A auto-names from prompt; /worktree spins off from running agents; --fork resumes conversations (Claude/Codex/Pi); /coordinator plans+delegates+merges; /merge for direct merge; /open-pr + git push + gh pr create then workmux remove/--gone for PR flow.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/
Locator: Commands overview table
Finding: Command reference inventory: 24 documented command pages (add merge rebase remove rename list status open close resurrect sync-files path shell dashboard sidebar reap-agents config edit init claude prune sandbox remote completions docs update last-done) plus additional CLI-only commands (setup, send, wait, capture, run); no REST API, SDK, MCP server, webhook, or scheduling commands appear in the reference or full docs.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/merge/
Locator: When to use merge vs remove; Options; Merge strategies; What happens
Finding: Local git merge into main (or --into) with merge/rebase/squash strategies plus worktree+window+branch cleanup; --keep/merge_keep; --notification system notification; PR workflows merge remotely and use remove for cleanup instead.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/status/
Locator: Options; JSON output schema
Finding: Reports tracked agents per repository (or --all/project:handle); --json emits observation with backend context, state-file reconciliation counts, per-agent worktree/branch/status/elapsed/title/pane/git, and target_errors with stable codes.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/remote/
Locator: remote/setup/doctor/login reference
Finding: remote lists servers and placement default; setup installs matching node + status hooks; doctor runs 10 checks (ssh/arch/node/git/tmux/linger/mode/hooks/logins/image) with fixes; login runs native agent flows with --import/--setup-token options.
Retrieved: 2026-11-12

Source: https://workmux.dev/changelog/
Locator: v0.1.282 through v0.1.1 entries with dates
Finding: Latest v0.1.282 (2026-11-10); near-weekly releases through 2026; recent additions: remote servers (v0.1.278), branch auto-name, coordinator commands, Zellij sidebar, Copilot/Grok/agy support; entries describe shipped releases only, no future-dated commitments found.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/skills/coordinator/SKILL.md
Locator: Core Concepts; Command Reference (Spawn/Monitor/Wait/Capture); Cross-project targeting
Finding: Coordinator agent uses workmux add/status/send/capture/wait/run; write-prompts-first-then-spawn; workmux wait with --timeout/--any and exit codes 0/1/2/3; continuous-monitoring invariant across interruptions; cross-project project:handle targeting.
Retrieved: 2026-11-12

## workmux:COORD-06

Finding: Dashboard Agents/Worktrees views plus sidebar give a filterable fleet UI with attention sorting (waiting first), timers, diff stats, and navigation. No 12-task fixture was run; parent/child links and dependency views are absent.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-12-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

No disclosed 12-state fixture run; live-agent verification absent in this pass.
No parent/child tree or dependency rendering; coordinator relationships live in prompts/branches, not the UI.

Source: https://workmux.dev/guide/status-tracking/
Locator: Agent support table; Status icons; Automated setup; Pi subagents; Interrupted detection; last-done/last-agent
Finding: Supported: Claude Code, OpenCode, Codex, Copilot CLI, Pi, Oh My Pi, Gemini CLI, Grok, Antigravity agy (with version/capability footnotes); Kiro and Mistral Vibe are tracking-issues only; icons working/waiting/done; workmux setup installs hooks; last-done/last-agent navigation; nested-agent opt-out via WORKMUX_DISABLE_SET_WINDOW_STATUS=1.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/dashboard/
Locator: Setup; Agents/Worktrees views; Keybindings; Columns; Live preview; Input mode; Sort modes; Sweep
Finding: Optional TUI popup (tmux display-popup binding) requiring status hooks; Agents view (status, git info, PR checks, live preview) and Worktrees view; input mode sends keystrokes to agent; keys jump/diff/commit/merge/kill/remove/sweep; sort by priority/project/recency; sweep bulk-removes merged/gone worktrees.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/sidebar/
Locator: Setup; What it shows; Layouts; Sleeping agents; Session filter; Views
Finding: Always-visible agent overview pinned to tmux windows (or Zellij tabs): per-agent tile with status icon, worktree, elapsed time, project, git diff stats, optional PR number/checks, task description; toggle via workmux sidebar; session scoping and named views; requires status hooks.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/list/
Locator: Options; Example output; Key; Remote workspaces
Finding: Lists worktrees with AGE, AGENT status icons (incl. counts, text labels when piped), MUX window presence, UNMERGED marker; --pr shows PR status (gh); --json output; remote workspaces listed with remote name, last-known state, and exited reasons such as host reboot.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/status/
Locator: Options; JSON output schema
Finding: Reports tracked agents per repository (or --all/project:handle); --json emits observation with backend context, state-file reconciliation counts, per-agent worktree/branch/status/elapsed/title/pane/git, and target_errors with stable codes.
Retrieved: 2026-11-12

## workmux:COORD-07

Finding: One-shot add -A and growing coordinator-led epics share the same tool; optional layouts, natural-language prompts, per-agent profiles, and mid-run steering are documented. No mandatory presets, in-run plan edits, or relationship records.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-12-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

Growing-epic flow is coordinator-convention, not product-enforced hierarchy.
Retained coordinator relationships and in-run plan edits were not established.

Source: https://workmux.dev/guide/installation/
Locator: Bash/Homebrew/Cargo/mise/Nix methods; Shell alias; Completions; Uninstalling
Finding: Install via install script, Homebrew (macOS/Linux), Cargo, mise, Nix, or prebuilt binaries; shell completions for bash/zsh/fish; uninstall script removes data dirs; no account, signup, or payment step.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/configuration/
Locator: Two-level system; Remotes; placement; Panes and agent placeholders; File operations; Lifecycle hooks
Finding: Global ~/.config/workmux/config.yaml plus per-project .workmux.yaml; remotes and named agents are global-only; placement selects local or a named remote; panes support <agent> placeholders, splits, sizes; files copy/symlink; post_create/pre_merge/pre_remove hooks.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/agents/
Locator: Agent integration; Named agents; Per-pane agents; Parallel workflows
Finding: Built-in agents: claude, codex, copilot, opencode, gemini, agy, kiro-cli, vibe, pi, omp, grok; prompt injection via -p/-P/-e without config changes; named global profiles with type/command/args/env (incl. from_env); multi-worktree generation (-a/-n/--foreach) e.g. one worktree each for claude and gemini.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/status-tracking/
Locator: Agent support table; Status icons; Automated setup; Pi subagents; Interrupted detection; last-done/last-agent
Finding: Supported: Claude Code, OpenCode, Codex, Copilot CLI, Pi, Oh My Pi, Gemini CLI, Grok, Antigravity agy (with version/capability footnotes); Kiro and Mistral Vibe are tracking-issues only; icons working/waiting/done; workmux setup installs hooks; last-done/last-agent navigation; nested-agent opt-out via WORKMUX_DISABLE_SET_WINDOW_STATUS=1.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/dashboard/
Locator: Setup; Agents/Worktrees views; Keybindings; Columns; Live preview; Input mode; Sort modes; Sweep
Finding: Optional TUI popup (tmux display-popup binding) requiring status hooks; Agents view (status, git info, PR checks, live preview) and Worktrees view; input mode sends keystrokes to agent; keys jump/diff/commit/merge/kill/remove/sweep; sort by priority/project/recency; sweep bulk-removes merged/gone worktrees.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/sidebar/
Locator: Setup; What it shows; Layouts; Sleeping agents; Session filter; Views
Finding: Always-visible agent overview pinned to tmux windows (or Zellij tabs): per-agent tile with status icon, worktree, elapsed time, project, git diff stats, optional PR number/checks, task description; toggle via workmux sidebar; session scoping and named views; requires status hooks.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/setup/
Locator: Requirements; Server or Docker; Install and check; Supplemental files; Security
Finding: Requires Linux x86-64/ARM64, promptless SSH, git, tmux 3.3+, systemd linger, API access; host mode (no sandbox) vs Docker mode per sandbox.enabled/isolation; server never talks to Git hosting and gets no origin; remote_files allowlist (64 MiB cap); no host-command proxying on servers.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/skills/
Locator: Installation; /workmux /merge /rebase /worktree /coordinator /open-pr
Finding: Six product-shipped skills; workmux setup --skills installs to Claude/OpenCode/Pi/OMP dirs (manual copy documented); dashboard m keybinding triggers /merge; /merge commits/rebases/merges with conflict review; /worktree delegates with --fork option; /coordinator manages full lifecycle.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/workflows/
Locator: From terminal; From agent session; Forking; Coordinating; Direct merge; PR-based
Finding: add -A auto-names from prompt; /worktree spins off from running agents; --fork resumes conversations (Claude/Codex/Pi); /coordinator plans+delegates+merges; /merge for direct merge; /open-pr + git push + gh pr create then workmux remove/--gone for PR flow.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/
Locator: Commands overview table
Finding: Command reference inventory: 24 documented command pages (add merge rebase remove rename list status open close resurrect sync-files path shell dashboard sidebar reap-agents config edit init claude prune sandbox remote completions docs update last-done) plus additional CLI-only commands (setup, send, wait, capture, run); no REST API, SDK, MCP server, webhook, or scheduling commands appear in the reference or full docs.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/add/
Locator: Arguments; Options table
Finding: Creates worktree + multiplexer window; --pr checks out GitHub PRs (gh) or GitLab MRs (glab 1.37+, --forge); -A auto-name via llm CLI; --fork/--continue resume; -n/--foreach/--agent multi-generation; -l layouts; --remote/--local placement; -b background; --with-changes moves uncommitted work.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/skills/coordinator/SKILL.md
Locator: Core Concepts; Command Reference (Spawn/Monitor/Wait/Capture); Cross-project targeting
Finding: Coordinator agent uses workmux add/status/send/capture/wait/run; write-prompts-first-then-spawn; workmux wait with --timeout/--any and exit codes 0/1/2/3; continuous-monitoring invariant across interruptions; cross-project project:handle targeting.
Retrieved: 2026-11-12

## workmux:RUN-01

Finding: Local execution plus experimental BYO-server remotes over SSH in the same views; no vendor cloud or self-hosted service. Remote agents survive laptop sleep/disconnect with auto-reconnect; other-device continuation undocumented.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-12-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

Remote backend is explicitly experimental.
Survival covers the same laptop returning; continuing from another device is not documented.

Source: https://workmux.dev/guide/installation/
Locator: Bash/Homebrew/Cargo/mise/Nix methods; Shell alias; Completions; Uninstalling
Finding: Install via install script, Homebrew (macOS/Linux), Cargo, mise, Nix, or prebuilt binaries; shell completions for bash/zsh/fish; uninstall script removes data dirs; no account, signup, or payment step.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/quick-start/
Locator: Prerequisites; steps 1-5; The parallel AI workflow
Finding: Prerequisites: Git 2.5+ and tmux (or WezTerm/kitty/Zellij); flow is install, optional workmux init, workmux add (creates worktree + window + panes + setup), work, workmux merge cleanup; /worktree skill recommended from inside agent sessions.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/configuration/
Locator: Two-level system; Remotes; placement; Panes and agent placeholders; File operations; Lifecycle hooks
Finding: Global ~/.config/workmux/config.yaml plus per-project .workmux.yaml; remotes and named agents are global-only; placement selects local or a named remote; panes support <agent> placeholders, splits, sizes; files copy/symlink; post_create/pre_merge/pre_remove hooks.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/sandbox/
Locator: Security model; Agent permission prompts; Container/Lima backends; Threat model
Finding: Container (Docker/Podman/Apple Container) and Lima VM backends isolate agents from host secrets; sandboxed agents get noninteractive prompts with sandbox as boundary; status/dashboard/merge work the same via RPC bridge; documented limits: edits untrusted, host git ops and hooks outside boundary, no hostile-code-containment promise.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/
Locator: Overview (Experimental); How it fits together; Quick start
Finding: Experimental: run agents on user-reachable Linux servers over SSH; each remote agent keeps a local tmux window and appears in dashboard/sidebar/status/list as handle@remote; agent keeps working while local machine sleeps, loses network, or closes the window; window reconnects by itself; workmux merge brings work home; local machine stays Git source of truth.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/setup/
Locator: Requirements; Server or Docker; Install and check; Supplemental files; Security
Finding: Requires Linux x86-64/ARM64, promptless SSH, git, tmux 3.3+, systemd linger, API access; host mode (no sandbox) vs Docker mode per sandbox.enabled/isolation; server never talks to Git hosting and gets no origin; remote_files allowlist (64 MiB cap); no host-command proxying on servers.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/
Locator: Commands overview table
Finding: Command reference inventory: 24 documented command pages (add merge rebase remove rename list status open close resurrect sync-files path shell dashboard sidebar reap-agents config edit init claude prune sandbox remote completions docs update last-done) plus additional CLI-only commands (setup, send, wait, capture, run); no REST API, SDK, MCP server, webhook, or scheduling commands appear in the reference or full docs.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/list/
Locator: Options; Example output; Key; Remote workspaces
Finding: Lists worktrees with AGE, AGENT status icons (incl. counts, text labels when piped), MUX window presence, UNMERGED marker; --pr shows PR status (gh); --json output; remote workspaces listed with remote name, last-known state, and exited reasons such as host reboot.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/remote/
Locator: remote/setup/doctor/login reference
Finding: remote lists servers and placement default; setup installs matching node + status hooks; doctor runs 10 checks (ssh/arch/node/git/tmux/linger/mode/hooks/logins/image) with fixes; login runs native agent flows with --import/--setup-token options.
Retrieved: 2026-11-12

## workmux:RUN-02

Finding: Git worktree/branch file isolation plus container (Docker/Podman/Apple) and VM (Lima/Kata) sandboxes with scoped mounts and secret exclusion. Host-side git ops stay outside the boundary; hostile-code containment is explicitly disclaimed.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-12-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

Documented threat model: agent edits are untrusted on rebuild; host git operations, hooks, and content filters sit outside the sandbox.
Two-change code-separation validation was not performed in this pass.

Source: https://raw.githubusercontent.com/raine/workmux/main/README.md
Locator: Why workmux; Features; Installation; Community videos
Finding: Manages git worktrees + tmux windows for parallel AI agents; features dashboard, sidebar, /worktree skill, agent status tracking, sandbox, remote servers, branch-name generation; install via script/Homebrew/Cargo/mise/Nix; philosophy "tmux is the interface".
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/quick-start/
Locator: Prerequisites; steps 1-5; The parallel AI workflow
Finding: Prerequisites: Git 2.5+ and tmux (or WezTerm/kitty/Zellij); flow is install, optional workmux init, workmux add (creates worktree + window + panes + setup), work, workmux merge cleanup; /worktree skill recommended from inside agent sessions.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/configuration/
Locator: Two-level system; Remotes; placement; Panes and agent placeholders; File operations; Lifecycle hooks
Finding: Global ~/.config/workmux/config.yaml plus per-project .workmux.yaml; remotes and named agents are global-only; placement selects local or a named remote; panes support <agent> placeholders, splits, sizes; files copy/symlink; post_create/pre_merge/pre_remove hooks.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/sandbox/
Locator: Security model; Agent permission prompts; Container/Lima backends; Threat model
Finding: Container (Docker/Podman/Apple Container) and Lima VM backends isolate agents from host secrets; sandboxed agents get noninteractive prompts with sandbox as boundary; status/dashboard/merge work the same via RPC bridge; documented limits: edits untrusted, host git ops and hooks outside boundary, no hostile-code-containment promise.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/setup/
Locator: Requirements; Server or Docker; Install and check; Supplemental files; Security
Finding: Requires Linux x86-64/ARM64, promptless SSH, git, tmux 3.3+, systemd linger, API access; host mode (no sandbox) vs Docker mode per sandbox.enabled/isolation; server never talks to Git hosting and gets no origin; remote_files allowlist (64 MiB cap); no host-command proxying on servers.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/logins/
Locator: Per-agent login table; Copy logins; Claude long-lived token; Environment variables
Finding: remote login runs each agent native login flow (claude/codex/gemini/opencode/pi/omp) with localhost port forwarding; --import does a one-time credential copy (with rotation caveats); setup-token for Claude; sandbox env passthrough read once per workspace and stored privately on server.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/add/
Locator: Arguments; Options table
Finding: Creates worktree + multiplexer window; --pr checks out GitHub PRs (gh) or GitLab MRs (glab 1.37+, --forge); -A auto-name via llm CLI; --fork/--continue resume; -n/--foreach/--agent multi-generation; -l layouts; --remote/--local placement; -b background; --with-changes moves uncommitted work.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/merge/
Locator: When to use merge vs remove; Options; Merge strategies; What happens
Finding: Local git merge into main (or --into) with merge/rebase/squash strategies plus worktree+window+branch cleanup; --keep/merge_keep; --notification system notification; PR workflows merge remotely and use remove for cleanup instead.
Retrieved: 2026-11-12

Source: https://workmux.dev/changelog/
Locator: v0.1.282 through v0.1.1 entries with dates
Finding: Latest v0.1.282 (2026-11-10); near-weekly releases through 2026; recent additions: remote servers (v0.1.278), branch auto-name, coordinator commands, Zellij sidebar, Copilot/Grok/agy support; entries describe shipped releases only, no future-dated commitments found.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/git-worktree-caveats/
Locator: Gitignored files; Conflicts; Package manager considerations
Finding: New worktrees are clean checkouts needing files copy/symlink config; parallel branches can still conflict on merge; per-worktree installs recommended; node_modules cleanup handled in background.
Retrieved: 2026-11-12

## workmux:RUN-03

Finding: Crash recovery via resurrect, resumable remote provisioning, automatic remote reconnect, and state-file reconciliation with diagnostics; transcript resume via --continue/--fork. Multi-day continuity and loss/duplication behavior untested.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-12-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

Recovery is documented, not exercised: no crash/disconnect drill was run in this pass.
Context loss, duplicate actions, and multi-day continuity were not established.

Source: https://workmux.dev/guide/claude-code/
Locator: Share permissions; Skip permission prompts (yolo mode); Multiple configurations
Finding: Permission options: symlink .claude/settings.local.json across worktrees, or named agent shadowing claude with --dangerously-skip-permissions; separate work/personal configs via named agents or CLAUDE_CONFIG_DIR.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/status-tracking/
Locator: Agent support table; Status icons; Automated setup; Pi subagents; Interrupted detection; last-done/last-agent
Finding: Supported: Claude Code, OpenCode, Codex, Copilot CLI, Pi, Oh My Pi, Gemini CLI, Grok, Antigravity agy (with version/capability footnotes); Kiro and Mistral Vibe are tracking-issues only; icons working/waiting/done; workmux setup installs hooks; last-done/last-agent navigation; nested-agent opt-out via WORKMUX_DISABLE_SET_WINDOW_STATUS=1.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/sandbox/
Locator: Security model; Agent permission prompts; Container/Lima backends; Threat model
Finding: Container (Docker/Podman/Apple Container) and Lima VM backends isolate agents from host secrets; sandboxed agents get noninteractive prompts with sandbox as boundary; status/dashboard/merge work the same via RPC bridge; documented limits: edits untrusted, host git ops and hooks outside boundary, no hostile-code-containment promise.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/
Locator: Overview (Experimental); How it fits together; Quick start
Finding: Experimental: run agents on user-reachable Linux servers over SSH; each remote agent keeps a local tmux window and appears in dashboard/sidebar/status/list as handle@remote; agent keeps working while local machine sleeps, loses network, or closes the window; window reconnects by itself; workmux merge brings work home; local machine stays Git source of truth.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/setup/
Locator: Requirements; Server or Docker; Install and check; Supplemental files; Security
Finding: Requires Linux x86-64/ARM64, promptless SSH, git, tmux 3.3+, systemd linger, API access; host mode (no sandbox) vs Docker mode per sandbox.enabled/isolation; server never talks to Git hosting and gets no origin; remote_files allowlist (64 MiB cap); no host-command proxying on servers.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/workflows/
Locator: From terminal; From agent session; Forking; Coordinating; Direct merge; PR-based
Finding: add -A auto-names from prompt; /worktree spins off from running agents; --fork resumes conversations (Claude/Codex/Pi); /coordinator plans+delegates+merges; /merge for direct merge; /open-pr + git push + gh pr create then workmux remove/--gone for PR flow.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/
Locator: Commands overview table
Finding: Command reference inventory: 24 documented command pages (add merge rebase remove rename list status open close resurrect sync-files path shell dashboard sidebar reap-agents config edit init claude prune sandbox remote completions docs update last-done) plus additional CLI-only commands (setup, send, wait, capture, run); no REST API, SDK, MCP server, webhook, or scheduling commands appear in the reference or full docs.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/list/
Locator: Options; Example output; Key; Remote workspaces
Finding: Lists worktrees with AGE, AGENT status icons (incl. counts, text labels when piped), MUX window presence, UNMERGED marker; --pr shows PR status (gh); --json output; remote workspaces listed with remote name, last-known state, and exited reasons such as host reboot.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/status/
Locator: Options; JSON output schema
Finding: Reports tracked agents per repository (or --all/project:handle); --json emits observation with backend context, state-file reconciliation counts, per-agent worktree/branch/status/elapsed/title/pane/git, and target_errors with stable codes.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/remote/
Locator: remote/setup/doctor/login reference
Finding: remote lists servers and placement default; setup installs matching node + status hooks; doctor runs 10 checks (ssh/arch/node/git/tmux/linger/mode/hooks/logins/image) with fixes; login runs native agent flows with --import/--setup-token options.
Retrieved: 2026-11-12

Source: https://workmux.dev/changelog/
Locator: v0.1.282 through v0.1.1 entries with dates
Finding: Latest v0.1.282 (2026-11-10); near-weekly releases through 2026; recent additions: remote servers (v0.1.278), branch auto-name, coordinator commands, Zellij sidebar, Copilot/Grok/agy support; entries describe shipped releases only, no future-dated commitments found.
Retrieved: 2026-11-12

## workmux:RUN-04

Finding: Dependencies via hooks and pane installs, secrets via files copy, caches via symlinks, dev servers as panes, remote node checks; per-worktree installs with background cleanup. No snapshots or managed services.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-12-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

Environment repair is operator-driven (doctor fixes, retry/resume); app-level failures are the user/agent job.
Service orchestration is panes-plus-docs (direnv port guidance), not managed services.

Source: https://workmux.dev/guide/quick-start/
Locator: Prerequisites; steps 1-5; The parallel AI workflow
Finding: Prerequisites: Git 2.5+ and tmux (or WezTerm/kitty/Zellij); flow is install, optional workmux init, workmux add (creates worktree + window + panes + setup), work, workmux merge cleanup; /worktree skill recommended from inside agent sessions.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/configuration/
Locator: Two-level system; Remotes; placement; Panes and agent placeholders; File operations; Lifecycle hooks
Finding: Global ~/.config/workmux/config.yaml plus per-project .workmux.yaml; remotes and named agents are global-only; placement selects local or a named remote; panes support <agent> placeholders, splits, sizes; files copy/symlink; post_create/pre_merge/pre_remove hooks.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/sandbox/
Locator: Security model; Agent permission prompts; Container/Lima backends; Threat model
Finding: Container (Docker/Podman/Apple Container) and Lima VM backends isolate agents from host secrets; sandboxed agents get noninteractive prompts with sandbox as boundary; status/dashboard/merge work the same via RPC bridge; documented limits: edits untrusted, host git ops and hooks outside boundary, no hostile-code-containment promise.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/setup/
Locator: Requirements; Server or Docker; Install and check; Supplemental files; Security
Finding: Requires Linux x86-64/ARM64, promptless SSH, git, tmux 3.3+, systemd linger, API access; host mode (no sandbox) vs Docker mode per sandbox.enabled/isolation; server never talks to Git hosting and gets no origin; remote_files allowlist (64 MiB cap); no host-command proxying on servers.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/logins/
Locator: Per-agent login table; Copy logins; Claude long-lived token; Environment variables
Finding: remote login runs each agent native login flow (claude/codex/gemini/opencode/pi/omp) with localhost port forwarding; --import does a one-time credential copy (with rotation caveats); setup-token for Claude; sandbox env passthrough read once per workspace and stored privately on server.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/remote/
Locator: remote/setup/doctor/login reference
Finding: remote lists servers and placement default; setup installs matching node + status hooks; doctor runs 10 checks (ssh/arch/node/git/tmux/linger/mode/hooks/logins/image) with fixes; login runs native agent flows with --import/--setup-token options.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/git-worktree-caveats/
Locator: Gitignored files; Conflicts; Package manager considerations
Finding: New worktrees are clean checkouts needing files copy/symlink config; parallel branches can still conflict on merge; per-worktree installs recommended; node_modules cleanup handled in background.
Retrieved: 2026-11-12

## workmux:RUN-05

Finding: Count-based throttling (--max-concurrent), wait timeouts, process-age reaping, pre-merge abort, and sandbox proxy limits exist; no time/turn/token/spend budgets or provider-failure policy documented.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-12-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

No budgets for time, turns, tokens, or spend; no provider-failure retry policy.
Enforcement is local abort/exit-code semantics, not billing controls.

Source: https://workmux.dev/guide/configuration/
Locator: Two-level system; Remotes; placement; Panes and agent placeholders; File operations; Lifecycle hooks
Finding: Global ~/.config/workmux/config.yaml plus per-project .workmux.yaml; remotes and named agents are global-only; placement selects local or a named remote; panes support <agent> placeholders, splits, sizes; files copy/symlink; post_create/pre_merge/pre_remove hooks.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/status-tracking/
Locator: Agent support table; Status icons; Automated setup; Pi subagents; Interrupted detection; last-done/last-agent
Finding: Supported: Claude Code, OpenCode, Codex, Copilot CLI, Pi, Oh My Pi, Gemini CLI, Grok, Antigravity agy (with version/capability footnotes); Kiro and Mistral Vibe are tracking-issues only; icons working/waiting/done; workmux setup installs hooks; last-done/last-agent navigation; nested-agent opt-out via WORKMUX_DISABLE_SET_WINDOW_STATUS=1.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/sandbox/
Locator: Security model; Agent permission prompts; Container/Lima backends; Threat model
Finding: Container (Docker/Podman/Apple Container) and Lima VM backends isolate agents from host secrets; sandboxed agents get noninteractive prompts with sandbox as boundary; status/dashboard/merge work the same via RPC bridge; documented limits: edits untrusted, host git ops and hooks outside boundary, no hostile-code-containment promise.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/setup/
Locator: Requirements; Server or Docker; Install and check; Supplemental files; Security
Finding: Requires Linux x86-64/ARM64, promptless SSH, git, tmux 3.3+, systemd linger, API access; host mode (no sandbox) vs Docker mode per sandbox.enabled/isolation; server never talks to Git hosting and gets no origin; remote_files allowlist (64 MiB cap); no host-command proxying on servers.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/
Locator: Commands overview table
Finding: Command reference inventory: 24 documented command pages (add merge rebase remove rename list status open close resurrect sync-files path shell dashboard sidebar reap-agents config edit init claude prune sandbox remote completions docs update last-done) plus additional CLI-only commands (setup, send, wait, capture, run); no REST API, SDK, MCP server, webhook, or scheduling commands appear in the reference or full docs.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/remote/
Locator: remote/setup/doctor/login reference
Finding: remote lists servers and placement default; setup installs matching node + status hooks; doctor runs 10 checks (ssh/arch/node/git/tmux/linger/mode/hooks/logins/image) with fixes; login runs native agent flows with --import/--setup-token options.
Retrieved: 2026-11-12

Source: https://workmux.dev/changelog/
Locator: v0.1.282 through v0.1.1 entries with dates
Finding: Latest v0.1.282 (2026-11-10); near-weekly releases through 2026; recent additions: remote servers (v0.1.278), branch auto-name, coordinator commands, Zellij sidebar, Copilot/Grok/agy support; entries describe shipped releases only, no future-dated commitments found.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/skills/coordinator/SKILL.md
Locator: Core Concepts; Command Reference (Spawn/Monitor/Wait/Capture); Cross-project targeting
Finding: Coordinator agent uses workmux add/status/send/capture/wait/run; write-prompts-first-then-spawn; workmux wait with --timeout/--any and exit codes 0/1/2/3; continuous-monitoring invariant across interruptions; cross-project project:handle targeting.
Retrieved: 2026-11-12

## workmux:RUN-06

Finding: Host log, reconciled state files with --json diagnostics, per-agent/row stats (status, elapsed, titles, diffs), waiting/done failure semantics, and doctor checks. No traces, usage exports, aggregates beyond views, or measured performance claims.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-12-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

Truthfulness rests on documentation: no induced failure or reconnect-consistency drill was run here.
No traces, cost/usage exports, or disclosed speed benchmarks.

Source: https://workmux.dev/guide/configuration/
Locator: Two-level system; Remotes; placement; Panes and agent placeholders; File operations; Lifecycle hooks
Finding: Global ~/.config/workmux/config.yaml plus per-project .workmux.yaml; remotes and named agents are global-only; placement selects local or a named remote; panes support <agent> placeholders, splits, sizes; files copy/symlink; post_create/pre_merge/pre_remove hooks.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/status-tracking/
Locator: Agent support table; Status icons; Automated setup; Pi subagents; Interrupted detection; last-done/last-agent
Finding: Supported: Claude Code, OpenCode, Codex, Copilot CLI, Pi, Oh My Pi, Gemini CLI, Grok, Antigravity agy (with version/capability footnotes); Kiro and Mistral Vibe are tracking-issues only; icons working/waiting/done; workmux setup installs hooks; last-done/last-agent navigation; nested-agent opt-out via WORKMUX_DISABLE_SET_WINDOW_STATUS=1.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/dashboard/
Locator: Setup; Agents/Worktrees views; Keybindings; Columns; Live preview; Input mode; Sort modes; Sweep
Finding: Optional TUI popup (tmux display-popup binding) requiring status hooks; Agents view (status, git info, PR checks, live preview) and Worktrees view; input mode sends keystrokes to agent; keys jump/diff/commit/merge/kill/remove/sweep; sort by priority/project/recency; sweep bulk-removes merged/gone worktrees.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/sandbox/
Locator: Security model; Agent permission prompts; Container/Lima backends; Threat model
Finding: Container (Docker/Podman/Apple Container) and Lima VM backends isolate agents from host secrets; sandboxed agents get noninteractive prompts with sandbox as boundary; status/dashboard/merge work the same via RPC bridge; documented limits: edits untrusted, host git ops and hooks outside boundary, no hostile-code-containment promise.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/list/
Locator: Options; Example output; Key; Remote workspaces
Finding: Lists worktrees with AGE, AGENT status icons (incl. counts, text labels when piped), MUX window presence, UNMERGED marker; --pr shows PR status (gh); --json output; remote workspaces listed with remote name, last-known state, and exited reasons such as host reboot.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/status/
Locator: Options; JSON output schema
Finding: Reports tracked agents per repository (or --all/project:handle); --json emits observation with backend context, state-file reconciliation counts, per-agent worktree/branch/status/elapsed/title/pane/git, and target_errors with stable codes.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/remote/
Locator: remote/setup/doctor/login reference
Finding: remote lists servers and placement default; setup installs matching node + status hooks; doctor runs 10 checks (ssh/arch/node/git/tmux/linger/mode/hooks/logins/image) with fixes; login runs native agent flows with --import/--setup-token options.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/skills/coordinator/SKILL.md
Locator: Core Concepts; Command Reference (Spawn/Monitor/Wait/Capture); Cross-project targeting
Finding: Coordinator agent uses workmux add/status/send/capture/wait/run; write-prompts-first-then-spawn; workmux wait with --timeout/--any and exit codes 0/1/2/3; continuous-monitoring invariant across interruptions; cross-project project:handle targeting.
Retrieved: 2026-11-12

## workmux:RUN-07

Finding: Per-task API and compute cost visibility does not exist in the pinned release: list, status, and dashboard expose git and agent-status data only; repo-wide inspection finds no spend, token-usage, allowance, compute-fee, alert, export, or drill-down code (`token` means auth tokens, `budget` means UI widths and a transfer cap). Bounded inspection of raine/workmux at e72fd59 (src/, skills/, docs/) found no cost surface.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2027-03-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12



Source: https://workmux.dev/guide/installation/
Locator: Bash/Homebrew/Cargo/mise/Nix methods; Shell alias; Completions; Uninstalling
Finding: Install via install script, Homebrew (macOS/Linux), Cargo, mise, Nix, or prebuilt binaries; shell completions for bash/zsh/fish; uninstall script removes data dirs; no account, signup, or payment step.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/agents/
Locator: Agent integration; Named agents; Per-pane agents; Parallel workflows
Finding: Built-in agents: claude, codex, copilot, opencode, gemini, agy, kiro-cli, vibe, pi, omp, grok; prompt injection via -p/-P/-e without config changes; named global profiles with type/command/args/env (incl. from_env); multi-worktree generation (-a/-n/--foreach) e.g. one worktree each for claude and gemini.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/dashboard/
Locator: Setup; Agents/Worktrees views; Keybindings; Columns; Live preview; Input mode; Sort modes; Sweep
Finding: Optional TUI popup (tmux display-popup binding) requiring status hooks; Agents view (status, git info, PR checks, live preview) and Worktrees view; input mode sends keystrokes to agent; keys jump/diff/commit/merge/kill/remove/sweep; sort by priority/project/recency; sweep bulk-removes merged/gone worktrees.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/setup/
Locator: Requirements; Server or Docker; Install and check; Supplemental files; Security
Finding: Requires Linux x86-64/ARM64, promptless SSH, git, tmux 3.3+, systemd linger, API access; host mode (no sandbox) vs Docker mode per sandbox.enabled/isolation; server never talks to Git hosting and gets no origin; remote_files allowlist (64 MiB cap); no host-command proxying on servers.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/merge/
Locator: When to use merge vs remove; Options; Merge strategies; What happens
Finding: Local git merge into main (or --into) with merge/rebase/squash strategies plus worktree+window+branch cleanup; --keep/merge_keep; --notification system notification; PR workflows merge remotely and use remove for cleanup instead.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/list/
Locator: Options; Example output; Key; Remote workspaces
Finding: Lists worktrees with AGE, AGENT status icons (incl. counts, text labels when piped), MUX window presence, UNMERGED marker; --pr shows PR status (gh); --json output; remote workspaces listed with remote name, last-known state, and exited reasons such as host reboot.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/status/
Locator: Options; JSON output schema
Finding: Reports tracked agents per repository (or --all/project:handle); --json emits observation with backend context, state-file reconciliation counts, per-agent worktree/branch/status/elapsed/title/pane/git, and target_errors with stable codes.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/skills/coordinator/SKILL.md
Locator: Core Concepts; Command Reference (Spawn/Monitor/Wait/Capture); Cross-project targeting
Finding: Coordinator agent uses workmux add/status/send/capture/wait/run; write-prompts-first-then-spawn; workmux wait with --timeout/--any and exit codes 0/1/2/3; continuous-monitoring invariant across interruptions; cross-project project:handle targeting.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/src/command/list.rs
Locator: list.rs WorktreeRow headers; status.rs output; dashboard views; repo-wide cost/spend/token/billing grep
Finding: raine/workmux at e72fd59: list/status/dashboard expose git and agent-status data only (PROJECT/BRANCH/AGE/PR/AGENT/MUX/UNMERGED/PATH); repo-wide grep for cost/spend/budget/billing/invoice finds only UI width budgets, a 64 MiB transfer byte budget, and claude setup-token auth flows, never usage. No model/API spend, token usage, subscription allowance, compute fees, alerts, export, or drill-down anywhere in src/, skills/, or docs/.
Retrieved: 2026-11-12

## workmux:RUN-08

Finding: Count-based concurrency (--max-concurrent), wait-any wakeups, container CPU/RAM caps, proxy backpressure, and kill/sweep cancellation with resurrect/remote recovery. No host-aware scheduling, check reuse, fairness, or shared-limit model.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-12-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

Scheduling is throttling plus operator cancellation, not a resource-aware scheduler.
No bounded multi-check load test exists or was run.

Source: https://workmux.dev/guide/dashboard/
Locator: Setup; Agents/Worktrees views; Keybindings; Columns; Live preview; Input mode; Sort modes; Sweep
Finding: Optional TUI popup (tmux display-popup binding) requiring status hooks; Agents view (status, git info, PR checks, live preview) and Worktrees view; input mode sends keystrokes to agent; keys jump/diff/commit/merge/kill/remove/sweep; sort by priority/project/recency; sweep bulk-removes merged/gone worktrees.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/sandbox/
Locator: Security model; Agent permission prompts; Container/Lima backends; Threat model
Finding: Container (Docker/Podman/Apple Container) and Lima VM backends isolate agents from host secrets; sandboxed agents get noninteractive prompts with sandbox as boundary; status/dashboard/merge work the same via RPC bridge; documented limits: edits untrusted, host git ops and hooks outside boundary, no hostile-code-containment promise.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/setup/
Locator: Requirements; Server or Docker; Install and check; Supplemental files; Security
Finding: Requires Linux x86-64/ARM64, promptless SSH, git, tmux 3.3+, systemd linger, API access; host mode (no sandbox) vs Docker mode per sandbox.enabled/isolation; server never talks to Git hosting and gets no origin; remote_files allowlist (64 MiB cap); no host-command proxying on servers.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/workflows/
Locator: From terminal; From agent session; Forking; Coordinating; Direct merge; PR-based
Finding: add -A auto-names from prompt; /worktree spins off from running agents; --fork resumes conversations (Claude/Codex/Pi); /coordinator plans+delegates+merges; /merge for direct merge; /open-pr + git push + gh pr create then workmux remove/--gone for PR flow.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/
Locator: Commands overview table
Finding: Command reference inventory: 24 documented command pages (add merge rebase remove rename list status open close resurrect sync-files path shell dashboard sidebar reap-agents config edit init claude prune sandbox remote completions docs update last-done) plus additional CLI-only commands (setup, send, wait, capture, run); no REST API, SDK, MCP server, webhook, or scheduling commands appear in the reference or full docs.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/add/
Locator: Arguments; Options table
Finding: Creates worktree + multiplexer window; --pr checks out GitHub PRs (gh) or GitLab MRs (glab 1.37+, --forge); -A auto-name via llm CLI; --fork/--continue resume; -n/--foreach/--agent multi-generation; -l layouts; --remote/--local placement; -b background; --with-changes moves uncommitted work.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/list/
Locator: Options; Example output; Key; Remote workspaces
Finding: Lists worktrees with AGE, AGENT status icons (incl. counts, text labels when piped), MUX window presence, UNMERGED marker; --pr shows PR status (gh); --json output; remote workspaces listed with remote name, last-known state, and exited reasons such as host reboot.
Retrieved: 2026-11-12

Source: https://workmux.dev/changelog/
Locator: v0.1.282 through v0.1.1 entries with dates
Finding: Latest v0.1.282 (2026-11-10); near-weekly releases through 2026; recent additions: remote servers (v0.1.278), branch auto-name, coordinator commands, Zellij sidebar, Copilot/Grok/agy support; entries describe shipped releases only, no future-dated commitments found.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/skills/coordinator/SKILL.md
Locator: Core Concepts; Command Reference (Spawn/Monitor/Wait/Capture); Cross-project targeting
Finding: Coordinator agent uses workmux add/status/send/capture/wait/run; write-prompts-first-then-spawn; workmux wait with --timeout/--any and exit codes 0/1/2/3; continuous-monitoring invariant across interruptions; cross-project project:handle targeting.
Retrieved: 2026-11-12

## workmux:TEAM-01

Finding: Live human collaboration does not exist in the pinned release: a single-user local binary with no accounts, shared links, discussion, presence, or co-prompting; the dashboard `comment` action steers the operator own agent pane (diff_ops.rs). Bounded inspection of raine/workmux at e72fd59 for collaborat/multi-user/presence/co-prompt/share/sso found no collaboration surfaces.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2027-03-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12



Source: https://workmux.dev/guide/installation/
Locator: Bash/Homebrew/Cargo/mise/Nix methods; Shell alias; Completions; Uninstalling
Finding: Install via install script, Homebrew (macOS/Linux), Cargo, mise, Nix, or prebuilt binaries; shell completions for bash/zsh/fish; uninstall script removes data dirs; no account, signup, or payment step.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/dashboard/
Locator: Setup; Agents/Worktrees views; Keybindings; Columns; Live preview; Input mode; Sort modes; Sweep
Finding: Optional TUI popup (tmux display-popup binding) requiring status hooks; Agents view (status, git info, PR checks, live preview) and Worktrees view; input mode sends keystrokes to agent; keys jump/diff/commit/merge/kill/remove/sweep; sort by priority/project/recency; sweep bulk-removes merged/gone worktrees.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/sandbox/
Locator: Security model; Agent permission prompts; Container/Lima backends; Threat model
Finding: Container (Docker/Podman/Apple Container) and Lima VM backends isolate agents from host secrets; sandboxed agents get noninteractive prompts with sandbox as boundary; status/dashboard/merge work the same via RPC bridge; documented limits: edits untrusted, host git ops and hooks outside boundary, no hostile-code-containment promise.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/
Locator: Overview (Experimental); How it fits together; Quick start
Finding: Experimental: run agents on user-reachable Linux servers over SSH; each remote agent keeps a local tmux window and appears in dashboard/sidebar/status/list as handle@remote; agent keeps working while local machine sleeps, loses network, or closes the window; window reconnects by itself; workmux merge brings work home; local machine stays Git source of truth.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/
Locator: Commands overview table
Finding: Command reference inventory: 24 documented command pages (add merge rebase remove rename list status open close resurrect sync-files path shell dashboard sidebar reap-agents config edit init claude prune sandbox remote completions docs update last-done) plus additional CLI-only commands (setup, send, wait, capture, run); no REST API, SDK, MCP server, webhook, or scheduling commands appear in the reference or full docs.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/src/command/dashboard/diff_ops.rs
Locator: diff_ops.rs send_hunk_comment; state/types.rs and store.rs local JSON; remote/ single-user SSH model
Finding: raine/workmux at e72fd59: the dashboard comment action (diff_ops.rs send_hunk_comment) pastes a hunk-annotated message into the operator own agent pane, which is single-user steering, not shared discussion; state is local per-pane JSON with no user, team, presence, or permission fields; remote servers are the single user SSH machines. Searched collaborat/multi-user/teammate/presence/co-prompt/share/comment/sso across src/, skills/, docs/: no shared visibility, discussion, presence, co-prompting, attribution, or plan-restriction surfaces.
Retrieved: 2026-11-12

## workmux:TEAM-02

Finding: Roles and access boundaries do not exist in the pinned release: no accounts, organizations, roles, membership, SSO, or provisioning; the product runs as the local OS user and remote credentials are the single user SSH keys and agent logins. Bounded inspection of raine/workmux at e72fd59 for sso/organization/role/acl/member found no role or access-boundary enforcement.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2027-03-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12



Source: https://workmux.dev/guide/installation/
Locator: Bash/Homebrew/Cargo/mise/Nix methods; Shell alias; Completions; Uninstalling
Finding: Install via install script, Homebrew (macOS/Linux), Cargo, mise, Nix, or prebuilt binaries; shell completions for bash/zsh/fish; uninstall script removes data dirs; no account, signup, or payment step.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/sandbox/
Locator: Security model; Agent permission prompts; Container/Lima backends; Threat model
Finding: Container (Docker/Podman/Apple Container) and Lima VM backends isolate agents from host secrets; sandboxed agents get noninteractive prompts with sandbox as boundary; status/dashboard/merge work the same via RPC bridge; documented limits: edits untrusted, host git ops and hooks outside boundary, no hostile-code-containment promise.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/setup/
Locator: Requirements; Server or Docker; Install and check; Supplemental files; Security
Finding: Requires Linux x86-64/ARM64, promptless SSH, git, tmux 3.3+, systemd linger, API access; host mode (no sandbox) vs Docker mode per sandbox.enabled/isolation; server never talks to Git hosting and gets no origin; remote_files allowlist (64 MiB cap); no host-command proxying on servers.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/logins/
Locator: Per-agent login table; Copy logins; Claude long-lived token; Environment variables
Finding: remote login runs each agent native login flow (claude/codex/gemini/opencode/pi/omp) with localhost port forwarding; --import does a one-time credential copy (with rotation caveats); setup-token for Claude; sandbox env passthrough read once per workspace and stored privately on server.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/list/
Locator: Options; Example output; Key; Remote workspaces
Finding: Lists worktrees with AGE, AGENT status icons (incl. counts, text labels when piped), MUX window presence, UNMERGED marker; --pr shows PR status (gh); --json output; remote workspaces listed with remote name, last-known state, and exited reasons such as host reboot.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/src/remote/credentials.rs
Locator: config.rs key inventory; remote/credentials.rs SSH and login storage; install guide (no accounts)
Finding: raine/workmux at e72fd59: no accounts, organizations, roles, membership, SSO, or provisioning; the product runs as the local OS user with no signup (install guide); the config schema has no role or permission keys; remote/credentials.rs stores the single user SSH keys and per-agent logins. Searched sso/scim/organization/role/acl/member/policy across src/, skills/, docs/: no role or access-boundary enforcement beyond OS-user execution and sandbox file mounts.
Retrieved: 2026-11-12

## workmux:TEAM-03

Finding: Approvals are agent-level (permission prompts, yolo opt-outs) with the sandbox as the product-enforced boundary; pre_merge hooks gate merges; login-time port forwarding is the only temporary access. No approver identities, lifetimes, or revocation model.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-12-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

Product enforcement is the sandbox boundary plus user hooks; prompt-following behavior belongs to harnesses.
No named approvers, scoped lifetimes, or revocation flow documented.

Source: https://workmux.dev/guide/configuration/
Locator: Two-level system; Remotes; placement; Panes and agent placeholders; File operations; Lifecycle hooks
Finding: Global ~/.config/workmux/config.yaml plus per-project .workmux.yaml; remotes and named agents are global-only; placement selects local or a named remote; panes support <agent> placeholders, splits, sizes; files copy/symlink; post_create/pre_merge/pre_remove hooks.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/claude-code/
Locator: Share permissions; Skip permission prompts (yolo mode); Multiple configurations
Finding: Permission options: symlink .claude/settings.local.json across worktrees, or named agent shadowing claude with --dangerously-skip-permissions; separate work/personal configs via named agents or CLAUDE_CONFIG_DIR.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/status-tracking/
Locator: Agent support table; Status icons; Automated setup; Pi subagents; Interrupted detection; last-done/last-agent
Finding: Supported: Claude Code, OpenCode, Codex, Copilot CLI, Pi, Oh My Pi, Gemini CLI, Grok, Antigravity agy (with version/capability footnotes); Kiro and Mistral Vibe are tracking-issues only; icons working/waiting/done; workmux setup installs hooks; last-done/last-agent navigation; nested-agent opt-out via WORKMUX_DISABLE_SET_WINDOW_STATUS=1.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/dashboard/
Locator: Setup; Agents/Worktrees views; Keybindings; Columns; Live preview; Input mode; Sort modes; Sweep
Finding: Optional TUI popup (tmux display-popup binding) requiring status hooks; Agents view (status, git info, PR checks, live preview) and Worktrees view; input mode sends keystrokes to agent; keys jump/diff/commit/merge/kill/remove/sweep; sort by priority/project/recency; sweep bulk-removes merged/gone worktrees.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/sandbox/
Locator: Security model; Agent permission prompts; Container/Lima backends; Threat model
Finding: Container (Docker/Podman/Apple Container) and Lima VM backends isolate agents from host secrets; sandboxed agents get noninteractive prompts with sandbox as boundary; status/dashboard/merge work the same via RPC bridge; documented limits: edits untrusted, host git ops and hooks outside boundary, no hostile-code-containment promise.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/setup/
Locator: Requirements; Server or Docker; Install and check; Supplemental files; Security
Finding: Requires Linux x86-64/ARM64, promptless SSH, git, tmux 3.3+, systemd linger, API access; host mode (no sandbox) vs Docker mode per sandbox.enabled/isolation; server never talks to Git hosting and gets no origin; remote_files allowlist (64 MiB cap); no host-command proxying on servers.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/logins/
Locator: Per-agent login table; Copy logins; Claude long-lived token; Environment variables
Finding: remote login runs each agent native login flow (claude/codex/gemini/opencode/pi/omp) with localhost port forwarding; --import does a one-time credential copy (with rotation caveats); setup-token for Claude; sandbox env passthrough read once per workspace and stored privately on server.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/merge/
Locator: When to use merge vs remove; Options; Merge strategies; What happens
Finding: Local git merge into main (or --into) with merge/rebase/squash strategies plus worktree+window+branch cleanup; --keep/merge_keep; --notification system notification; PR workflows merge remotely and use remove for cleanup instead.
Retrieved: 2026-11-12

## workmux:TEAM-04

Finding: History lives in git (commits, branches) plus worktree metadata, dashboard diffs, and machine-readable status JSON. No decision records, comments, cross-user persistence, export feature, or integrity model.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-12-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

No audit vocabulary is warranted: no retention, integrity, or tamper model documented.
Machine-readable outputs exist, but no history export feature.

Source: https://workmux.dev/guide/dashboard/
Locator: Setup; Agents/Worktrees views; Keybindings; Columns; Live preview; Input mode; Sort modes; Sweep
Finding: Optional TUI popup (tmux display-popup binding) requiring status hooks; Agents view (status, git info, PR checks, live preview) and Worktrees view; input mode sends keystrokes to agent; keys jump/diff/commit/merge/kill/remove/sweep; sort by priority/project/recency; sweep bulk-removes merged/gone worktrees.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/workflows/
Locator: From terminal; From agent session; Forking; Coordinating; Direct merge; PR-based
Finding: add -A auto-names from prompt; /worktree spins off from running agents; --fork resumes conversations (Claude/Codex/Pi); /coordinator plans+delegates+merges; /merge for direct merge; /open-pr + git push + gh pr create then workmux remove/--gone for PR flow.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/
Locator: Commands overview table
Finding: Command reference inventory: 24 documented command pages (add merge rebase remove rename list status open close resurrect sync-files path shell dashboard sidebar reap-agents config edit init claude prune sandbox remote completions docs update last-done) plus additional CLI-only commands (setup, send, wait, capture, run); no REST API, SDK, MCP server, webhook, or scheduling commands appear in the reference or full docs.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/merge/
Locator: When to use merge vs remove; Options; Merge strategies; What happens
Finding: Local git merge into main (or --into) with merge/rebase/squash strategies plus worktree+window+branch cleanup; --keep/merge_keep; --notification system notification; PR workflows merge remotely and use remove for cleanup instead.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/list/
Locator: Options; Example output; Key; Remote workspaces
Finding: Lists worktrees with AGE, AGENT status icons (incl. counts, text labels when piped), MUX window presence, UNMERGED marker; --pr shows PR status (gh); --json output; remote workspaces listed with remote name, last-known state, and exited reasons such as host reboot.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/status/
Locator: Options; JSON output schema
Finding: Reports tracked agents per repository (or --all/project:handle); --json emits observation with backend context, state-file reconciliation counts, per-agent worktree/branch/status/elapsed/title/pane/git, and target_errors with stable codes.
Retrieved: 2026-11-12

## workmux:TEAM-05

Finding: Dashboard-centered review: waiting-first surfacing, diff/patch evidence with syntax highlighting, PR check links, keyboard-first navigation with mouse option, and commit/merge/sweep actions. No comments, effort data, or guided next-action engine.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-12-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

Findings rest on documentation; the shared review fixture was not executed here.
No commenting, change-request flow, or high-volume triage beyond sort/filter/sweep.

Source: https://workmux.dev/guide/status-tracking/
Locator: Agent support table; Status icons; Automated setup; Pi subagents; Interrupted detection; last-done/last-agent
Finding: Supported: Claude Code, OpenCode, Codex, Copilot CLI, Pi, Oh My Pi, Gemini CLI, Grok, Antigravity agy (with version/capability footnotes); Kiro and Mistral Vibe are tracking-issues only; icons working/waiting/done; workmux setup installs hooks; last-done/last-agent navigation; nested-agent opt-out via WORKMUX_DISABLE_SET_WINDOW_STATUS=1.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/dashboard/
Locator: Setup; Agents/Worktrees views; Keybindings; Columns; Live preview; Input mode; Sort modes; Sweep
Finding: Optional TUI popup (tmux display-popup binding) requiring status hooks; Agents view (status, git info, PR checks, live preview) and Worktrees view; input mode sends keystrokes to agent; keys jump/diff/commit/merge/kill/remove/sweep; sort by priority/project/recency; sweep bulk-removes merged/gone worktrees.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/skills/
Locator: Installation; /workmux /merge /rebase /worktree /coordinator /open-pr
Finding: Six product-shipped skills; workmux setup --skills installs to Claude/OpenCode/Pi/OMP dirs (manual copy documented); dashboard m keybinding triggers /merge; /merge commits/rebases/merges with conflict review; /worktree delegates with --fork option; /coordinator manages full lifecycle.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/workflows/
Locator: From terminal; From agent session; Forking; Coordinating; Direct merge; PR-based
Finding: add -A auto-names from prompt; /worktree spins off from running agents; --fork resumes conversations (Claude/Codex/Pi); /coordinator plans+delegates+merges; /merge for direct merge; /open-pr + git push + gh pr create then workmux remove/--gone for PR flow.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/
Locator: Commands overview table
Finding: Command reference inventory: 24 documented command pages (add merge rebase remove rename list status open close resurrect sync-files path shell dashboard sidebar reap-agents config edit init claude prune sandbox remote completions docs update last-done) plus additional CLI-only commands (setup, send, wait, capture, run); no REST API, SDK, MCP server, webhook, or scheduling commands appear in the reference or full docs.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/merge/
Locator: When to use merge vs remove; Options; Merge strategies; What happens
Finding: Local git merge into main (or --into) with merge/rebase/squash strategies plus worktree+window+branch cleanup; --keep/merge_keep; --notification system notification; PR workflows merge remotely and use remove for cleanup instead.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/list/
Locator: Options; Example output; Key; Remote workspaces
Finding: Lists worktrees with AGE, AGENT status icons (incl. counts, text labels when piped), MUX window presence, UNMERGED marker; --pr shows PR status (gh); --json output; remote workspaces listed with remote name, last-known state, and exited reasons such as host reboot.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/status/
Locator: Options; JSON output schema
Finding: Reports tracked agents per repository (or --all/project:handle); --json emits observation with backend context, state-file reconciliation counts, per-agent worktree/branch/status/elapsed/title/pane/git, and target_errors with stable codes.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/skills/coordinator/SKILL.md
Locator: Core Concepts; Command Reference (Spawn/Monitor/Wait/Capture); Cross-project targeting
Finding: Coordinator agent uses workmux add/status/send/capture/wait/run; write-prompts-first-then-spawn; workmux wait with --timeout/--any and exit codes 0/1/2/3; continuous-monitoring invariant across interruptions; cross-project project:handle targeting.
Retrieved: 2026-11-12

## workmux:TEAM-06

Finding: Colleague takeover does not exist in the pinned release: a single-user tool with no second-user, ownership-transfer, or attribution surfaces; same-user resume (--continue/--fork, resurrect) is explicitly not full takeover. Bounded inspection of raine/workmux at e72fd59 for takeover/handoff/colleague/ownership found no handover surfaces; artifacts move only through git and the filesystem.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2027-03-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12



Source: https://workmux.dev/guide/remote/
Locator: Overview (Experimental); How it fits together; Quick start
Finding: Experimental: run agents on user-reachable Linux servers over SSH; each remote agent keeps a local tmux window and appears in dashboard/sidebar/status/list as handle@remote; agent keeps working while local machine sleeps, loses network, or closes the window; window reconnects by itself; workmux merge brings work home; local machine stays Git source of truth.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/workflows/
Locator: From terminal; From agent session; Forking; Coordinating; Direct merge; PR-based
Finding: add -A auto-names from prompt; /worktree spins off from running agents; --fork resumes conversations (Claude/Codex/Pi); /coordinator plans+delegates+merges; /merge for direct merge; /open-pr + git push + gh pr create then workmux remove/--gone for PR flow.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/
Locator: Commands overview table
Finding: Command reference inventory: 24 documented command pages (add merge rebase remove rename list status open close resurrect sync-files path shell dashboard sidebar reap-agents config edit init claude prune sandbox remote completions docs update last-done) plus additional CLI-only commands (setup, send, wait, capture, run); no REST API, SDK, MCP server, webhook, or scheduling commands appear in the reference or full docs.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/add/
Locator: Arguments; Options table
Finding: Creates worktree + multiplexer window; --pr checks out GitHub PRs (gh) or GitLab MRs (glab 1.37+, --forge); -A auto-name via llm CLI; --fork/--continue resume; -n/--foreach/--agent multi-generation; -l layouts; --remote/--local placement; -b background; --with-changes moves uncommitted work.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/skills/coordinator/SKILL.md
Locator: Core Concepts; Command Reference (Spawn/Monitor/Wait/Capture); Cross-project targeting
Finding: Coordinator agent uses workmux add/status/send/capture/wait/run; write-prompts-first-then-spawn; workmux wait with --timeout/--any and exit codes 0/1/2/3; continuous-monitoring invariant across interruptions; cross-project project:handle targeting.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/src/multiplexer/conversation.rs
Locator: conversation.rs ConversationForker per-harness resume; workflow/create.rs fork and continue; resurrect flow
Finding: raine/workmux at e72fd59: --continue/--fork resume the same user same-harness conversation from that harness own store (per-harness ConversationForker implementations); switching harness requires a new worktree via -a; resurrect restores windows after crashes for the same user and machine. Searched takeover/handoff/colleague/second-user/ownership/attribution across src/, skills/, docs/: no second-user, ownership-transfer, or attribution surfaces; artifacts (branches, files) move only through git and the filesystem, not product takeover.
Retrieved: 2026-11-12

## workmux:SHIP-01

Finding: Diff/patch review with file navigation, live terminal previews, PR links, and post-merge cleanup; prompt files and logs persist until removed. No artifact gallery, recordings, revision pinning, or leak analysis.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-12-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

Retention ends at cleanup: removal deletes the worktree and its review context.
Reopening findings relies on harness history and git, not a product gallery.

Source: https://workmux.dev/guide/configuration/
Locator: Two-level system; Remotes; placement; Panes and agent placeholders; File operations; Lifecycle hooks
Finding: Global ~/.config/workmux/config.yaml plus per-project .workmux.yaml; remotes and named agents are global-only; placement selects local or a named remote; panes support <agent> placeholders, splits, sizes; files copy/symlink; post_create/pre_merge/pre_remove hooks.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/dashboard/
Locator: Setup; Agents/Worktrees views; Keybindings; Columns; Live preview; Input mode; Sort modes; Sweep
Finding: Optional TUI popup (tmux display-popup binding) requiring status hooks; Agents view (status, git info, PR checks, live preview) and Worktrees view; input mode sends keystrokes to agent; keys jump/diff/commit/merge/kill/remove/sweep; sort by priority/project/recency; sweep bulk-removes merged/gone worktrees.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/
Locator: Overview (Experimental); How it fits together; Quick start
Finding: Experimental: run agents on user-reachable Linux servers over SSH; each remote agent keeps a local tmux window and appears in dashboard/sidebar/status/list as handle@remote; agent keeps working while local machine sleeps, loses network, or closes the window; window reconnects by itself; workmux merge brings work home; local machine stays Git source of truth.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/workflows/
Locator: From terminal; From agent session; Forking; Coordinating; Direct merge; PR-based
Finding: add -A auto-names from prompt; /worktree spins off from running agents; --fork resumes conversations (Claude/Codex/Pi); /coordinator plans+delegates+merges; /merge for direct merge; /open-pr + git push + gh pr create then workmux remove/--gone for PR flow.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/merge/
Locator: When to use merge vs remove; Options; Merge strategies; What happens
Finding: Local git merge into main (or --into) with merge/rebase/squash strategies plus worktree+window+branch cleanup; --keep/merge_keep; --notification system notification; PR workflows merge remotely and use remove for cleanup instead.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/list/
Locator: Options; Example output; Key; Remote workspaces
Finding: Lists worktrees with AGE, AGENT status icons (incl. counts, text labels when piped), MUX window presence, UNMERGED marker; --pr shows PR status (gh); --json output; remote workspaces listed with remote name, last-known state, and exited reasons such as host reboot.
Retrieved: 2026-11-12

## workmux:SHIP-02

Finding: User-configured hooks and panes run tests/lint/types/CI with pre_merge abort; coordinator and human diff review act as independent review. No built-in gates, required checks, or spec conformance.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-12-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

All verification is user-configured; the product ships no default required checks.
An agent saying checks passed is not a gate: only hook exit codes and human review enforce.

Source: https://workmux.dev/guide/configuration/
Locator: Two-level system; Remotes; placement; Panes and agent placeholders; File operations; Lifecycle hooks
Finding: Global ~/.config/workmux/config.yaml plus per-project .workmux.yaml; remotes and named agents are global-only; placement selects local or a named remote; panes support <agent> placeholders, splits, sizes; files copy/symlink; post_create/pre_merge/pre_remove hooks.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/dashboard/
Locator: Setup; Agents/Worktrees views; Keybindings; Columns; Live preview; Input mode; Sort modes; Sweep
Finding: Optional TUI popup (tmux display-popup binding) requiring status hooks; Agents view (status, git info, PR checks, live preview) and Worktrees view; input mode sends keystrokes to agent; keys jump/diff/commit/merge/kill/remove/sweep; sort by priority/project/recency; sweep bulk-removes merged/gone worktrees.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/sandbox/
Locator: Security model; Agent permission prompts; Container/Lima backends; Threat model
Finding: Container (Docker/Podman/Apple Container) and Lima VM backends isolate agents from host secrets; sandboxed agents get noninteractive prompts with sandbox as boundary; status/dashboard/merge work the same via RPC bridge; documented limits: edits untrusted, host git ops and hooks outside boundary, no hostile-code-containment promise.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/skills/
Locator: Installation; /workmux /merge /rebase /worktree /coordinator /open-pr
Finding: Six product-shipped skills; workmux setup --skills installs to Claude/OpenCode/Pi/OMP dirs (manual copy documented); dashboard m keybinding triggers /merge; /merge commits/rebases/merges with conflict review; /worktree delegates with --fork option; /coordinator manages full lifecycle.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/merge/
Locator: When to use merge vs remove; Options; Merge strategies; What happens
Finding: Local git merge into main (or --into) with merge/rebase/squash strategies plus worktree+window+branch cleanup; --keep/merge_keep; --notification system notification; PR workflows merge remotely and use remove for cleanup instead.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/list/
Locator: Options; Example output; Key; Remote workspaces
Finding: Lists worktrees with AGE, AGENT status icons (incl. counts, text labels when piped), MUX window presence, UNMERGED marker; --pr shows PR status (gh); --json output; remote workspaces listed with remote name, last-known state, and exited reasons such as host reboot.
Retrieved: 2026-11-12

## workmux:SHIP-03

Finding: Branch/worktree lifecycle with agent-driven commits, rebase command + skill with conflict intelligence, PR checkout/creation flow via gh, PR-check surfacing, and post-merge cleanup. No inline review comments or product-owned PR state.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-12-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

Commits and PR creation are agent/CLI-assisted, not product-native operations.
Review comments and CI responses live in the hosting UI; workmux surfaces awareness only.

Source: https://workmux.dev/guide/dashboard/
Locator: Setup; Agents/Worktrees views; Keybindings; Columns; Live preview; Input mode; Sort modes; Sweep
Finding: Optional TUI popup (tmux display-popup binding) requiring status hooks; Agents view (status, git info, PR checks, live preview) and Worktrees view; input mode sends keystrokes to agent; keys jump/diff/commit/merge/kill/remove/sweep; sort by priority/project/recency; sweep bulk-removes merged/gone worktrees.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/skills/
Locator: Installation; /workmux /merge /rebase /worktree /coordinator /open-pr
Finding: Six product-shipped skills; workmux setup --skills installs to Claude/OpenCode/Pi/OMP dirs (manual copy documented); dashboard m keybinding triggers /merge; /merge commits/rebases/merges with conflict review; /worktree delegates with --fork option; /coordinator manages full lifecycle.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/workflows/
Locator: From terminal; From agent session; Forking; Coordinating; Direct merge; PR-based
Finding: add -A auto-names from prompt; /worktree spins off from running agents; --fork resumes conversations (Claude/Codex/Pi); /coordinator plans+delegates+merges; /merge for direct merge; /open-pr + git push + gh pr create then workmux remove/--gone for PR flow.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/
Locator: Commands overview table
Finding: Command reference inventory: 24 documented command pages (add merge rebase remove rename list status open close resurrect sync-files path shell dashboard sidebar reap-agents config edit init claude prune sandbox remote completions docs update last-done) plus additional CLI-only commands (setup, send, wait, capture, run); no REST API, SDK, MCP server, webhook, or scheduling commands appear in the reference or full docs.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/add/
Locator: Arguments; Options table
Finding: Creates worktree + multiplexer window; --pr checks out GitHub PRs (gh) or GitLab MRs (glab 1.37+, --forge); -A auto-name via llm CLI; --fork/--continue resume; -n/--foreach/--agent multi-generation; -l layouts; --remote/--local placement; -b background; --with-changes moves uncommitted work.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/merge/
Locator: When to use merge vs remove; Options; Merge strategies; What happens
Finding: Local git merge into main (or --into) with merge/rebase/squash strategies plus worktree+window+branch cleanup; --keep/merge_keep; --notification system notification; PR workflows merge remotely and use remove for cleanup instead.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/list/
Locator: Options; Example output; Key; Remote workspaces
Finding: Lists worktrees with AGE, AGENT status icons (incl. counts, text labels when piped), MUX window presence, UNMERGED marker; --pr shows PR status (gh); --json output; remote workspaces listed with remote name, last-known state, and exited reasons such as host reboot.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/status/
Locator: Options; JSON output schema
Finding: Reports tracked agents per repository (or --all/project:handle); --json emits observation with backend context, state-file reconciliation counts, per-agent worktree/branch/status/elapsed/title/pane/git, and target_errors with stable codes.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/skills/open-pr/SKILL.md
Locator: Gather context; Write PR description; Create the PR
Finding: Template skill that drafts PR description from diff/commits and runs gh pr create --web to open creation in the browser; explicitly does not create the PR directly.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/git-worktree-caveats/
Locator: Gitignored files; Conflicts; Package manager considerations
Finding: New worktrees are clean checkouts needing files copy/symlink config; parallel branches can still conflict on merge; per-worktree installs recommended; node_modules cleanup handled in background.
Retrieved: 2026-11-12

## workmux:SHIP-04

Finding: The local user approves and merges (merge/rebase/squash strategies, --into targets, keep controls); pre_merge hooks gate merges. No release pipeline, deployment authority, or multi-party approval.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-12-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

Single-user authority: no approver roles or deployment targets.
Exact-revision guarantees are git semantics; no product revision pinning.

Source: https://workmux.dev/guide/configuration/
Locator: Two-level system; Remotes; placement; Panes and agent placeholders; File operations; Lifecycle hooks
Finding: Global ~/.config/workmux/config.yaml plus per-project .workmux.yaml; remotes and named agents are global-only; placement selects local or a named remote; panes support <agent> placeholders, splits, sizes; files copy/symlink; post_create/pre_merge/pre_remove hooks.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/sandbox/
Locator: Security model; Agent permission prompts; Container/Lima backends; Threat model
Finding: Container (Docker/Podman/Apple Container) and Lima VM backends isolate agents from host secrets; sandboxed agents get noninteractive prompts with sandbox as boundary; status/dashboard/merge work the same via RPC bridge; documented limits: edits untrusted, host git ops and hooks outside boundary, no hostile-code-containment promise.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/workflows/
Locator: From terminal; From agent session; Forking; Coordinating; Direct merge; PR-based
Finding: add -A auto-names from prompt; /worktree spins off from running agents; --fork resumes conversations (Claude/Codex/Pi); /coordinator plans+delegates+merges; /merge for direct merge; /open-pr + git push + gh pr create then workmux remove/--gone for PR flow.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/merge/
Locator: When to use merge vs remove; Options; Merge strategies; What happens
Finding: Local git merge into main (or --into) with merge/rebase/squash strategies plus worktree+window+branch cleanup; --keep/merge_keep; --notification system notification; PR workflows merge remotely and use remove for cleanup instead.
Retrieved: 2026-11-12

## workmux:SHIP-05

Finding: Branch-to-PR links with check status, merge-then-cleanup delivery states, sweep staleness reasons, and git/log/prompt evidence until cleanup. No rollback/revert commands and no stale-approval model.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-12-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

Undo is manual git (revert/reflog), not a product operation.
Delivery status ends at merge/cleanup; deployments are out of scope.

Source: https://workmux.dev/guide/dashboard/
Locator: Setup; Agents/Worktrees views; Keybindings; Columns; Live preview; Input mode; Sort modes; Sweep
Finding: Optional TUI popup (tmux display-popup binding) requiring status hooks; Agents view (status, git info, PR checks, live preview) and Worktrees view; input mode sends keystrokes to agent; keys jump/diff/commit/merge/kill/remove/sweep; sort by priority/project/recency; sweep bulk-removes merged/gone worktrees.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/skills/
Locator: Installation; /workmux /merge /rebase /worktree /coordinator /open-pr
Finding: Six product-shipped skills; workmux setup --skills installs to Claude/OpenCode/Pi/OMP dirs (manual copy documented); dashboard m keybinding triggers /merge; /merge commits/rebases/merges with conflict review; /worktree delegates with --fork option; /coordinator manages full lifecycle.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/workflows/
Locator: From terminal; From agent session; Forking; Coordinating; Direct merge; PR-based
Finding: add -A auto-names from prompt; /worktree spins off from running agents; --fork resumes conversations (Claude/Codex/Pi); /coordinator plans+delegates+merges; /merge for direct merge; /open-pr + git push + gh pr create then workmux remove/--gone for PR flow.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/
Locator: Commands overview table
Finding: Command reference inventory: 24 documented command pages (add merge rebase remove rename list status open close resurrect sync-files path shell dashboard sidebar reap-agents config edit init claude prune sandbox remote completions docs update last-done) plus additional CLI-only commands (setup, send, wait, capture, run); no REST API, SDK, MCP server, webhook, or scheduling commands appear in the reference or full docs.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/merge/
Locator: When to use merge vs remove; Options; Merge strategies; What happens
Finding: Local git merge into main (or --into) with merge/rebase/squash strategies plus worktree+window+branch cleanup; --keep/merge_keep; --notification system notification; PR workflows merge remotely and use remove for cleanup instead.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/list/
Locator: Options; Example output; Key; Remote workspaces
Finding: Lists worktrees with AGE, AGENT status icons (incl. counts, text labels when piped), MUX window presence, UNMERGED marker; --pr shows PR status (gh); --json output; remote workspaces listed with remote name, last-known state, and exited reasons such as host reboot.
Retrieved: 2026-11-12

## workmux:SHIP-06

Finding: Dashboard Agents/Worktrees tables form a review queue (sort/filter/jump, diff, input-steer, commit/merge keys) with sweep bulk-removal of merged/gone work. No summaries, risk scoring, revision approvals, merge queues, or dedup.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-12-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

Batch review is per-agent triage, not a coordinated release queue: no dependency ordering or approval pinning.
The six-plus-item fixture review was not executed hands-on here.

Source: https://workmux.dev/guide/dashboard/
Locator: Setup; Agents/Worktrees views; Keybindings; Columns; Live preview; Input mode; Sort modes; Sweep
Finding: Optional TUI popup (tmux display-popup binding) requiring status hooks; Agents view (status, git info, PR checks, live preview) and Worktrees view; input mode sends keystrokes to agent; keys jump/diff/commit/merge/kill/remove/sweep; sort by priority/project/recency; sweep bulk-removes merged/gone worktrees.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/skills/
Locator: Installation; /workmux /merge /rebase /worktree /coordinator /open-pr
Finding: Six product-shipped skills; workmux setup --skills installs to Claude/OpenCode/Pi/OMP dirs (manual copy documented); dashboard m keybinding triggers /merge; /merge commits/rebases/merges with conflict review; /worktree delegates with --fork option; /coordinator manages full lifecycle.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/workflows/
Locator: From terminal; From agent session; Forking; Coordinating; Direct merge; PR-based
Finding: add -A auto-names from prompt; /worktree spins off from running agents; --fork resumes conversations (Claude/Codex/Pi); /coordinator plans+delegates+merges; /merge for direct merge; /open-pr + git push + gh pr create then workmux remove/--gone for PR flow.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/list/
Locator: Options; Example output; Key; Remote workspaces
Finding: Lists worktrees with AGE, AGENT status icons (incl. counts, text labels when piped), MUX window presence, UNMERGED marker; --pr shows PR status (gh); --json output; remote workspaces listed with remote name, last-known state, and exited reasons such as host reboot.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/skills/coordinator/SKILL.md
Locator: Core Concepts; Command Reference (Spawn/Monitor/Wait/Capture); Cross-project targeting
Finding: Coordinator agent uses workmux add/status/send/capture/wait/run; write-prompts-first-then-spawn; workmux wait with --timeout/--any and exit codes 0/1/2/3; continuous-monitoring invariant across interruptions; cross-project project:handle targeting.
Retrieved: 2026-11-12

## workmux:OWN-01

Finding: MIT-licensed Rust binary and repository (LICENSE + Cargo.toml at pinned v0.1.282); public source on GitHub; no component or hosted-service exceptions.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2027-02-10
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12



Source: https://workmux.dev/
Locator: Hero; Remote servers; How it works; Skills; Setup sections
Finding: Terminal-first workflow for parallel AI agents using git worktrees: one task per worktree and tmux window, sidebar and dashboard for agent status, sandbox containment, SSH remote servers, agent skills; described as free and open source.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux
Locator: Repository header, About box, README
Finding: Owner raine (Raine Virta); description "git worktrees + tmux windows for zero-friction parallel dev"; homepage https://workmux.dev/; MIT license; default branch main; not archived.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/Cargo.toml
Locator: package name/version/edition/license/documentation fields
Finding: Rust binary crate name workmux, version 0.1.282, edition 2024, license MIT; homepage and repository point at github.com/raine/workmux.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/LICENSE
Locator: Full license text
Finding: MIT License grant; copyright (c) 2025 workmux contributors; no component exceptions in the file.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/setup/
Locator: Requirements; Server or Docker; Install and check; Supplemental files; Security
Finding: Requires Linux x86-64/ARM64, promptless SSH, git, tmux 3.3+, systemd linger, API access; host mode (no sandbox) vs Docker mode per sandbox.enabled/isolation; server never talks to Git hosting and gets no origin; remote_files allowlist (64 MiB cap); no host-command proxying on servers.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/releases/tag/v0.1.282
Locator: Release header
Finding: Tag v0.1.282 published 2026-11-10; most recent release observed 2026-11-12.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/update/
Locator: Supported platforms; Automatic update check; Requirements
Finding: Prebuilt binaries for macOS (Apple Silicon/Intel) and Linux (x86_64/ARM64); background update check at most daily, disableable via auto_update_check:false or WORKMUX_NO_UPDATE_CHECK=1; update verifies checksums, Homebrew installs defer to brew.
Retrieved: 2026-11-12

## workmux:OWN-02

Finding: Self-contained local binary with no vendor service, accounts, or required backends; code is git-portable and uninstall removes data dirs. Product state files have no documented portability contract.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2027-02-10
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

State-file portability (agents dir, workmux.log) has no documented format contract.
Agent-side history portability belongs to each harness, not the product.

Source: https://github.com/raine/workmux
Locator: Repository header, About box, README
Finding: Owner raine (Raine Virta); description "git worktrees + tmux windows for zero-friction parallel dev"; homepage https://workmux.dev/; MIT license; default branch main; not archived.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/installation/
Locator: Bash/Homebrew/Cargo/mise/Nix methods; Shell alias; Completions; Uninstalling
Finding: Install via install script, Homebrew (macOS/Linux), Cargo, mise, Nix, or prebuilt binaries; shell completions for bash/zsh/fish; uninstall script removes data dirs; no account, signup, or payment step.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/quick-start/
Locator: Prerequisites; steps 1-5; The parallel AI workflow
Finding: Prerequisites: Git 2.5+ and tmux (or WezTerm/kitty/Zellij); flow is install, optional workmux init, workmux add (creates worktree + window + panes + setup), work, workmux merge cleanup; /worktree skill recommended from inside agent sessions.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/
Locator: Overview (Experimental); How it fits together; Quick start
Finding: Experimental: run agents on user-reachable Linux servers over SSH; each remote agent keeps a local tmux window and appears in dashboard/sidebar/status/list as handle@remote; agent keeps working while local machine sleeps, loses network, or closes the window; window reconnects by itself; workmux merge brings work home; local machine stays Git source of truth.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/setup/
Locator: Requirements; Server or Docker; Install and check; Supplemental files; Security
Finding: Requires Linux x86-64/ARM64, promptless SSH, git, tmux 3.3+, systemd linger, API access; host mode (no sandbox) vs Docker mode per sandbox.enabled/isolation; server never talks to Git hosting and gets no origin; remote_files allowlist (64 MiB cap); no host-command proxying on servers.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/logins/
Locator: Per-agent login table; Copy logins; Claude long-lived token; Environment variables
Finding: remote login runs each agent native login flow (claude/codex/gemini/opencode/pi/omp) with localhost port forwarding; --import does a one-time credential copy (with rotation caveats); setup-token for Claude; sandbox env passthrough read once per workspace and stored privately on server.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/workflows/
Locator: From terminal; From agent session; Forking; Coordinating; Direct merge; PR-based
Finding: add -A auto-names from prompt; /worktree spins off from running agents; --fork resumes conversations (Claude/Codex/Pi); /coordinator plans+delegates+merges; /merge for direct merge; /open-pr + git push + gh pr create then workmux remove/--gone for PR flow.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/add/
Locator: Arguments; Options table
Finding: Creates worktree + multiplexer window; --pr checks out GitHub PRs (gh) or GitLab MRs (glab 1.37+, --forge); -A auto-name via llm CLI; --fork/--continue resume; -n/--foreach/--agent multi-generation; -l layouts; --remote/--local placement; -b background; --with-changes moves uncommitted work.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/merge/
Locator: When to use merge vs remove; Options; Merge strategies; What happens
Finding: Local git merge into main (or --into) with merge/rebase/squash strategies plus worktree+window+branch cleanup; --keep/merge_keep; --notification system notification; PR workflows merge remotely and use remove for cleanup instead.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/list/
Locator: Options; Example output; Key; Remote workspaces
Finding: Lists worktrees with AGE, AGENT status icons (incl. counts, text labels when piped), MUX window presence, UNMERGED marker; --pr shows PR status (gh); --json output; remote workspaces listed with remote name, last-known state, and exited reasons such as host reboot.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/status/
Locator: Options; JSON output schema
Finding: Reports tracked agents per repository (or --all/project:handle); --json emits observation with backend context, state-file reconciliation counts, per-agent worktree/branch/status/elapsed/title/pane/git, and target_errors with stable codes.
Retrieved: 2026-11-12

## workmux:OWN-03

Finding: Code, prompts, credentials, and logs stay on user machines or user-owned servers; sandboxes exclude host secrets. No telemetry policy disclosed; only documented network behaviors are the daily update check (disableable) and release downloads.

Verification: sourced
Checked: 2026-11-12
Scheduled recheck: 2026-12-12
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

No telemetry or data-handling policy page exists; assessment rests on architecture plus the two documented network behaviors.
Model-provider data use belongs to each harness and its own policy.

Source: https://workmux.dev/guide/installation/
Locator: Bash/Homebrew/Cargo/mise/Nix methods; Shell alias; Completions; Uninstalling
Finding: Install via install script, Homebrew (macOS/Linux), Cargo, mise, Nix, or prebuilt binaries; shell completions for bash/zsh/fish; uninstall script removes data dirs; no account, signup, or payment step.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/configuration/
Locator: Two-level system; Remotes; placement; Panes and agent placeholders; File operations; Lifecycle hooks
Finding: Global ~/.config/workmux/config.yaml plus per-project .workmux.yaml; remotes and named agents are global-only; placement selects local or a named remote; panes support <agent> placeholders, splits, sizes; files copy/symlink; post_create/pre_merge/pre_remove hooks.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/agents/
Locator: Agent integration; Named agents; Per-pane agents; Parallel workflows
Finding: Built-in agents: claude, codex, copilot, opencode, gemini, agy, kiro-cli, vibe, pi, omp, grok; prompt injection via -p/-P/-e without config changes; named global profiles with type/command/args/env (incl. from_env); multi-worktree generation (-a/-n/--foreach) e.g. one worktree each for claude and gemini.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/status-tracking/
Locator: Agent support table; Status icons; Automated setup; Pi subagents; Interrupted detection; last-done/last-agent
Finding: Supported: Claude Code, OpenCode, Codex, Copilot CLI, Pi, Oh My Pi, Gemini CLI, Grok, Antigravity agy (with version/capability footnotes); Kiro and Mistral Vibe are tracking-issues only; icons working/waiting/done; workmux setup installs hooks; last-done/last-agent navigation; nested-agent opt-out via WORKMUX_DISABLE_SET_WINDOW_STATUS=1.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/dashboard/
Locator: Setup; Agents/Worktrees views; Keybindings; Columns; Live preview; Input mode; Sort modes; Sweep
Finding: Optional TUI popup (tmux display-popup binding) requiring status hooks; Agents view (status, git info, PR checks, live preview) and Worktrees view; input mode sends keystrokes to agent; keys jump/diff/commit/merge/kill/remove/sweep; sort by priority/project/recency; sweep bulk-removes merged/gone worktrees.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/sandbox/
Locator: Security model; Agent permission prompts; Container/Lima backends; Threat model
Finding: Container (Docker/Podman/Apple Container) and Lima VM backends isolate agents from host secrets; sandboxed agents get noninteractive prompts with sandbox as boundary; status/dashboard/merge work the same via RPC bridge; documented limits: edits untrusted, host git ops and hooks outside boundary, no hostile-code-containment promise.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/
Locator: Overview (Experimental); How it fits together; Quick start
Finding: Experimental: run agents on user-reachable Linux servers over SSH; each remote agent keeps a local tmux window and appears in dashboard/sidebar/status/list as handle@remote; agent keeps working while local machine sleeps, loses network, or closes the window; window reconnects by itself; workmux merge brings work home; local machine stays Git source of truth.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/setup/
Locator: Requirements; Server or Docker; Install and check; Supplemental files; Security
Finding: Requires Linux x86-64/ARM64, promptless SSH, git, tmux 3.3+, systemd linger, API access; host mode (no sandbox) vs Docker mode per sandbox.enabled/isolation; server never talks to Git hosting and gets no origin; remote_files allowlist (64 MiB cap); no host-command proxying on servers.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/logins/
Locator: Per-agent login table; Copy logins; Claude long-lived token; Environment variables
Finding: remote login runs each agent native login flow (claude/codex/gemini/opencode/pi/omp) with localhost port forwarding; --import does a one-time credential copy (with rotation caveats); setup-token for Claude; sandbox env passthrough read once per workspace and stored privately on server.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/workflows/
Locator: From terminal; From agent session; Forking; Coordinating; Direct merge; PR-based
Finding: add -A auto-names from prompt; /worktree spins off from running agents; --fork resumes conversations (Claude/Codex/Pi); /coordinator plans+delegates+merges; /merge for direct merge; /open-pr + git push + gh pr create then workmux remove/--gone for PR flow.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/git-worktree-caveats/
Locator: Gitignored files; Conflicts; Package manager considerations
Finding: New worktrees are clean checkouts needing files copy/symlink config; parallel branches can still conflict on merge; per-worktree installs recommended; node_modules cleanup handled in background.
Retrieved: 2026-11-12

Source: https://workmux.dev/reference/commands/update/
Locator: Supported platforms; Automatic update check; Requirements
Finding: Prebuilt binaries for macOS (Apple Silicon/Intel) and Linux (x86_64/ARM64); background update check at most daily, disableable via auto_update_check:false or WORKMUX_NO_UPDATE_CHECK=1; update verifies checksums, Homebrew installs defer to brew.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/src/config.rs
Locator: Config key inventory; src/command/update.rs check_and_notify; bounded src/Cargo.toml/Cargo.lock search for telemetry, analytics, PostHog, Sentry, Segment and Mixpanel
Finding: The pinned product has no telemetry configuration or telemetry implementation in the inspected source/dependency inventory. Its network opt-out auto_update_check/WORKMUX_NO_UPDATE_CHECK disables update checking, not product telemetry. Provider-owned agent traffic remains separate.
Retrieved: 2026-11-13

## workmux:OWN-04

Finding: Workmux is a free MIT-licensed application with no paid Workmux tier. Model use runs through the selected coding agent credentials; sandbox setup explicitly supports the user Anthropic API key. Provider usage and user compute are separate costs.

Verification: sourced
Checked: 2026-11-12
Scheduled recheck: 2026-11-26
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

The free application includes no hosted model allowance. Agent/model usage and user-operated compute have separate costs and limits.

Source: https://workmux.dev/
Locator: Hero; Remote servers; How it works; Skills; Setup sections
Finding: Terminal-first workflow for parallel AI agents using git worktrees: one task per worktree and tmux window, sidebar and dashboard for agent status, sandbox containment, SSH remote servers, agent skills; described as free and open source.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux
Locator: Repository header, About box, README
Finding: Owner raine (Raine Virta); description "git worktrees + tmux windows for zero-friction parallel dev"; homepage https://workmux.dev/; MIT license; default branch main; not archived.
Retrieved: 2026-11-12

Source: https://raw.githubusercontent.com/raine/workmux/main/README.md
Locator: Why workmux; Features; Installation; Community videos
Finding: Manages git worktrees + tmux windows for parallel AI agents; features dashboard, sidebar, /worktree skill, agent status tracking, sandbox, remote servers, branch-name generation; install via script/Homebrew/Cargo/mise/Nix; philosophy "tmux is the interface".
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/installation/
Locator: Bash/Homebrew/Cargo/mise/Nix methods; Shell alias; Completions; Uninstalling
Finding: Install via install script, Homebrew (macOS/Linux), Cargo, mise, Nix, or prebuilt binaries; shell completions for bash/zsh/fish; uninstall script removes data dirs; no account, signup, or payment step.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/configuration/
Locator: Two-level system; Remotes; placement; Panes and agent placeholders; File operations; Lifecycle hooks
Finding: Global ~/.config/workmux/config.yaml plus per-project .workmux.yaml; remotes and named agents are global-only; placement selects local or a named remote; panes support <agent> placeholders, splits, sizes; files copy/symlink; post_create/pre_merge/pre_remove hooks.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/
Locator: Overview (Experimental); How it fits together; Quick start
Finding: Experimental: run agents on user-reachable Linux servers over SSH; each remote agent keeps a local tmux window and appears in dashboard/sidebar/status/list as handle@remote; agent keeps working while local machine sleeps, loses network, or closes the window; window reconnects by itself; workmux merge brings work home; local machine stays Git source of truth.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/setup/
Locator: Requirements; Server or Docker; Install and check; Supplemental files; Security
Finding: Requires Linux x86-64/ARM64, promptless SSH, git, tmux 3.3+, systemd linger, API access; host mode (no sandbox) vs Docker mode per sandbox.enabled/isolation; server never talks to Git hosting and gets no origin; remote_files allowlist (64 MiB cap); no host-command proxying on servers.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/logins/
Locator: Per-agent login table; Copy logins; Claude long-lived token; Environment variables
Finding: remote login runs each agent native login flow (claude/codex/gemini/opencode/pi/omp) with localhost port forwarding; --import does a one-time credential copy (with rotation caveats); setup-token for Claude; sandbox env passthrough read once per workspace and stored privately on server.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/sandbox/container/
Locator: Configuration: env_passthrough; Example configurations: Podman with ANTHROPIC_API_KEY
Finding: The official agent-container setup explicitly passes the host ANTHROPIC_API_KEY into the selected coding-agent sandbox through the global env_passthrough setting. This is own-provider-key model access, separate from the free Workmux binary and any provider usage bill.
Retrieved: 2026-11-13

## workmux:OWN-05

Finding: Platform cost is $0 for one, two, or five developers (each installs the free binary on own hardware). Variable costs are agent subscriptions/API usage and any user-owned server spend, both unpriced in product sources.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-11-26
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

Variable costs (agent plans, API meters, server bills) are unknown from product sources and excluded from the $0 figure.
No per-task token/time assumptions exist to price; the catalog forbids inventing task costs.

Source: https://workmux.dev/
Locator: Hero; Remote servers; How it works; Skills; Setup sections
Finding: Terminal-first workflow for parallel AI agents using git worktrees: one task per worktree and tmux window, sidebar and dashboard for agent status, sandbox containment, SSH remote servers, agent skills; described as free and open source.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux
Locator: Repository header, About box, README
Finding: Owner raine (Raine Virta); description "git worktrees + tmux windows for zero-friction parallel dev"; homepage https://workmux.dev/; MIT license; default branch main; not archived.
Retrieved: 2026-11-12

Source: https://raw.githubusercontent.com/raine/workmux/main/README.md
Locator: Why workmux; Features; Installation; Community videos
Finding: Manages git worktrees + tmux windows for parallel AI agents; features dashboard, sidebar, /worktree skill, agent status tracking, sandbox, remote servers, branch-name generation; install via script/Homebrew/Cargo/mise/Nix; philosophy "tmux is the interface".
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/installation/
Locator: Bash/Homebrew/Cargo/mise/Nix methods; Shell alias; Completions; Uninstalling
Finding: Install via install script, Homebrew (macOS/Linux), Cargo, mise, Nix, or prebuilt binaries; shell completions for bash/zsh/fish; uninstall script removes data dirs; no account, signup, or payment step.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/quick-start/
Locator: Prerequisites; steps 1-5; The parallel AI workflow
Finding: Prerequisites: Git 2.5+ and tmux (or WezTerm/kitty/Zellij); flow is install, optional workmux init, workmux add (creates worktree + window + panes + setup), work, workmux merge cleanup; /worktree skill recommended from inside agent sessions.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/setup/
Locator: Requirements; Server or Docker; Install and check; Supplemental files; Security
Finding: Requires Linux x86-64/ARM64, promptless SSH, git, tmux 3.3+, systemd linger, API access; host mode (no sandbox) vs Docker mode per sandbox.enabled/isolation; server never talks to Git hosting and gets no origin; remote_files allowlist (64 MiB cap); no host-command proxying on servers.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/logins/
Locator: Per-agent login table; Copy logins; Claude long-lived token; Environment variables
Finding: remote login runs each agent native login flow (claude/codex/gemini/opencode/pi/omp) with localhost port forwarding; --import does a one-time credential copy (with rotation caveats); setup-token for Claude; sandbox env passthrough read once per workspace and stored privately on server.
Retrieved: 2026-11-12

Source: https://workmux.dev/changelog/
Locator: v0.1.282 through v0.1.1 entries with dates
Finding: Latest v0.1.282 (2026-11-10); near-weekly releases through 2026; recent additions: remote servers (v0.1.278), branch auto-name, coordinator commands, Zellij sidebar, Copilot/Grok/agy support; entries describe shipped releases only, no future-dated commitments found.
Retrieved: 2026-11-12

## workmux:OWN-06

Finding: Actively maintained 0.x (v0.1.282 on 2026-11-10, weekly cadence) with public docs, changelog, and GitHub-issue support; experimental subsystems flagged. No SLA, status page, or access restrictions.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-11-26
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

0.x versioning with explicitly experimental backends (remote, kitty/WezTerm/Zellij); availability beta reflects that, not downtime.
No support commitments, status history, or deprecation policy documented.

Source: https://github.com/raine/workmux
Locator: Repository header, About box, README
Finding: Owner raine (Raine Virta); description "git worktrees + tmux windows for zero-friction parallel dev"; homepage https://workmux.dev/; MIT license; default branch main; not archived.
Retrieved: 2026-11-12

Source: https://api.github.com/repos/raine/workmux
Locator: stargazers_count; pushed_at; license; owner; open_issues_count
Finding: 3037 stars, 314 forks, 64 open issues observed 2026-11-12; pushed 2026-11-10; MIT license; owner login raine.
Retrieved: 2026-11-12

Source: https://raw.githubusercontent.com/raine/workmux/main/README.md
Locator: Why workmux; Features; Installation; Community videos
Finding: Manages git worktrees + tmux windows for parallel AI agents; features dashboard, sidebar, /worktree skill, agent status tracking, sandbox, remote servers, branch-name generation; install via script/Homebrew/Cargo/mise/Nix; philosophy "tmux is the interface".
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/installation/
Locator: Bash/Homebrew/Cargo/mise/Nix methods; Shell alias; Completions; Uninstalling
Finding: Install via install script, Homebrew (macOS/Linux), Cargo, mise, Nix, or prebuilt binaries; shell completions for bash/zsh/fish; uninstall script removes data dirs; no account, signup, or payment step.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/
Locator: Overview (Experimental); How it fits together; Quick start
Finding: Experimental: run agents on user-reachable Linux servers over SSH; each remote agent keeps a local tmux window and appears in dashboard/sidebar/status/list as handle@remote; agent keeps working while local machine sleeps, loses network, or closes the window; window reconnects by itself; workmux merge brings work home; local machine stays Git source of truth.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/skills/
Locator: Installation; /workmux /merge /rebase /worktree /coordinator /open-pr
Finding: Six product-shipped skills; workmux setup --skills installs to Claude/OpenCode/Pi/OMP dirs (manual copy documented); dashboard m keybinding triggers /merge; /merge commits/rebases/merges with conflict review; /worktree delegates with --fork option; /coordinator manages full lifecycle.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/workflows/
Locator: From terminal; From agent session; Forking; Coordinating; Direct merge; PR-based
Finding: add -A auto-names from prompt; /worktree spins off from running agents; --fork resumes conversations (Claude/Codex/Pi); /coordinator plans+delegates+merges; /merge for direct merge; /open-pr + git push + gh pr create then workmux remove/--gone for PR flow.
Retrieved: 2026-11-12

Source: https://workmux.dev/changelog/
Locator: v0.1.282 through v0.1.1 entries with dates
Finding: Latest v0.1.282 (2026-11-10); near-weekly releases through 2026; recent additions: remote servers (v0.1.278), branch auto-name, coordinator commands, Zellij sidebar, Copilot/Grok/agy support; entries describe shipped releases only, no future-dated commitments found.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/releases/tag/v0.1.282
Locator: Release header
Finding: Tag v0.1.282 published 2026-11-10; most recent release observed 2026-11-12.
Retrieved: 2026-11-12

## workmux:OWN-08

Finding: Ongoing free MIT download with full functionality and no card, trial, or paid evaluation path; agent and compute costs stay separate. Single-user scope bounds team scenarios.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-11-26
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12

Two-person collaboration scenario: each person free, but no shared/multiplayer surface exists (see TEAM-01).
Meaningful evaluation needs a coding-agent login (BYO subscription), not product payment.

Source: https://workmux.dev/
Locator: Hero; Remote servers; How it works; Skills; Setup sections
Finding: Terminal-first workflow for parallel AI agents using git worktrees: one task per worktree and tmux window, sidebar and dashboard for agent status, sandbox containment, SSH remote servers, agent skills; described as free and open source.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux
Locator: Repository header, About box, README
Finding: Owner raine (Raine Virta); description "git worktrees + tmux windows for zero-friction parallel dev"; homepage https://workmux.dev/; MIT license; default branch main; not archived.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux/blob/e72fd5925cbfd617bbefbf51a75f93d16556119d/LICENSE
Locator: Full license text
Finding: MIT License grant; copyright (c) 2025 workmux contributors; no component exceptions in the file.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/installation/
Locator: Bash/Homebrew/Cargo/mise/Nix methods; Shell alias; Completions; Uninstalling
Finding: Install via install script, Homebrew (macOS/Linux), Cargo, mise, Nix, or prebuilt binaries; shell completions for bash/zsh/fish; uninstall script removes data dirs; no account, signup, or payment step.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/quick-start/
Locator: Prerequisites; steps 1-5; The parallel AI workflow
Finding: Prerequisites: Git 2.5+ and tmux (or WezTerm/kitty/Zellij); flow is install, optional workmux init, workmux add (creates worktree + window + panes + setup), work, workmux merge cleanup; /worktree skill recommended from inside agent sessions.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/dashboard/
Locator: Setup; Agents/Worktrees views; Keybindings; Columns; Live preview; Input mode; Sort modes; Sweep
Finding: Optional TUI popup (tmux display-popup binding) requiring status hooks; Agents view (status, git info, PR checks, live preview) and Worktrees view; input mode sends keystrokes to agent; keys jump/diff/commit/merge/kill/remove/sweep; sort by priority/project/recency; sweep bulk-removes merged/gone worktrees.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/
Locator: Overview (Experimental); How it fits together; Quick start
Finding: Experimental: run agents on user-reachable Linux servers over SSH; each remote agent keeps a local tmux window and appears in dashboard/sidebar/status/list as handle@remote; agent keeps working while local machine sleeps, loses network, or closes the window; window reconnects by itself; workmux merge brings work home; local machine stays Git source of truth.
Retrieved: 2026-11-12

Source: https://workmux.dev/changelog/
Locator: v0.1.282 through v0.1.1 entries with dates
Finding: Latest v0.1.282 (2026-11-10); near-weekly releases through 2026; recent additions: remote servers (v0.1.278), branch auto-name, coordinator commands, Zellij sidebar, Copilot/Grok/agy support; entries describe shipped releases only, no future-dated commitments found.
Retrieved: 2026-11-12

## workmux:OWN-09

Finding: Transparent: the ADE is free with no paid units, limits, overages, markups, minimums, or cancellable plans; agent/compute spend is third-party and out of scope.

Verification: agent-cross-checked
Checked: 2026-11-12
Scheduled recheck: 2026-11-26
Plan: Not specified
Surface: workmux command-line interface (macOS/Linux binary); workmux dashboard terminal UI; workmux sidebar multiplexer pane
Version: v0.1.282 (commit e72fd5925cbfd617bbefbf51a75f93d16556119d, 2026-11-10); docs pass 2026-11-12



Source: https://workmux.dev/
Locator: Hero; Remote servers; How it works; Skills; Setup sections
Finding: Terminal-first workflow for parallel AI agents using git worktrees: one task per worktree and tmux window, sidebar and dashboard for agent status, sandbox containment, SSH remote servers, agent skills; described as free and open source.
Retrieved: 2026-11-12

Source: https://github.com/raine/workmux
Locator: Repository header, About box, README
Finding: Owner raine (Raine Virta); description "git worktrees + tmux windows for zero-friction parallel dev"; homepage https://workmux.dev/; MIT license; default branch main; not archived.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/installation/
Locator: Bash/Homebrew/Cargo/mise/Nix methods; Shell alias; Completions; Uninstalling
Finding: Install via install script, Homebrew (macOS/Linux), Cargo, mise, Nix, or prebuilt binaries; shell completions for bash/zsh/fish; uninstall script removes data dirs; no account, signup, or payment step.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/agents/
Locator: Agent integration; Named agents; Per-pane agents; Parallel workflows
Finding: Built-in agents: claude, codex, copilot, opencode, gemini, agy, kiro-cli, vibe, pi, omp, grok; prompt injection via -p/-P/-e without config changes; named global profiles with type/command/args/env (incl. from_env); multi-worktree generation (-a/-n/--foreach) e.g. one worktree each for claude and gemini.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/setup/
Locator: Requirements; Server or Docker; Install and check; Supplemental files; Security
Finding: Requires Linux x86-64/ARM64, promptless SSH, git, tmux 3.3+, systemd linger, API access; host mode (no sandbox) vs Docker mode per sandbox.enabled/isolation; server never talks to Git hosting and gets no origin; remote_files allowlist (64 MiB cap); no host-command proxying on servers.
Retrieved: 2026-11-12

Source: https://workmux.dev/guide/remote/logins/
Locator: Per-agent login table; Copy logins; Claude long-lived token; Environment variables
Finding: remote login runs each agent native login flow (claude/codex/gemini/opencode/pi/omp) with localhost port forwarding; --import does a one-time credential copy (with rotation caveats); setup-token for Claude; sandbox env passthrough read once per workspace and stored privately on server.
Retrieved: 2026-11-12

Source: https://workmux.dev/changelog/
Locator: v0.1.282 through v0.1.1 entries with dates
Finding: Latest v0.1.282 (2026-11-10); near-weekly releases through 2026; recent additions: remote servers (v0.1.278), branch auto-name, coordinator commands, Zellij sidebar, Copilot/Grok/agy support; entries describe shipped releases only, no future-dated commitments found.
Retrieved: 2026-11-12