zellij-org/zellij · error

guest modal selection requires a client id

Error message

guest modal selection requires a client id

What it means

Error "guest modal selection requires a client id" thrown in zellij-org/zellij.

Source

Thrown at zellij-server/src/panes/terminal_pane.rs:347

        // here we match against those cases - if need be, we adjust the input and if not
        // we send back the original input

        self.reset_selection(client_id);
        if !self.grid.bracketed_paste_mode {
            // Zellij itself operates in bracketed paste mode, so the terminal sends these
            // instructions (bracketed paste start and bracketed paste end respectively)
            // when pasting input. We only need to make sure not to send them to terminal
            // panes who do not work in this mode
            match raw_input_bytes.as_slice() {
                BRACKETED_PASTE_BEGIN | BRACKETED_PASTE_END => {
                    return Some(AdjustedInput::WriteBytesToTerminal(vec![]))
                },
                _ => {},
            }
        }

        if let Some(selection) = client_id.and_then(|c| self.guest_modal.get(&c).copied()) {
            let client_id = client_id.expect("guest modal selection requires a client id");
            let is_up = key_with_modifier
                .as_ref()
                .map(|k| {
                    k.is_key_without_modifier(BareKey::Up)
                        || k.is_key_without_modifier(BareKey::Char('k'))
                })
                .unwrap_or(false)
                || raw_input_bytes.as_slice() == UP_ARROW;
            let is_down = key_with_modifier
                .as_ref()
                .map(|k| {
                    k.is_key_without_modifier(BareKey::Down)
                        || k.is_key_without_modifier(BareKey::Char('j'))
                })
                .unwrap_or(false)
                || raw_input_bytes.as_slice() == DOWN_ARROW;
            let is_enter = key_with_modifier
                .as_ref()

View on GitHub (pinned to bf8d23a4f7)

Solutions

1. Ensure modal selection is only invoked with an attached client.
2. This is internal; report if reached through normal usage.

When it happens

Trigger: Occurs at zellij-server/src/panes/terminal_pane.rs:347 when the operation fails: "guest modal selection requires a client id". Currently there is no defensive handling preventing or contextualizing this failure before it surfaces.

Common situations: Internal state error in web/guest client handling.

AI-assisted analysis of zellij-org/zellij@bf8d23a4f7 (2026-08-19). Data as JSON: /api/errors/db840016c00b0569. Report an issue: GitHub.