Zesh

A zellij session manager with zoxide integration, inspired by tmux-sesh by Josh Medeski.

Features

• List active zellij sessions
• Create and connect to sessions based on zoxide
• Zoxide-powered session detection and management
• Clone git repositories and set up sessions

Installation

Currently, ths project can be installed with cargo, or the binaries can be found directly in the GitHub releases.

cargo install --locked zesh

Requirements

• zellij - Terminal multiplexer
• zoxide - Smarter cd command
• git - Version control (optional, for clone command)

🚀 Usage

# Connect to a specific session or directory
zesh connect <name>
zesh cn <name>

# List active sessions (intended to be used with other cli tools, like fzf)
zesh list
zesh l

# Pair the two commands with fzf
zesh cn $(zesh l | fzf)

# Clone a git repo and create a session
zesh clone https://github.com/username/repo
zesh cl https://github.com/username/repo

# Display help
zesh help
zesh --help
zesh -h

Subject to Change

This project is still heavily under development. Currently, some current features may change, and some essential features have not been added.

Why Zesh?

Zesh combines the power of zellij (terminal multiplexer) and zoxide (directory jumper) to provide a seamless session management experience. It's designed for developers who frequently work on multiple projects and want to quickly jump between them.

Credits

This project was inspired by sesh by Josh Medeski, a tmux session manager. Huge thanks to Josh for the original concept that made terminal session management so much more enjoyable!

AI Usage

I have used AI to write documentation because I am lazy (like this README). I have also used AI to do some basic feature work while I was out of town on vacation. The code is probably bad and primarily written by me trying to learn from how Josh writes code.

License

MIT