skills.rest
Gonglitian
GonglitianCOMMUNITY
Explore all skills by this author →
GitHub

tmux-workspace

Generate tmuxinator YAML configurations and a tmux.conf for multi-project terminal workspaces.

2|Updated Mar 20, 2026
Search Tags:#workspace#tmux#terminal#tmuxinator#project-management#panes#dev-environment
One-click install
npx skills add https://github.com/Gonglitian/agent-skills --skill tmux-workspace
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tmux-workspace
Source: https://github.com/Gonglitian/agent-skills/tree/main/skills/tmux-workspace
Command: npx skills add https://github.com/Gonglitian/agent-skills --skill tmux-workspace

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generate a repeatable, ready-to-use terminal workspace by creating a tmuxinator configuration and a tmux.conf to manage multiple projects in panes.

Core Features & Use Cases

  • Generates a tmuxinator YAML file at ~/.config/tmuxinator/<name>.yml defining a tiled layout with one pane per project and startup commands.
  • Creates a centralized tmux.conf with sane defaults and visual enhancements to support consistent terminal multiplexing.
  • Use cases include setting up a dev workspace with several projects, starting multiple repos in parallel, and maintaining a reproducible layout across machines.

Quick Start

Provide your project paths and a workspace name, and I will generate the tmuxinator configuration and the tmux.conf for you.

Frequently Asked Questions about tmux-workspace

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

FAQPage Schema
How do I set up a multi-project terminal workspace with tmux?▼

To set up a multi-project terminal workspace, this generator creates a tmuxinator YAML file defining a tiled layout with one pane per project. You simply provide your project paths and a workspace name to get the configuration.

Can I automate starting multiple repos in parallel using tmuxinator?▼

Yes, you can automate starting multiple repos in parallel by defining startup commands in the generated tmuxinator YAML file. This allows each project pane to execute specific commands automatically when the workspace launches.

What do I need to generate a tmuxinator configuration for my dev environment?▼

To generate a tmuxinator configuration, you need to provide your project paths, a workspace name, and optional startup commands. The tool then outputs a ready-to-use YAML file at ~/.config/tmuxinator/<name>.yml.

Does this tool create a tmux.conf with sane defaults?▼

Yes, this tool creates a centralized tmux.conf with sane defaults and visual enhancements. This ensures consistent terminal multiplexing behavior across your generated multi-project workspaces.

How do I maintain a reproducible terminal layout across multiple machines?▼

You maintain a reproducible terminal layout across machines by generating tmuxinator YAML configurations. These files define exact pane structures and startup commands, allowing you to replicate the dev environment setup anywhere.

What is the best way to manage several projects in a single terminal session?▼

The best way to manage several projects in a single terminal session is using tmuxinator to define a tiled layout. This approach organizes multiple projects into separate panes within one reproducible workspace configuration.

Related Skills

Explore More Software Engineering Skills→
coff33ninjacoff33ninja

anti-global-install

Configure project-local package installations across multiple programming languages.

Community
Advanced
furedeafuredea
1

herdr

Manage herdr terminal multiplexer workspaces, tabs, and panes via CLI commands.

Community
Intermediate
mkalkeremkalkere
4

bash

Executes shell commands in the workspace with output and error capture.

Community
Basic
zach-sourcezach-source

tmux-zsh

Configure and troubleshoot tmux and zsh with plugin management and vi-mode.

Community
Advanced