linux/ohmyzsh
1
0
Fork 0
mirror of https://github.com/ohmyzsh/ohmyzsh.git synced 2026-03-27 03:14:56 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions
ohmyzsh/plugins/zellij/README.md
hobe da2d2102fc feat(zellij): add force-delete function with all-session completion 
Add `df` function (`zjdf`/`zdf`) that runs `zellij delete-session --force`,
which can delete running sessions without killing them first (zellij ≥0.44).
Completes against all sessions, unlike `d` which only shows exited ones.
2026-03-25 13:53:06 +09:00

3.8 KiB
Raw Blame History

zellij

This plugin provides aliases, functions, and completions for zellij, the terminal workspace (multiplexer). To use it, add zellij to the plugins array in your zshrc file.

plugins=(... zellij)

Dynamic prefix

The default prefix is zj. To use the shorter z prefix instead, set the following variable before oh-my-zsh is sourced:

ZSH_ZELLIJ_PREFIX_Z=true

When ZSH_ZELLIJ_PREFIX_Z is set, the root alias (z) and sub-command prefix are handled separately:

  • If z is not taken → z=zellij, sub-commands use z prefix (zl, za, …)
  • If z is taken (e.g., by zoxide) → zj=zellij, but sub-commands still use z prefix (zl, za, …)

This means only the root alias falls back to zj; the shorter sub-command shortcuts remain usable.

All aliases and functions perform a conflict check before being defined — if a name is already taken by another alias, function, or command, it is silently skipped.

Aliases

Alias (default) Alias (with z) Alias (z + conflict) Command Description
zj z zj zellij Zellij command
zjl zl zl zellij list-sessions List sessions
zjs zs zs zellij -s Start a named session
zjda zda zda zellij delete-all-sessions Delete all sessions
zjka zka zka zellij kill-all-sessions Kill all sessions
zjr — — zellij run Run a command in a pane
zjad zad zad zellij action detach Detach from current session

Functions

Function (default) Function (with z) Command Description
zja za zellij attach Attach to a session
zjd zd zellij delete-session Delete a session (exited only)
zjdf zdf zellij delete-session --force Force-delete any session
zjk zk zellij kill-session Kill a session
zjas zas zellij action switch-session Switch to a session

The following convenience functions are always available (unless the name is already taken):

Function Command Description
zr zellij run -- Run a command in a pane
zrf zellij run --floating -- Run a command in a floating pane
ze zellij edit Edit a file in a pane

Help

Type zjh (or zh with z prefix) to see a summary of all available aliases and functions.

Completions

This plugin caches the zellij completion script. On first load the cache is generated synchronously; subsequent updates (when the zellij binary is newer than the cache) happen in the background.

Session-aware completions are provided for attach, delete-session, and kill-session functions — only relevant sessions (all, running, or exited) are offered.