Kitty Sessionizer bash script

[harshv5094]

This is my kitty sessionizer script to open kitty session using rofi. I'm using hyprland as my window manager, demo video is below the script:

Note

This script is still in alpha stages, I'm gonna make some improvements and add it here.

#!/usr/bin/env bash

# Author: Harsh Vyapari <@harhsv5094>
# License: MIT License

# MIT License
#
# Copyright (c) 2026 Harsh Vyapari
#
# Permission is hereby granted, free of charge, to any person obtaining a copy
# of this software and associated documentation files (the "Software"), to deal
# in the Software without restriction, including without limitation the rights
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
# copies of the Software, and to permit persons to whom the Software is
# furnished to do so, subject to the following conditions:
#
# The above copyright notice and this permission notice shall be included in all
# copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
# SOFTWARE.


have() { command -v "$1" &>/dev/null; }

# Define a persistent cache directory
CACHE_DIR="$HOME/.cache/kitty-sessions"
[[ ! -d $CACHE_DIR ]] && mkdir -p "$CACHE_DIR"

if ! have kitty; then
  notify-send "Kitty Sessionizer" "Please install kitty first to use this script"
  exit 1
fi

if [ "$#" -eq 1 ]; then
  selected=$1
  mkdir -p "$HOME/dev/$1"
else
  selected=$(
    find ~/dev/* -mindepth 1 -maxdepth 1 -type d -not -path '*/.git*' | rofi -dmenu -i -p "" -location 0 \
      -theme-str 'window { width: 600px; }
                  listview { columns: 1; lines: 5; spacing: 10px; }
                  element { orientation: vertical; }
                  element-icon { size: 250px; }
                  element-text { horizontal-align: 0.5; }'
  )
fi

if [ -z "$selected" ]; then
  exit 0
fi

selected_name=$(basename "$selected" | tr '.' '_')
session_file="$CACHE_DIR/$selected_name"

cat >"$session_file" <<EOF
# Tab 1: Neovim
new_tab editor
cd $selected
launch nvim .

# Tab 2: Terminal
new_tab terminal
cd $selected
launch bash
EOF

kitty --session "$session_file" --detach
[[ "$?" -eq 0 ]] && notify-send -u low "Kitty Sessionizer" "Session: $selected_name"

For tab bar add this to your kitty.conf:

# Tab Bar
tab_powerline_style         angled
tab_bar_edge                bottom
tab_bar_style               powerline
tab_bar_min_tabs            2
tab_title_max_length        20
tab_title_template          "({index}) {session_name + '/' + title if session_name else tab.active_oldest_exe}"
active_tab_title_template   "({index}) {session_name + '/' + title if session_name else tab.active_oldest_exe}"
active_tab_font_style       bold

onlyoffice-sample-video.mp4

[Tesohh]

Great work, this is (almost) exactly what i needed. I had to tweak some things as I use zsh and have a custom script for fetching the folders to sessionize.

If it might be useful for anyone, it's at https://codeberg.org/Tesohh/dotfiles/src/branch/main/kitty-sessionizer.sh