consession is a tmux session manager powered by fzf and zoxide. It effortlessly lets you create, switch, rename and kill sessions. It knows the directories you visit most often and remembers every time you rename a session.
- Type and attach fuzzy search over currly open tmux sessions.
- Create new sessions automatically from your frequently used directories (via zoxide).
- Preview of sessions and directory contents.
- Keybindings for renaming and killing sessions directly from the fzf interface.
- Persistent Names for sessions associated with a particular directory.
-
Run the following commands
git clone https://github.com/itsfernnn/consession.git cd consession make install -
Ensure dependencies are installed
Simply run:
consessionBy default, consession will:
- Show a fuzzy list of your current tmux sessions.
- Allow you to kill (
Ctrl-X) or rename (Ctrl-R) any session. - Automatically switches to zoxide view when query does not match any existing session
- Switch back to the session view by pressing
Backspaceon an empty query. - Switch to an existing session or create a new one in the selected directory by pressing
Enter.
| Action | Key Combination |
|---|---|
| Kill session | Ctrl-X |
| Rename session | Ctrl-R |
| Switch to zoxide view | unique query |
| Reset to sessions view | backspace |
| create or switch session | enter |
TODO
This project is licensed under the MIT License. See the LICENSE file for details.
- Inspired by fzf-tmux workflows
- Thanks to the maintainers of tmux, fzf, zoxide, and eza

