luccahuguet / yazelix

Yazelix v13.5 Preview The repo keeps one maintained static preview. Add richer demos only when there is a clear front-door surface that actually needs them; see docs/preview_assets.md for the lightweight capture policy. Overview Yazelix integrates Yazi, Zellij, and Helix (hence the name!), with first-class support for Neovim too. • Yazelix now uses the devenv-based shell ( ) and . The legacy flake interface ( , ) has been removed. • **Use your preferred shell**: Bash, Fish, Zsh, or Nushell - Yazelix works with all of them • Zellij orchestrates everything, with Yazi as a sidebar and your chosen editor (Helix by default) • Toggle focus between the sidebar and editor with , and toggle the sidebar itself with • Every keybinding from Zellij that conflicts with Helix is remapped see here • When you hit Enter on a file/folder in the "sidebar": • **With Helix or Neovim**: Targets the managed pane through the Yazelix Zellij plugin. If that pane exists in the current tab, the file opens there. If not, Yazelix launches a new editor pane titled . • **With other editors**: Opens the file in a new pane with your configured editor • It automatically renames the Zellij tab to the file's underlying Git repo or directory name • Features include: • "Reveal file in sidebar" (bind to any editor-local shortcut you prefer in Helix/Neovim, and use to jump between the editor and sidebar, see Keybindings) • A Yazi plugin to enhance the status bar in the sidebar pane, making it uncluttered, colorful, and showing file permissions • A Git plugin showing file changes in the Yazi sidebar • Dynamic column updates in Yazi (parent, current, preview) via the auto-layout plugin, perfect for sidebar use • **Modular editor support**: Helix and Neovim have full integration features, or use any other editor via the setting • This project includes config files for Zellij, Yazi, terminal emulators, Nushell scripts, Lua plugins, and a lot of love Why Yazelix Yazelix is a reproducible terminal IDE that integrates Yazi + Zellij + Helix. It delivers a consistent, fast “superterminal” locally or over SSH with zero manual setup: smart pane/layout orchestration, sidebar reveal/open flows, curated packs, and sane defaults. It also solves helix/zellij keybinding conflicts (no need to ever lock zellij), auto‑configures great tools like starship, zoxide, carapace (that normally require editing shell config files), and includes many tools from the Yazelix Collection, like lazygit It already comes with cool zellij and yazi plugins, some of which I maintain myself It has features like (from Helix or Neovim) and opening files from Yazi in your configured editor Supports top terminals (Ghostty, WezTerm, Kitty, Alacritty) and popular shells (Bash, Zsh, Fish, Nushell). Easy to configure via , with providing the environment Get everything running in less than 10 minutes. No extra dependencies, only Nix Install once, get the same environment everywhere Want the high-level product map? See Architecture Map. Vision • Using the terminal should be easy, beautiful, practical and reproducible • Good defaults over customization. Have both when possible • Yazelix is always on the edge of project versions • Yazelix is always evolving, it's a living being • What is even Yazelix? • Yazelix lets you say • Boy, do we Nix • Integration, integration, integration • Made with love. Acknowledgments See Yazelix Collection for a full list of all projects, tools, and plugins Yazelix integrates, including links to each project and their homepages. Improvements in v13.2 • **Workspace Hardening** - New-tab workspace defaults, tab-local workspace routing, and the / workspace flows were tightened so Yazelix behaves more predictably across tabs • **Zellij Integration Hardening** - The pane orchestrator and layout/config generation were further hardened to reduce stale state, helper-pane traps, and workspace drift • **Keybinding Model Polish** - and the README/docs now describe the current workspace actions more clearly, especially around , , and editor/sidebar movement Improvements in v13.1 • **Cross-Tab Yazi Cwd Isolation** - and related sidebar sync flows now resolve the current tab's managed Yazi pane instead of guessing from session-global state, fixing the cross-tab cwd leak that could show up when every tab starts with Yazi • **Stronger Workspace Cwd Routing** - The flow now has better tab retargeting, managed-editor cwd sync, cleaner tab naming, and tighter Yazi workspace keybinding alignment • **Better Workspace Diagnostics and Controls** - can diagnose Zellij plugin health, exposes the current keymap surface more clearly, and Zellij default mode handling is now configurable • **Agent and Update Flow Polish** - Yazelix now ships the command, added pi-agent support before later removing the unstable local packaging, and further hardened the canary/update path Improvements in v13 • **The Biggest Pain Points Are Fixed** – v13 replaces fragile pane-scanning flows with a real Zellij plugin that tracks the managed and panes and routes workspace actions directly instead of relying on shell heuristics • **The Sidebar Can Always Find the Editor** – The sidebar can now always find the managed pane and open files in it reliably, and it is much faster because Yazelix no longer has to walk through panes or rely on pane-scanning heuristics • **Sidebar and Layout Controls Are Finally Separate** – Sidebar open/close now has its own binding instead of being entangled with layout-family switching on and • **Deterministic Workspace Navigation** – toggles focus between the managed editor and sidebar, while and switch predictably between the , , and layouts • **Cleaner Keybinding Model** – Editor/sidebar navigation is unified, editor-local reveal bindings are documented explicitly, and the temporary wrapper-pane transport was replaced with direct plugin messages • **Runtime Plugin Reliability** – The pane orchestrator now ships through a content-hashed runtime wasm path, a…