Skip to content

feat: add tmux configuration and installation scripts#42

Merged
akornmeier merged 2 commits into
mainfrom
feat/tmux-configuration
Mar 22, 2026
Merged

feat: add tmux configuration and installation scripts#42
akornmeier merged 2 commits into
mainfrom
feat/tmux-configuration

Conversation

@akornmeier

Copy link
Copy Markdown
Owner

This pull request introduces a new, comprehensive tmux configuration to the dotfiles setup, including installation scripts, plugin management, and improved documentation. It also reorganizes aliases, updates install flows, and enhances documentation for both tmux and Claude MCP server integration. The changes improve multi-pane workflows, session persistence, and user onboarding.

tmux Integration and Configuration:

  • Added a new tmux/ directory with a full-featured tmux.conf.symlink configuration, including a Ctrl+a prefix, vim-style navigation, mouse support, a Tokyo Night-inspired status bar, and plugin integration via TPM (Tmux Plugin Manager).
  • Added tmux/install.sh to automate TPM and plugin installation, ensuring plugins like tmux-resurrect, tmux-continuum, and tmux-yank are set up automatically.
  • Introduced tmux/aliases.zsh with tmux session management shortcuts and moved the cldyo Claude Code orchestration alias here from macos/aliases.zsh. [1] [2]

Documentation Updates:

  • Expanded README.md and CLAUDE.md to document tmux workflows, keybindings, plugin installation, and how the new tmux setup enables multi-pane sessions for Claude Code agents. Also clarified install steps and updated lists of topic installers. [1] [2] [3] [4] [5] [6]
  • Updated documentation for Claude MCP server setup, requirements, and integration with the new install flow. [1] [2] [3] [4] [5]

Install and Orchestration Flow:

  • Modified install scripts and documentation to include tmux as a first-class topic, ensuring it is set up during dot install and dot update. [1] [2] [3] [4]

Miscellaneous:

  • Minor fix to commitlint.config.js for syntax consistency.

References: [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13] [14] [15] [16] [17] [18]

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a tmux “topic” to the dotfiles system (config + TPM-based plugin install), plus a claude-agents helper for multi-pane Claude Code workflows, and updates docs to reflect the new setup.

Changes:

  • Introduces tmux/ with tmux.conf.symlink, install.sh (TPM + plugins), and aliases.zsh (tmux helpers + moved cldyo alias).
  • Adds bin/claude-agents for creating/attaching a multi-pane tmux session.
  • Updates bin/dot, README.md, and CLAUDE.md to document/install tmux and related workflows; minor formatting tweaks elsewhere.

Reviewed changes

Copilot reviewed 9 out of 11 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
tmux/tmux.conf.symlink New tmux configuration (prefix, keybinds, status bar, TPM plugins).
tmux/install.sh Installs TPM and attempts non-interactive plugin installation.
tmux/aliases.zsh Adds tmux aliases; relocates cldyo alias here.
macos/aliases.zsh Removes cldyo from macOS aliases (move to tmux topic).
bin/dot Sources the tmux installer during dot install.
bin/claude-agents New script to launch/reattach a multi-pane tmux session for agents.
README.md Documents tmux topic, claude-agents, and installer topic list.
CLAUDE.md Documentation formatting tweaks (spacing/structure).
docs/plans/2025-11-17-claude-mcp-servers-design.md Documentation formatting tweaks (JSON examples + spacing).
commitlint.config.js Minor syntax/style adjustment.
.changeset/fiery-mammals-fall.md Declares a minor changeset for the tmux feature addition.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread README.md Outdated
Comment thread tmux/install.sh Outdated
Comment thread tmux/aliases.zsh
- Remove Claude from topic installer lists (not invoked by cmd_install)
- Add tmux to CLAUDE.md installer list for consistency
- Replace suppressed error handling in tmux/install.sh with conditional
  success/failure messages that surface stderr on plugin install failure
- Add security warning comment above cldyo alias documenting the
  implications of --dangerously-skip-permissions

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@akornmeier akornmeier merged commit 88c491e into main Mar 22, 2026
2 checks passed
@akornmeier akornmeier deleted the feat/tmux-configuration branch March 22, 2026 13:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants