feat: add tmux configuration and installation scripts#42
Merged
Conversation
Contributor
There was a problem hiding this comment.
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/withtmux.conf.symlink,install.sh(TPM + plugins), andaliases.zsh(tmux helpers + movedcldyoalias). - Adds
bin/claude-agentsfor creating/attaching a multi-pane tmux session. - Updates
bin/dot,README.md, andCLAUDE.mdto 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.
- 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>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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:
tmux/directory with a full-featuredtmux.conf.symlinkconfiguration, including a Ctrl+a prefix, vim-style navigation, mouse support, a Tokyo Night-inspired status bar, and plugin integration via TPM (Tmux Plugin Manager).tmux/install.shto automate TPM and plugin installation, ensuring plugins liketmux-resurrect,tmux-continuum, andtmux-yankare set up automatically.tmux/aliases.zshwith tmux session management shortcuts and moved thecldyoClaude Code orchestration alias here frommacos/aliases.zsh. [1] [2]Documentation Updates:
README.mdandCLAUDE.mdto 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]Install and Orchestration Flow:
dot installanddot update. [1] [2] [3] [4]Miscellaneous:
commitlint.config.jsfor syntax consistency.References: [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13] [14] [15] [16] [17] [18]