mirror of https://github.com/ohmyzsh/ohmyzsh.git synced 2026-03-27 03:14:56 +01:00

History

Hobeom 15fbdaab58 refactor(zellij): separate root alias from sub-command prefix Split _zellij_root_alias and _zellij_short_prefix so that when z is taken (e.g. by zoxide), only the root alias falls back to zj while sub-commands keep the shorter z prefix (zl, za, zk, zd, …). Every alias and function now checks for conflicts before defining, and compdef targets are collected dynamically to avoid binding completions to names that were never created. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-03-09 22:59:45 +09:00
..
README.md	refactor(zellij): separate root alias from sub-command prefix	2026-03-09 22:59:45 +09:00
zellij.plugin.zsh	refactor(zellij): separate root alias from sub-command prefix	2026-03-09 22:59:45 +09:00

Hobeom 15fbdaab58 refactor(zellij): separate root alias from sub-command prefix

Split _zellij_root_alias and _zellij_short_prefix so that when z is
taken (e.g. by zoxide), only the root alias falls back to zj while
sub-commands keep the shorter z prefix (zl, za, zk, zd, …).

Every alias and function now checks for conflicts before defining,
and compdef targets are collected dynamically to avoid binding
completions to names that were never created.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-03-09 22:59:45 +09:00

README.md

refactor(zellij): separate root alias from sub-command prefix

2026-03-09 22:59:45 +09:00

zellij.plugin.zsh

refactor(zellij): separate root alias from sub-command prefix

2026-03-09 22:59:45 +09:00

README.md

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

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.