tmux-sessionist

Lightweight tmux utils for manipulating sessions

Subscribe to updates I use tmux-sessionist


Statistics on tmux-sessionist

Number of watchers on Github 166
Number of open issues 10
Average time to close an issue 29 days
Main language Shell
Average time to merge a PR 15 days
Open pull requests 4+
Closed pull requests 0+
Last commit 12 months ago
Repo Created over 4 years ago
Repo Last Updated 8 months ago
Size 447 KB
Organization / Authortmux-plugins
Contributors2
Page Updated
Do you use tmux-sessionist? Leave a review!
View open issues (10)
View tmux-sessionist activity
View on github
Latest Open Source Launches
Trendy new open source projects in your inbox! View examples

Subscribe to our mailing list

Evaluating tmux-sessionist for your project? Score Explanation
Commits Score (?)
Issues & PR Score (?)

Tmux sessionist

Lightweight tmux utilities for manipulating tmux sessions.

Tested and working on Linux, OSX and Cygwin.

Problem(s)

Sessions are a second class citizen in tmux environment:

  • there are no default key bindings for creating or deleting sessions
  • creating a session is cumbersome, just try tmux new-session -s name inside tmux (hint: you first have to detach)
  • deleting (killing) current session by default detaches tmux (why?)
  • no fast way for session switching when there's more than ~5 sessions

This plugin solves the above problems.

Features

  • prefix + g - prompts for session name and switches to it. Performs 'kind-of' name completion.
    Faster than the built-in prefix + s prompt for long session lists.
  • prefix + C (shift + c) - prompt for creating a new session by name.
  • prefix + X (shift + x) - kill current session without detaching tmux.
  • prefix + S (shift + s) - switches to the last session.
    The same as built-in prefix + L that everyone seems to override with some other binding.
  • prefix + @ - promote current pane into a new session.
    Analogous to how prefix + ! breaks current pane to a new window.
  • prefix + t<secondary-key> - join currently marked pane (prefix + m) to current session/window, and switch to it
    • secondary-keys
    • h, -, ": join horizontally
    • v, |, %: join vertically
    • f, @: join full screen

Installation with Tmux Plugin Manager (recommended)

Add plugin to the list of TPM plugins in .tmux.conf:

set -g @plugin 'tmux-plugins/tmux-sessionist'

Hit prefix + I to fetch the plugin and source it. You can now use the plugin.

Manual Installation

Clone the repo:

$ git clone https://github.com/tmux-plugins/tmux-sessionist ~/clone/path

Add this line to the bottom of .tmux.conf:

run-shell ~/clone/path/sessionist.tmux

Reload TMUX environment with $ tmux source-file ~/.tmux.conf. You can now use the plugin.

Other plugins

You might also find these useful:

  • pain control - useful standard bindings for controlling panes
  • logging - easy logging and screen capturing

License

MIT

tmux-sessionist open issues Ask a question     (View All Issues)
  • almost 3 years can't find session error when destroy-unattached is on
  • about 4 years Should set session start-diretory to current working directory.
  • about 4 years with <prefix + g> when multiple sessions match, give filtered output
  • about 4 years Should the session list be case insensitive
tmux-sessionist open pull requests (View All Pulls)
  • Adds sessionist-use-pane-directory option.
  • Added compatibility to load tmuxifier sessions.
  • Source config to keep custom prefix in new session
  • add tmuxinator support when starting new sessions
tmux-sessionist list of languages used
Other projects in Shell