tmux-zsh

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

Updated Feb 18, 2026
One-click install
npx skills add https://github.com/zach-source/claude-plugins --skill tmux-zsh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tmux-zsh
Source: https://github.com/zach-source/claude-plugins/tree/main/plugins/devtools/skills/tmux-zsh
Command: npx skills add https://github.com/zach-source/claude-plugins --skill tmux-zsh

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides expert guidance for configuring and troubleshooting your tmux terminal multiplexer and zsh shell, ensuring a highly productive and customized command-line environment.

Core Features & Use Cases

  • Tmux Configuration: Set up sessions, panes, keybindings, and plugins for efficient terminal management.
  • Zsh Configuration: Optimize your zsh shell with plugin managers (zplug, zinit, oh-my-zsh), vi-mode, custom prompts, and completions.
  • Nix/Home Manager Integration: Seamlessly integrate your terminal configurations with Nix and Home Manager for reproducible setups.
  • Debugging: Diagnose and resolve common issues related to shell startup, keybinding conflicts, and plugin problems.

Quick Start

Help me configure my zsh shell with the zplug plugin manager and enable vi-mode.

Frequently Asked Questions about tmux-zsh

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

FAQPage Schema
How do I configure tmux and zsh with Nix Home Manager?

You can configure tmux and zsh with Nix Home Manager by defining your terminal multiplexer settings, shell plugins, and vi-mode integration within your Home Manager configuration file for a fully reproducible setup.

Why does my zsh shell startup break after adding a plugin manager?

Zsh startup breaks after adding a plugin manager due to script execution errors or conflicting plugin load orders. Diagnosing these shell configuration issues involves checking your zplug, zinit, or oh-my-zsh initialization scripts for errors.

What is the best way to set up vi-mode in my zsh shell?

The best way to set up vi-mode in zsh involves binding your keys to enable normal and insert modes within your shell configuration. This allows you to navigate and edit your command line using familiar Vim keystrokes.

How do I resolve keybinding conflicts between tmux and zsh?

To resolve keybinding conflicts between tmux and zsh, you need to remap overlapping terminal shortcuts in your tmux configuration file. This ensures your shell keybindings and multiplexer pane controls do not trigger simultaneously.

Does Home Manager support managing oh-my-zsh custom prompts and completions?

Home Manager supports managing oh-my-zsh custom prompts and completions by declaring them as modules in your Nix configuration. This approach centralizes your shell environment setup and guarantees consistent deployment across systems.

Can I manage terminal sessions and panes effectively using tmux configuration?

You can manage terminal sessions and panes effectively by customizing your tmux configuration with specific keybindings and plugins. This setup enables efficient terminal management and persistent workflows across multiple panes.