Possible Actions

`Clear`

Clear the scrollback buffer of the focused pane

Possible arguments: None

eg.

    bind "a" { Clear; }

`CloseFocus`

Close the focused pane

Possible arguments: None

eg.

    bind "a" { CloseFocus; }

`CloseTab`

Close the focused tab

Possible arguments: None

eg.

    bind "a" { CloseTab; }

`Detach`

Detach from the current session, leaving it running in the background

Possible arguments: None

eg.

    bind "a" { Detach; }

`DumpScreen`

Dump the contents of the focused pane, including its entire scrollback, to the specified file.

Required arguments: A path to a file on the hard-drive

eg.

    bind "a" { DumpScreen "/tmp/my-dump.txt"; }

`EditScrollback`

Edit the scrollback of the currently focused pane with the user's default editor.

Possible arguments: None

    bind "a" { EditScrollback; }

`FocusNextPane`

Change focus to the next pane (order not guaranteed)

Possible arguments: None

    bind "a" { FocusNextPane; }

`FocusPreviousPane`

Change focus to the previous pane (order not guaranteed)

Possible arguments: None

    bind "a" { FocusPreviousPane; }

`GoToNextTab`

Change focus to the next tab

Possible arguments: None

    bind "a" { GoToNextTab; }

`GoToPreviousTab`

Change focus to the previous tab

Possible arguments: None

    bind "a" { GoToPreviousTab; }

`GoToTab`

Change focus to a tab with a specific index

Required arguments: numeric tab index (eg. 1)

    bind "a" { GoToTab 1; }

`HalfPageScrollDown`

Scroll the focused pane half a page down

Possible arguments: None

    bind "a" { HalfPageScrollDown; }

`HalfPageScrollUp`

Scroll the focused pane half a page up

Possible arguments: None

    bind "a" { HalfPageScrollUp; }

`LaunchOrFocusPlugin`

Launch a plugin if it is not already loaded somewhere in the session, focus it if it is

Required arguments: The plugin URL (eg. file:/path/to/my/plugin.wasm)

Optional arguments: floating - true or false (default is false)

    bind "a" {
        LaunchOrFocusPlugin "zellij:strider" {
            floating true
        }
    }

`MessagePlugin`

Send a message to one or more plugins, using a pipe - meaning the plugin will be launched if it is not already running.

Required arguments: None (with no options specified, this keybind will send an empty message to all plugins)

Optional arguments:: - launch_new (true/false): force a new plugin to launch even if one is already running - skip_cache (true/false): force re-compilation (and re-download if the plugin is http), even if the plugin is already running or cached - floating (true/false): if launching a new plugin, should it be floating or tiled - name (String): The name of the message - payload (String): The payload of the message - title (String): The pane title of the pane if launching a new plugin instance - cwd (String): The working directory of the plugin if launching a new instance

    bind "a" {
        MessagePlugin "file:/path/to/my/plugin.wasm" {
            name "message_name"
            payload "message_payload"
            cwd "/path/to/my/working/directory"
        }
    }

`MoveFocus`

Move focus in a specific direction

Required arguments: Left | Right | Up | Down

    bind "a" { MoveFocus "Left"; }

`MoveFocusOrTab`

Move focus left or right, or to the next or previous tab if on screen edge

Required arguments: Left | Right

    bind "a" { MoveFocusOrTab "Left"; }

`MovePane`

Move the position of the focused pane in the specific direction

Required arguments: Left | Right | Up | Down

    bind "a" { MovePane "Left"; }

`MoveTab`

Change the position of the active tab either left or right.

Required arguments: the direction, either "Left" or "Right"

    bind "a" { MoveTab "Left"; }

`NextSwapLayout`

Change the layout of the current tab (either tiled or floating) to the next one

Possible arguments: None

    bind "a" { NextSwapLayout; }

`NewPane`

Open a new pane (in the specified direction)

Possible arguments: Down | Right

Behaviour without arguments: Opens a pane in the largest available space or if floating panes are visible, in the next floating pane position.

    bind "a" { NewPane "Right"; }

`NewTab`

Open a new tab

Possible arguments: cwd

Current working directory for the new tab, name - the name of the new tab, layout - path to the layout file to load for this tab

    bind "a" { NewTab; }

or:

    bind "a" {
       NewTab {
           cwd "/tmp"
           name "My tab name"
           layout "/path/to/my/layout.kdl"
       }
    }

`PageScrollDown`

Scroll the focused pane one page down

Possible arguments: None

    bind "a" { PageScrollDown; }

`PageScrollUp`

Scroll the focused pane one page up

Possible arguments: None

    bind "a" { PageScrollUp; }

`PreviousSwapLayout`

Change the layout of the current tab (either tiled or floating) to the previous one

Possible arguments: None

    bind "a" { PreviousSwapLayout; }

`Quit`

Quit Zellij :(

Possible arguments: None

    bind "a" { Quit; }

`Resize`

Resize the focused pane either in the specified direction or increase/decrease its size automatically

    bind "a" { Resize "Increase"; }

`Run`

Run the specified command

Required arguments: The command to run, followed by optional arguments

Possible arguments: cwd - current working directory, direction - the direction to open the new command pane

    // will run "tail -f /tmp/foo" in a pane opened below the focused one
    bind "a" {
        Run "tail" "-f" "foo" {
            cwd "/tmp"
            direction "Down"
        }
    }

`ScrollDown`

Scroll the focused pane down 1 line

Possible arguments: None

    bind "a" { ScrollDown; }

`ScrollToBottom`

Scroll the focused pane completely down

Possible arguments: None

    bind "a" { ScrollToBottom; }

`ScrollUp`

Scroll the focused pane up 1 line

Possible arguments: None

    bind "a" { ScrollUp; }

`ScrollToTop`

Scroll the focused pane completely up

Possible arguments: None

    bind "a" { ScrollToTop; }

`Search`

When searching, move to the next or previous search occurrence

Required arguments: "down" | "up"

    bind "a" { Search "up"; }

`SearchToggleOption`

Toggle various search options on/off

Required arguments: "CaseSensitivity" | "Wrap" | "WhileWord"

    bind "a" { SearchToggleOption "CaseSensitivity"; }

`SwitchToMode`

Switch the current input mode

Required arguments: See Modes

    bind "a" { SwitchToMode "locked"; }

`ToggleActiveSyncTab`

Toggle the syncing of input between all panes in the focused tab

Possible arguments: None

    bind "a" { ToggleActiveSyncTab; }

`ToggleFloatingPanes`

Show/hide floating panes; if none are open, one will be opened

Possible arguments: None

    bind "a" { ToggleFloatingPanes; }

`ToggleFocusFullscreen`

Toggle the focused pane as fullscreen on/off

Possible arguments: None

    bind "a" { ToggleFocusFullscreen; }

`ToggleMouseMode`

Toggle mouse support on/off

Possible arguments: None

    bind "a" { ToggleMouseMode; }

`TogglePaneEmbedOrFloating`

Float focused embedded pane or embed focused floating pane

Possible arguments: None

    bind "a" { TogglePaneEmbedOrFloating; }

`TogglePaneFrames`

Show/hide the frames around panes (notice, these might have valuable UX info)

Possible arguments: None

    bind "a" { TogglePaneFrames; }

`ToggleTab`

Change the tab focus

Possible arguments: None

    bind "a" { ToggleTab; }

`UndoRenamePane`

Undo a rename pane operation currently in progress (reverting to the previous name)

Possible arguments: None

    bind "a" { UndoRenamePane; }

`UndoRenameTab`

Undo a rename tab operation currently in progress (reverting to the previous name)

Possible arguments: None

    bind "a" { UndoRenameTab; }

`Write`

Write bytes to the active pane

Required arguments: the bytes to write as integers

    bind "a" { Write 102 111 111; }

`WriteChars`

Write a string of characters to the active pane

Required arguments: the string of characters to write

    bind "a" { WriteChars "hi there!"; }

Zellij User Guide