Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/benjamin-carpene/tmux-zoxide-sessionizer

A simple yet usefull tmux sessionizer using zoxide
https://github.com/benjamin-carpene/tmux-zoxide-sessionizer

bash script session session-management tmux zoxide

Last synced: 9 days ago
JSON representation

A simple yet usefull tmux sessionizer using zoxide

Awesome Lists containing this project

README

        

# Description

TZ is a simple and stupid glue script to make a Tmux-Zoxide sessionizer.
The goal is to use the power of zoxide to create tmux sessions in one line and no time.
This script's aim is to keep it simple, with as few dependencies as possible, in bash, as it should be.
No useless packages required, no additional libraries and package managers, just tmux [ and zoxide :) ].

# Features

- Open a tmux session using a zoxide-registered directory
- Connect to an existing tmux session
- Can be used inside a tmux session 😀
- Uses `fzf`'s TUI to select a directory if no argument were given

# Usage

## Synopsis

`tz [zoxide_dir] | [--help | -h]`
- zoxide_dir: the directory searched for in zoxide
- If it is set, tz will search for this directory in zoxide and open it as a tmux session
- If it is unset, you will be prompted interactively to select a zoxide directory
- --help | -h: Shows this help message

## Example

`tz feature-a`: Create / connect to a session attached to 'feature-a' directory.
`tz`: Asks for the user to select a directory to create / connect to a session.

# Installation

1. Clone this repo : `git clone https://github.com/benjamin-carpene/tz.git`
2. Use the installation script : `cd tz && ./install.sh`