How can I tell if my AI teammates are actually running?

Use the /claude-swarm:swarm-verify command to compare your current configuration against live multiplexer sessions and identify dead processes.

Can I recover a team after my computer restarts?

Yes, use /claude-swarm:swarm-reconcile to identify the offline sessions, then use /claude-swarm:swarm-resume to automatically respawn the teammates.

What do I do if I get a 'Could not find a valid kitty socket' error?

Ensure 'allow_remote_control yes' and 'listen_on unix:/tmp/kitty-$USER' are in your kitty.conf, then restart kitty completely (CMD+Q) to apply changes.

Why should I use the diagnose command first?

The swarm-diagnose command runs a full suite of health checks covering permissions, sockets, and multiplexer availability to pinpoint the exact failure point before you attempt manual fixes.

Does this work with both tmux and kitty?

Yes, the skill provides specific diagnostic logic and recovery paths for both tmux and kitty terminal multiplexers.

Swarm Troubleshooting

Name: Swarm Troubleshooting
Author: Und3rf10w

byUnd3rf10w

•

Collaboration Tools

Diagnoses and resolves coordination issues, session crashes, and multiplexer failures within Claude Code multi-agent swarms.

Swarm Troubleshooting provides a comprehensive suite of diagnostic and recovery procedures for managing complex multi-agent swarms in Claude Code. It specializes in resolving environment-specific hurdles like kitty socket connectivity, tmux session management, and status mismatches between active agents and system processes. Whether dealing with a crashed team lead or a failed agent spawn, this skill offers systematic decision trees and automated reconciliation tools to ensure seamless coordination and minimize downtime in AI-driven development workflows.

Key Features

01Delegated diagnosis patterns for managing worker agents through a team lead

026 GitHub stars

03Automated health checks for multiplexer and socket connectivity via swarm-diagnose

04Session reconciliation to fix mismatches between agent status and live processes

05Recovery procedures for respawning crashed teammates while maintaining task context

06Deep integration with kitty and tmux for advanced terminal multiplexing troubleshooting

Use Cases

01Debugging communication failures between an orchestrator and delegated worker agents

02Recovering a multi-agent team after a system restart or terminal crash

03Fixing 'Could not find a valid kitty socket' errors during agent initialization

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add und3rf10w/claude-litter swarm-troubleshooting

For use in Claude.ai and ChatGPT

Download Skill