swain-stage

Manage tmux workspaces and panes with dynamic layouts and status updates.

Updated Feb 22, 2026
One-click install
npx skills add https://github.com/cristoslc/tidegate --skill swain-stage
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: swain-stage
Source: https://github.com/cristoslc/tidegate/tree/main/.agents/skills/swain-stage
Command: npx skills add https://github.com/cristoslc/tidegate --skill swain-stage

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires textual, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the AI agent's development workflow by providing dynamic tmux workspace management, allowing agents to control their environment and present information effectively.

Core Features & Use Cases

  • Dynamic Layouts: Switch between predefined workspace layouts (focus, review, browse) optimized for different tasks.
  • Pane Management: Open, close, and manage editor, file browser, shell, and status panes directly.
  • Real-time Status: An animated MOTD panel displays agent activity, project status, and task progress.
  • Use Case: When an agent is working on code, it can automatically open the relevant files in an editor pane, update a status panel with its progress, and switch to a review layout when changes are ready.

Quick Start

Apply the 'review' layout to organize your tmux panes for code review.

Frequently Asked Questions about swain-stage

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

FAQPage Schema
How do I manage tmux workspaces for AI agents?

Tmux workspace management for AI agents involves dynamically creating panes for editors and file browsers, switching between predefined layouts, and displaying real-time agent status updates via an animated TUI.

Can I switch tmux pane layouts automatically during a development workflow?

Yes, you can switch between predefined tmux layouts like focus, review, and browse automatically. This allows an AI agent to optimize the workspace dynamically based on the current task, such as switching to a review layout when code changes are ready.

Does this tmux workspace manager require Python and Textual?

Yes, this tmux workspace manager requires Python 3.11+ and the Textual library to render the animated MOTD TUI for real-time status updates. A tmux environment is also required to run the workspace panes.

How do I display real-time agent status in a tmux pane?

To display real-time agent status in tmux, you use an animated MOTD panel driven by the Textual framework. This panel integrates with git and task management systems to show agent activity, project status, and task progress.

What is the best way to organize tmux panes for code review with an AI agent?

The best way to organize tmux panes for code review is by applying a predefined 'review' layout. This workspace configuration arranges editor, file browser, shell, and status panes specifically for reviewing code changes.

What are the limitations of using a tmux workspace manager for AI agents?

Limitations include a strict dependency on a tmux environment and Python 3.11+ with the Textual library. Without these specific prerequisites, the dynamic layout switching and animated MOTD status panel will not function.