zellij-org/zellij · error

failed to receive app instruction on channel

Error message

failed to receive app instruction on channel

What it means

Error "failed to receive app instruction on channel" thrown in zellij-org/zellij.

Source

Thrown at zellij-client/src/lib.rs:1401

            full_screen_ws.rows,
            !explicitly_disable_kitty_keyboard_protocol,
        );
        let mut stdout = os_input.get_stdout_writer();
        stdout.write_all(error.as_bytes()).unwrap();
        stdout.flush().unwrap();
        std::process::exit(1);
    };

    let mut exit_msg = String::new();
    let mut synchronised_output = match os_input.env_variable("TERM").as_deref() {
        Some("alacritty") => Some(SyncOutput::DCS),
        _ => None,
    };

    loop {
        let (client_instruction, mut err_ctx) = receive_client_instructions
            .recv()
            .expect("failed to receive app instruction on channel");

        err_ctx.add_call(ContextType::Client((&client_instruction).into()));

        match client_instruction {
            ClientInstruction::Exit(reason) => {
                os_input.send_to_server(ClientToServerMsg::ClientExited);

                if let ExitReason::Error(_) = reason {
                    handle_error(reason.to_string());
                }
                exit_msg = reason.to_string();
                break;
            },
            ClientInstruction::Error(backtrace) => {
                handle_error(backtrace);
            },
            ClientInstruction::Render(output) => {
                let mut stdout = os_input.get_stdout_writer();

View on GitHub (pinned to e839bfffa5)

Solutions

1. The receiving end has shut down; ensure the component is alive before sending.
2. Treat this as a shutdown race; retry after restart or report if reproducible.

When it happens

Trigger: Occurs at zellij-client/src/lib.rs:1378 when the operation fails: "failed to receive app instruction on channel". Currently there is no defensive handling preventing or contextualizing this failure before it surfaces.

Common situations: Typically happens during shutdown or crash of a companion thread.

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