Skip to content

[FEATURE]: tmux-based subagent spawning for observable parallel execution #6929

@werkamsus

Description

@werkamsus

Feature hasn't been suggested before.

  • I have verified this feature I's about to request hasn't been suggested before.

Describe the enhancement you want to request

Problem: Subagents run silently in-process. When running multiple parallel tasks, there's no way to observe them in real-time or debug a stuck agent.

Proposal: Optional tmux-based subagent spawning.

// opencode.json
{
  "subagent": {
    "spawn": "tmux"  // "inline" (default) | "tmux"
  }
}

When enabled, task tool invocations spawn in tmux panes/windows instead of inline:

  • Watch multiple subagents work simultaneously in split panes
  • Attach to a stuck subagent and intervene
  • Sessions persist if main terminal disconnects
  • Results still returned to parent via IPC (temp file, socket, etc.)

Why tmux: Battle-tested, already installed on most dev machines, handles pane layout automatically.

Open questions:

  • Pane vs window per subagent?
  • Layout strategy for 4+ parallel agents?
  • Fallback behavior when tmux unavailable?

Happy to help prototype if there's interest.

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions