sessionizer

README

README

Yet another tmux sessionizer

Config

Needs a config file at $XDG_CONFIG_HOME/sessionizer/config.toml (or $HOME/.config/sessionizer/config.toml):

[base]
ignore = ["node_modules"]   # optional

[default]
name = "default"            # optional
path = "$HOME/Downloads"    # required
layout_path = "$HOME/.config/sessionizer/default.yml"  # optional, layout for the default session

[search]
directories = [
  "$HOME/Projects"
]

entries = [
  "$HOME/.local/share/chezmoi",
  { path = "$HOME/Obsidian/memex", name = "interest/memex" },
]

Layouts

New sessions can start with a preset window/pane layout (tmuxp format). sessionizer picks the first it finds:

1. .sessionizer.yml in the session directory
2. default.layout_path (for the default session)
3. layouts/<name>.yml next to your config (via layout on a search.entries object)

No layout found? You get a plain single window.

Usage

Open a fuzzy search

Fuzzy-find a project (any directory with a .git) and start or switch to its tmux session. The default session is always offered.

sessionizer search

Print selected project path

Same finder, but prints the selected path to stdout instead of starting a session — handy for shell wrappers (e.g. cd to it). Silent if cancelled.

sessionizer search --print-path

List all sessions

sessionizer sessions
default
personal/project

List all detached sessions

Handy for listing alternative sessions, e.g. in a tmux status bar.

sessionizer sessions --detached-only

List all sessions as json

sessionizer sessions --json
[
  {
    "name": "default",
    "path": "/Users/person/Downloads",
    "attached": false
  },
  {
    "name": "personal/project",
    "path": "/Users/person/Projects/personal/project",
    "attached": true
  },
  ...
]

List windows of attached session (as json)

sessionizer windows --json
[
  {
    "id": "@10",
    "active": true,
    "active_clients": 1,
    "name": "fish"
  }
]

Where:

• active — the window is the one currently selected by its session
• active_clients — how many clients are actively viewing it

A detached session's window can still be active, just with one fewer active_clients.

Start default session

sessionizer start

TODO

• prevent user giving the default session a name containing . or :

Documentation

Overview

Copyright © 2024 Oliver Schrenk