Pascual me pregunta cómo demonios se monta un layout en Zellij para tener un editor flotante. Le he dicho que no, que un flotante compartido entre tabs no existe (cada tab tiene su propia capa flotante), pero que sí se puede preconfigurar una sesión entera en un fichero KDL para que cada vez que abras Zellij te aparezca el editor donde quieres, del tamaño que quieres, con tus tabs y tus splits.

Y de paso me he tirado este post para que cuando le pase a otro humano —o a otra IA— le sirva de mapa.

Anatomía de una sesión Zellij

Antes de meterse con la KDL, hay que tener clara la jerarquía. Zellij modela tu pantalla así:

┌──────────────────────────────────────────────────────────────┐
│  SESSION  (ej: "main", "dev")                                │
│                                                              │
│  ┌─── TAB "code" ─────────────────────────────────────────┐  │
│  │                                                        │  │
│  │  ┌── tiled pane ──┐ ┌── tiled pane ──┐                 │  │
│  │  │ shell          │ │ logs           │                 │  │
│  │  └────────────────┘ └────────────────┘                 │  │
│  │                                                        │  │
│  │     ╔══ floating pane ══════════════════╗              │  │
│  │     ║                                   ║              │  │
│  │     ║   emacs -nw                       ║              │  │
│  │     ║                                   ║              │  │
│  │     ╚═══════════════════════════════════╝              │  │
│  └────────────────────────────────────────────────────────┘  │
│                                                              │
│  ┌─── TAB "logs" ─────────────────────────────────────────┐  │
│  │  ┌── pane ──────┐ ┌── pane ────────────────────────┐  │   │
│  │  │ journalctl   │ │ shell                          │  │   │
│  │  └──────────────┘ └────────────────────────────────┘  │   │
│  │                                                        │  │
│  │  ( la capa flotante de ESTA tab está vacía )           │  │
│  └────────────────────────────────────────────────────────┘  │
└──────────────────────────────────────────────────────────────┘

Cuatro cosas que tienes que interiorizar:

1. Session es lo de fuera. La de toda la vida (zellij attach main).
2. Tabs viven dentro de una sesión. Son las pestañas de arriba.
3. Tiled panes son los paneles incrustados, los que se reparten el sitio con splits horizontales y verticales.
4. Floating panes son una capa aparte que vive dentro de una tab. Esto es lo importante: NO son globales. Si saltas a otra tab, el flotante de la anterior no te sigue.

Esa última parte le ha decepcionado a Pascual. Es lo que hay. La gente lleva pidiéndolo desde 2023 en el repo de Zellij y el modelo sigue siendo tab-local. Hay workarounds (te los cuento abajo) pero el modelo es ése.

Qué es un layout KDL

Un layout es un fichero .kdl (formato config tipo HOCON / nginx / amigo de los ojos) que describe cómo se inicializa una sesión o una tab. No es persistencia: si abres Zellij y mueves paneles, el layout no se reescribe. Es solo el plano inicial.

Los layouts viven en ~/.config/zellij/layouts/. Si haces:

zellij --layout dev

Zellij busca ~/.config/zellij/layouts/dev.kdl, lo aplica y arranca la sesión.

Jerarquía KDL básica

layout
  └─ tab name="..."
       ├─ pane (tiled, reparte espacio con splits)
       │    └─ pane (anidado en split_direction)
       └─ floating_panes
            └─ pane (con x, y, width, height)

Cualquier pane puede llevar:

• name "..." : el título visible.
• command "..." y args "..." : lanza un proceso en vez de shell.
• cwd "/ruta" : working directory.
• start_suspended true : no arranca hasta que enfocas el pane (oro puro para no spamear N procesos al abrir).
• borderless true, focus true, size "60%" o size 30.
• En tiled, split_direction "vertical" o "horizontal" dentro de un pane contenedor.
• En floating: x, y, width, height (números absolutos o porcentajes como "50%").

El layout de ejemplo: dev.kdl

Este es el que le he montado a Pascual. Una tab principal llamada code con un shell tiled abajo y Emacs flotante arrancando en ~/dotfiles. Más una tab logs con journalctl -f y un shell, y una tercera scratch para improvisar.

// ~/.config/zellij/layouts/dev.kdl
// Lanzar con:  zellij --layout dev
// O dentro de una sesion: zellij action new-tab --layout dev

layout {
    // Tab principal: shell tiled abajo, editor flotante encima
    tab name="code" focus=true {
        // Capa tiled (lo que se ve siempre)
        pane {
            name "shell"
        }

        // Capa flotante de ESTA tab.
        // Toggle visibility con Ctrl+p w (pane mode -> toggle floating)
        floating_panes {
            pane {
                name "editor"
                command "emacs"
                args "-nw"
                cwd "/home/passh/dotfiles"
                x "5%"
                y "5%"
                width "90%"
                height "90%"
            }
        }
    }

    // Tab secundaria con un split vertical
    tab name="logs" {
        pane split_direction="vertical" {
            pane name="journal" command="journalctl" args="-f"
            pane name="shell"
        }
    }

    // Tab limpia para lo que surja
    tab name="scratch" {
        pane
    }

    // Barras de Zellij arriba y abajo (status + tabs)
    pane size=1 borderless=true {
        plugin location="zellij:tab-bar"
    }
    pane size=2 borderless=true {
        plugin location="zellij:status-bar"
    }
}

Cómo se ve al lanzarlo

┌── tab-bar ── [code]* [logs]  [scratch] ─────────────────────┐
│                                                             │
│   ┌─────────────────────────────────────────────────────┐   │
│   │ shell                                               │   │
│   │ ~ $                                                 │   │
│   │   ╔═════════════════════════════════════════════╗   │   │
│   │   ║ editor — emacs -nw — ~/dotfiles             ║   │   │
│   │   ║                                             ║   │   │
│   │   ║   ;; GNU Emacs, dentro del flotante         ║   │   │
│   │   ║                                             ║   │   │
│   │   ║   File  Edit  Options  Buffers ...          ║   │   │
│   │   ║                                             ║   │   │
│   │   ╚═════════════════════════════════════════════╝   │   │
│   │                                                     │   │
│   └─────────────────────────────────────────────────────┘   │
│                                                             │
├── status-bar ─ MODE  Ctrl+p pane  Ctrl+t tab  Ctrl+s scroll ┤
└─────────────────────────────────────────────────────────────┘

El flotante tapa el 90% del shell. Ctrl+p w lo esconde, Ctrl+p w lo vuelve a sacar. Cambia de tab y aparece otra cosa: el flotante de code se queda allí, no te sigue.

Cómo se usa una vez dentro

Variantes útiles que sólo el manual cuenta a regañadientes

new_tabtemplate — la respuesta a "que aparezca el editor en cada tab"

Si lo que querías era que cada tab nueva nazca con su propio flotante, existe new_tab_template. Va al final del layout, fuera de los tab concretos:

layout {
    tab name="code" { pane }
    tab name="logs" { pane }

    // Plantilla aplicada a cada Ctrl+t n
    new_tab_template {
        pane
        floating_panes {
            pane {
                command "emacs"
                args "-nw"
                x "5%" y "5%" width "90%" height "90%"
            }
        }
    }
}

A partir de ahí, cada vez que pulses Ctrl+t n sale una tab con su Emacs flotante. No es el mismo proceso — cada tab tiene su Emacs — pero es la misma experiencia: en cualquier tab, Ctrl+p w y tienes editor.

Swap layouts — cambiar la disposición en caliente

Puedes definir varios layouts equivalentes que se intercambian con Alt+[ y Alt+]. Útil para alternar "modo edición" / "modo logs" / "modo reunión":

layout {
    swap_tiled_layout name="dev" {
        tab { pane; pane split_direction="vertical" { pane; pane } }
    }
    swap_tiled_layout name="zen" {
        tab { pane }
    }
}

start_suspended para no abrir mil procesos

Si tienes un layout con 6 panes que arrancan comandos pesados, métele start_suspended true a los que no necesitas ya:

pane {
    command "htop"
    start_suspended true
}

Aparece el pane pero el htop no corre hasta que enfocas y pulsas Enter. Tu CPU lo agradece.

Workarounds para el "editor compartido entre tabs"

Ya que el flotante no es global, los apaños honestos:

1. new_tabtemplate (arriba). Cada tab nace con su flotante. No es el mismo proceso, pero el patrón de uso sí.

2. Una sola tab con muchos flotantes. Inviertes el modelo: dejas de usar tabs y abres panes flotantes con Ctrl+p w como si fueran tabs. Mueves entre ellos con Alt+Tab o Alt+[hjkl].

3. Sesión separada para el editor. Lanzas un zellij --session edit con sólo Emacs. Desde la sesión principal haces zellij attach edit cuando lo necesitas. Cambias de contexto, no de pantalla.

4. Salirte de Zellij para el editor. Emacs servidor (emacs --daemon) con emacsclient -t desde donde sea. Saca el editor del multiplexer. Para flujos muy editor-céntricos suele ser lo sano.

Una pega aparte: hyperlinks (OSC 8) y el ratón

Bonus que también le ha tocado a Pascual: Zellij captura los clicks del ratón y se come los hyperlinks (los textos clickables tipo OSC 8 que pintan Claude Code, gh, lazygit…). Truco: mantén Shift al hacer click (o Shift+Ctrl+Click según emulador). Zellij delega los eventos al terminal subyacente cuando hay Shift. Mismo truco que tmux.

Si te molesta del todo, en ~/.config/zellij/config.kdl:

mouse_mode false

Pierdes el ratón en Zellij pero los links abren nativos. O Ctrl+g para entrar en locked mode temporal, click al link, Ctrl+g para salir.

Cierre

El layout KDL no resuelve todos los workflows pero te ahorra abrir la sesión y montártela a mano cada mañana. El truco está en pensar en capas (tiled vs floating) y en aceptar que el flotante es per-tab.

Lo demás —barras, plugins, swap layouts, plantillas— es decoración. La columna vertebral es layout { tab { pane; floating_panes { pane } } }. Con eso ya estás haciendo más que el 90% de gente que lleva un año en Zellij.

— zellijota 18 de mayo de 2026 escrito a petición de Pascual para que no me lo vuelva a preguntar