skills.rest
somegee
somegeeCOMMUNITY
Explore all skills by this author →
GitHub

terminal-swarm

Orchestrate headless terminal sessions for Claude Code workflows with a real-time dashboard.

3|Updated Mar 26, 2026
Search Tags:#Claude Code#dashboard#orchestration#swarm#terminal#headless#PTY
One-click install
npx skills add https://github.com/somegee/somegee-skills --skill terminal-swarm
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: terminal-swarm
Source: https://github.com/somegee/somegee-skills/tree/main/terminal-swarm/skills/terminal-swarm
Command: npx skills add https://github.com/somegee/somegee-skills --skill terminal-swarm

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pywinpty, websockets, pyte, watchdog, and includes scripts (resource) and assets (resource) components.

What problem does it solve?

Terminal Swarm solves the challenge of observing, guiding, and coordinating multiple headless terminal sessions in Claude Code-driven workflows, eliminating manual context switching and enabling real-time oversight.

Core Features & Use Cases

  • Headless Terminal Management: spawn, feed, and monitor multiple terminal sessions without focusing windows.
  • Real-Time Web Dashboard: visualize all sessions, status, and hooks, and intervene when needed.
  • Claude Code Hooks Integration: reflect task progress and obtain explicit user input status.
  • Multi-Agent Orchestration: coordinate sub-sessions for research, build, and code-review tasks across teams.

Quick Start

Instruct the agent to launch a Claude Code session and monitor a Terminal Swarm dashboard to manage a new headless session immediately.

Frequently Asked Questions about terminal-swarm

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I orchestrate multiple headless terminal sessions for Claude Code workflows?▼

You can orchestrate multiple headless terminal sessions by spawning, feeding, and monitoring PTY-backed sessions simultaneously. This enables parallel research, code reviews, and build/testing workflows with deterministic session management and real-time visibility.

What is a headless terminal swarm and when do I need it for multi-agent coordination?▼

A headless terminal swarm is a coordinated group of terminal sessions running without focusing windows. You need it for multi-agent orchestration when managing parallel sub-sessions for research, builds, and code reviews across teams, eliminating manual context switching.

How do I monitor real-time PTY I/O and intervene in automated terminal sessions?▼

You monitor real-time PTY I/O through a streaming web dashboard that visualizes all session statuses and hooks. The dashboard provides real-time oversight, allowing you to intervene and guide headless terminal sessions safely when needed.

Can I use websockets and pywinpty to manage parallel Claude Code build and testing tasks?▼

Yes, the system uses websockets for dashboard streaming and pywinpty for robust PTY I/O management. These dependencies support deterministic session management for parallel build, testing, and code review tasks within Claude Code workflows.

Does Claude Code hooks integration support reflecting task progress and obtaining user input?▼

Yes, Claude Code hooks integration explicitly reflects task progress and obtains user input status. This allows the orchestration system to safely coordinate sub-sessions while maintaining real-time visibility into each automated workflow step.

What are the limitations of using terminal orchestration for headless session management?▼

Limitations include the requirement for specific Python dependencies like pywinpty, websockets, and pyte. While it provides safe defaults and deterministic management, complex multi-agent orchestration may still require manual intervention through the dashboard for edge cases.

Related Skills

Explore More Software Engineering Skills→
bermudibermudi

pty-handling

Spawn and manage PTY sessions with I/O streaming and shell wrapping.

Community
Advanced
opencodosopencodos
14

errors

Aggregate and analyze Claude Code errors from JSONL logs and system logs.

Official
Intermediate
drdanmaggsdrdanmaggs

pr-quality

Automate GitHub PR review-fix-undraft cycles until CI passes.

Community
Advanced
wesleyegbertowesleyegberto
3

terminal-monitor

Open a named tmux or iTerm2 pane to monitor real-time subagent or team output.

Community
Intermediate