Skills
.Work. You
Rest

terminal-orchestrator

Community

Safely run allowlisted tmux commands locally

Software Engineering#tmux#local development#dev workflow#allowlist#command validation#audit ledger#log tailing
AuthorCleanExpo
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill prevents unsafe or accidental command execution when you need to inspect or drive long-running tmux-based development workflows on your local machine.

Core Features & Use Cases

  • tmux state inspection (read-only): List sessions/windows and check tmux status; tail the last N lines from a pane for quick debugging.
  • Controlled workflow start: Start a known profile that brings up a vetted dev/test/watch/logs workflow in tmux.
  • Validator-gated command execution: Run only allowlisted commands through a command grammar validated by a Python gate, with deterministic refusal on policy failures and auditing in a fail-closed ledger.

Use Case: An operator asks what is currently running in tmux, then starts a predefined “watch tests” profile to reproduce an issue and tails the relevant pane output—all without enabling production mutations or secret leakage.

Quick Start

Tell the agent: "Use the terminal-orchestrator skill to list current tmux sessions and show tmux status."

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: terminal-orchestrator
Download link: https://github.com/CleanExpo/Pi-Dev-Ops/archive/main.zip#terminal-orchestrator

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.