cockpit-rebuild

Rebuild atmux cockpit sessions and per-team cage tmux topology.

2|Updated Apr 24, 2026
One-click install
npx skills add https://github.com/geoyws/atmux --skill cockpit-rebuild
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cockpit-rebuild
Source: https://github.com/geoyws/atmux/tree/main/plugins/atmux/skills/cockpit-rebuild
Command: npx skills add https://github.com/geoyws/atmux --skill cockpit-rebuild

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves drift and broken tmux/cage topology by recreating the canonical atmux cockpit session and all per-team cages in a deterministic, idempotent way.

Core Features & Use Cases

  • Recreates cockpit and viewer topology: Restores the atmux_cockpit session layout (including viewer windows) so operator attachments work reliably after reboot or accidental changes.
  • Reconciles per-team cages safely: Normalizes team.json, registry rosters, and cockpit overlays; optionally cycles cages to recover from wedged or missing state.
  • Applies correct hierarchical naming: Rebuild-time level-resolved cage prefixes ensure nested layers remain unambiguous, aligning with hierarchical cockpit conventions.
  • Repairs cron environment issues: Scrubs orphan/stale cron entries and prepends safe SHELL/PATH/TERM so tmux invocations don’t fail in minimal cron environments.

Quick Start

Run cockpit-rebuild to restore the full cockpit-plus-cages topology: atmux cockpit rebuild.

Frequently Asked Questions about cockpit-rebuild

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

FAQPage Schema
How do I restore a broken tmux session layout after an unexpected server reboot?

Restoring a broken tmux session layout after a reboot requires deterministically rebuilding the canonical atmux cockpit topology. This idempotent reconciliation process recreates cockpit windows and per-team cages, eliminating drift and ensuring reliable operator attachments.

What is the best way to normalize per-team cage sockets and registry rosters when state becomes wedged?

Normalizing per-team cage sockets and registry rosters requires applying idempotent state reconciliation to the atmux cockpit. This safely normalizes team.json configurations and registry overlays, optionally cycling cages to recover from wedged or missing state.

How do I fix tmux invocations failing inside a minimal cron environment?

Fixing tmux invocations failing inside a minimal cron environment requires scrubbing orphan and stale cron entries. The rebuild process repairs the cron environment by prepending safe SHELL, PATH, and TERM variables so tmux commands execute reliably during scheduled recovery.

Does cockpit-rebuild support cycle control when forcing operational recovery of team cages?

Yes, operational recovery supports optional cycle control when rebuilding team cages. You can use --no-cycle to prevent recreation or --force-cycle to force cage cycling, ensuring idempotent state reconciliation regardless of the severity of the wedged topology.

Can I use this Skill to reconcile SQLite/WAL state alongside tmux operational recovery?

Yes, you can reconcile SQLite/WAL state alongside tmux operational recovery. The idempotent reconciliation process normalizes registry rosters and team.json configurations while rebuilding hierarchical level-resolved cage prefixes across the entire atmux cockpit topology.