OS Manuals

/usr/bin/zellij

A terminal workspace with batteries included

From zellij 0.45.1-r8 (os), captured 2026-11-05 by running zellij --help (exit 0). permalink

A terminal workspace with batteries included

Usage: zellij [OPTIONS] [COMMAND]

Commands:
  options              Change the behaviour of zellij
  setup                Setup zellij and check its configuration
  web                  Run a web server to serve terminal sessions
  action               Send actions to a specific session [alias: ac]
  list-sessions        List active sessions [alias: ls]
  list-aliases         List existing plugin aliases [alias: la]
  attach               Attach to a session [alias: a]
  watch                Watch a session (read-only) [alias: w]
  kill-session         Kill a specific session [alias: k]
  delete-session       Delete a specific session [alias: d]
  kill-all-sessions    Kill all sessions [alias: ka]
  delete-all-sessions  Delete all sessions [alias: da]
  run                  Run a command in a new pane Returns: Created pane ID (format: terminal_<id>)
                       [alias: r]
  plugin               Load a plugin Returns: Created pane ID (format: plugin_<id>) [alias: p]
  edit                 Edit file with default $EDITOR / $VISUAL Returns: Created pane ID (format:
                       terminal_<id>) [alias: e]
  pipe                 Send data to one or more plugins, launch them if they are not running
  subscribe            Subscribe to pane render updates (viewport and scrollback)
  help                 Print this message or the help of the given subcommand(s)

Options:
      --max-panes <MAX_PANES>
          Maximum panes on screen, caution: opening more panes will close old ones
      --data-dir <DATA_DIR>
          Change where zellij looks for plugins
  -s, --session <SESSION>
          Specify name of a new session
  -l, --layout <LAYOUT>
          Name of a predefined layout inside the layout directory or the path to a layout file if
          inside a session (or using the --session flag) will be added to the session as a new tab
          or tabs, otherwise will start a new session
      --layout-string <LAYOUT_STRING>
          Raw KDL layout string to use directly (instead of a file path) if inside a session (or
          using the --session flag) will be added to the session as a new tab or tabs, otherwise
          will start a new session
  -n, --new-session-with-layout <NEW_SESSION_WITH_LAYOUT>
          Name of a predefined layout inside the layout directory or the path to a layout file Will
          always start a new session, even if inside an existing session
  -c, --config <CONFIG>
          Change where zellij looks for the configuration file [env: ZELLIJ_CONFIG_FILE=]
      --config-dir <CONFIG_DIR>
          Change where zellij looks for the configuration directory [env: ZELLIJ_CONFIG_DIR=]
  -d, --debug
          Specify emitting additional debug information
  -h, --help
          Print help
  -V, --version
          Print version
Options (11)
OptionDescriptionSource
--max-panes MAX_PANESMaximum panes on screen, caution: opening more panes will close old oneshelp
--data-dir DATA_DIRChange where zellij looks for pluginshelp
-s, --session SESSIONSpecify name of a new sessionhelp
-l, --layout LAYOUTName of a predefined layout inside the layout directory or the path to a layout file if inside a session (or using the --session flag) will be added to the session as a new tab or tabs, otherwise…help
--layout-string LAYOUT_STRINGRaw KDL layout string to use directly (instead of a file path) if inside a session (or using the --session flag) will be added to the session as a new tab or tabs, otherwise will start a new sessionhelp
-n, --new-session-with-layout NEW_SESSION_WITH_LAYOUTName of a predefined layout inside the layout directory or the path to a layout file Will always start a new session, even if inside an existing sessionhelp
-c, --config CONFIGChange where zellij looks for the configuration file [env: ZELLIJ_CONFIG_FILE=]help
--config-dir CONFIG_DIRChange where zellij looks for the configuration directory [env: ZELLIJ_CONFIG_DIR=]help
-d, --debugSpecify emitting additional debug informationhelp
-h, --helpPrint helphelp
-V, --versionPrint versionhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.