zed-industries/zed · error

Failed to initialize event loop handling of foreground tasks

Error message

Failed to initialize event loop handling of foreground tasks: {err:?}

What it means

Raised in X11Client::new: calloop refused to insert the channel source that feeds foreground runnables (GPUI tasks) into the event loop, so the loop cannot be started at all. The {err:?} is the calloop InsertError from handle.insert_source on the runnable channel.

Source

Thrown at crates/gpui_linux/src/linux/x11/client.rs:349

                    if let calloop::channel::Event::Msg(runnable) = event {
                        // Insert the runnables as idle callbacks, so we make sure that user-input and X11
                        // events have higher priority and runnables are only worked off after the event
                        // callbacks.
                        handle.insert_idle(|client| {
                            let location = runnable.metadata().location;
                            let spawned = runnable.metadata().spawned;
                            profiler::update_running_task(spawned, location);
                            runnable.run();
                            profiler::save_task_timing();

                            let xcb_connection = client.0.borrow().xcb_connection.clone();
                            client.process_x11_events(&xcb_connection).log_err();
                        });
                    }
                }
            })
            .map_err(|err| {
                anyhow!("Failed to initialize event loop handling of foreground tasks: {err:?}")
            })?;

        handle
            .insert_source(power_receiver, |event, _, client: &mut X11Client| {
                if let calloop::channel::Event::Msg(event) = event {
                    client
                        .0
                        .borrow_mut()
                        .common
                        .handle_system_power_event(event);
                }
            })
            .map_err(|err| {
                anyhow!("Failed to initialize event loop handling of sleep/wake events: {err:?}")
            })?;

        let (xcb_connection, x_root_index) = XCBConnection::connect(None)?;
        xcb_connection.prefetch_extension_information(xkb::X11_EXTENSION_NAME)?;

View on GitHub (pinned to 9d272b0363)

Solutions

1. Inspect the calloop InsertError — commonly a capacity/registration failure on the event loop handle
2. Ensure insert_source is called on a valid, not-yet-dispatched LoopHandle before run()
3. Propagate the error so application startup aborts with a clear message instead of a silently dead task channel

When it happens

Trigger: Thrown at crates/gpui_linux/src/linux/x11/client.rs:338 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of zed-industries/zed@9d272b0363 (2026-08-20). Data as JSON: /api/errors/c030b8702c34be6a. Report an issue: GitHub.