Keybinding

Add the following to your zellij config somewhere inside the keybinds section:

shared_except "locked" {
    bind "Ctrl y" {
        LaunchOrFocusPlugin "file:~/.config/zellij/plugins/room.wasm" {
            floating true
            ignore_case true
            quick_jump true
        }
    }
}

You likely already have a shared_except "locked" section in your configs. Feel free to add bind there.

The ignore_case defaults to false if absent. If set to true, filtering the tab names ignores the case of the filter string and the tab name.

Pipe Commands

This plugin supports pipe commands for programmatic pane focusing via Zellij's plugin pipe system.

focus-pane

Focus a specific terminal pane by ID:

zellij pipe --plugin file:~/.config/zellij/plugins/room.wasm --name focus-pane -- <pane_id>

Why?

Claude Code supports terminal notifications to alert you when it needs input or permission. When running Claude Code inside Zellij, even if terminal notification passthrough worked, clicking a notification wouldn't navigate you to the correct Zellij tab and pane.

claude-zellij-whip solves this by sending native macOS notifications that, when clicked:

1. Focus your terminal window
2. Switch to the correct Zellij tab
3. Focus the exact pane where Claude Code is running

Zellij's CLI supports switching tabs but doesn't have a command to focus a specific pane by ID. The plugin API does support this via focus_terminal_pane, so this pipe command bridges that gap.

Contributing

If you find any issues or want to suggest ideas please open an issue.

Development

Make sure you have rust installed then run:

zellij action new-tab --layout ./dev.kdl