tmuxer

Launch your tmux sessions instantly

A bash script that simplifies tmux session management and project navigation. Quickly create, attach to, and manage tmux sessions with predefined layouts.

View on GitHubLearn More
$ tmr

████████╗███╗   ███╗██╗   ██╗██╗  ██╗███████╗██████╗
╚══██╔══╝████╗ ████║██║   ██║╚██╗██╔╝██╔════╝██╔══██╗
   ██║   ██╔████╔██║██║   ██║ ╚███╔╝ █████╗  ██████╔╝
   ██║   ██║╚██╔╝██║██║   ██║ ██╔██╗ ██╔══╝  ██╔══██╗
   ██║   ██║ ╚═╝ ██║╚██████╔╝██╔╝ ██╗███████╗██║  ██║
   ╚═╝   ╚═╝     ╚═╝ ╚═════╝ ╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝

tmuxer v0.1.0 - A tmux session manager 
with project directory navigation

Select a project directory:

Features

Tmuxer streamlines your development workflow with powerful features designed for efficiency.

Multiple Layouts

Choose from dev, code, or terminal layouts to match your workflow needs.

Quick Launch

Start your development environment with a single command using fuzzy search project selection.

Session Management

List, attach to, and kill tmux sessions with simple commands and interactive selection.

How It Works

Tmuxer is designed to be simple and intuitive. Get started in minutes.

1

Install Tmuxer

Install via Homebrew or clone the repository and create a symbolic link.

2

Configure Project Directories

Add your project root directories to the ~/.tmuxer.conf file.

3

Launch Sessions

Run tmr or tmuxer to select a project and create a session with your preferred layout.

# Basic usage
tmr                    # Interactive project selection
tmr ~/projects/app     # Specific directory

# Session management
tmr -l                 # List sessions
tmr -a                 # Attach to a session
tmr -k session_name    # Kill a session

# Layout options
tmr --dev              # Editor + terminal split
tmr --code             # Single pane with editor
tmr --terminal         # Just terminal, no editor

Installation

Get up and running with Tmuxer in just a few steps.

Option 1: Homebrew (recommended)

brew tap szcharlesji/formulae
brew install tmuxer

Option 2: Manual Installation

git clone https://github.com/szcharlesji/tmuxer.git
cd tmuxer
chmod +x tmuxer.sh
sudo ln -s "$(pwd)/tmuxer.sh" /usr/local/bin/tmuxer
sudo ln -s "$(pwd)/tmuxer.sh" /usr/local/bin/tmr  # Optional alias

Dependencies

Tmuxer requires the following dependencies:

  • tmux - Terminal multiplexer
  • fzf - Fuzzy finder for interactive selection

Session Layouts

Choose the perfect layout for your workflow.

Dev Layout

nvim
$
$

Main editor pane with two terminal panes at the bottom. Perfect for development.

tmr --dev ~/projects

Code Layout

nvim

Single pane with editor. Focused environment for coding without distractions.

tmr --code ~/projects

Terminal Layout

$

Just a terminal session. Useful for server management or command-line tasks.

tmr --terminal ~/servers

Ready to streamline your tmux workflow?

Start using Tmuxer today and save time on project setup. Contribute to the project on GitHub.

View on GitHubReport an Issue