Skills
.Work. You
Rest

cockpit-rebuild

Community

Deterministically rebuild the atmux cockpit

Software Engineering#orchestration#tmux#cockpit#agent terminals#state reconciliation#SQLite/WAL#operational recovery
Authorgeoyws
Version1.0.0
Installs0

System Documentation

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.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: cockpit-rebuild
Download link: https://github.com/geoyws/atmux/archive/main.zip#cockpit-rebuild

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.