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
Hobeom e564461958 feat(zellij): add session functions, convenience commands, and smart completions 
- Use functions for attach/delete/kill to enable session-aware completions
- Add zr, zrf, ze convenience functions with conflict detection
- Improve z prefix collision check (aliases, functions, commands)
- Cache completions synchronously on first load, background on updates
- Update README to document new functions and completion behavior

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-09 22:57:30 +09:00

2.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 alias 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

Note: If z is already defined as an alias, function, or command by another plugin (e.g., zoxide), the zj prefix is used for the main zellij alias even when ZSH_ZELLIJ_PREFIX_Z is set.

Aliases

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

Functions

Function (default) Function (with z) Command Description
zja za zellij attach Attach to a session
zjd zd zellij delete-session Delete a session
zjk zk zellij kill-session Kill 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

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.