Learn Zellij - The Filepicker & File Navigation

#Introduction

Welcome to episode 14 of the Learn Zellij series! After the automation era of episode 13, we now turn to one of Zellij's most user-facing tools: the Filepicker. This is a file and directory picker with file previews, available as an overlay from anywhere in Zellij (since 0.40), which makes finding files, jumping between directories, and opening files in an editor fast and natural — all without leaving the multiplexer.

There are three things you'll master: (1) the Filepicker overlay — opening it, navigating directories, and selecting files with a live preview, (2) Strider — Zellij's default file-explorer plugin that lives in a pane, and (3) how the Filepicker and Strider integrate with layouts and CLI actions — building them into automated workspaces. The examples in this episode are practical; you'll want a terminal with a Zellij session open to follow along.

From the start, understand the distinction between the two: the Filepicker is a temporary overlay opened with a keybinding — perfect for quick file selection, and since 0.40 it includes a built-in file preview. Strider is a file explorer plugin that stays in a pane — perfect for ongoing navigation, like a file manager inside your terminal. Both read the same filesystem; the difference is when and how they appear. Let's start with the Filepicker.

#The Filepicker

The Filepicker is an overlay that appears on top of the current pane and lets you navigate directories and select files. In Zellij 0.40, it received significant improvements: a built-in preview of file contents, the ability to close on selection, and better support for complex layouts. Here's the flow:

# Default keybinding
Ctrl+f

Press Ctrl+f in a session to open the Filepicker. A directory tree appears — navigate with the arrow keys, move between directories by selecting them, and press Enter to select a file. You can search for files by typing, and various actions in the picker let you open files in an editor or a new pane.

#Filepicker Preview

One of the most useful features added in 0.40 is the Filepicker preview: when you highlight a file in the picker, its contents are displayed in a preview panel next to the directory tree. This turns the picker into a quick file reader — you can inspect files without opening them in an editor.

# Navigate to a file, read its contents in the preview panel
# Then decide: open it in an editor, or move on

The preview updates as you navigate, so you can skim many files quickly. For source code, configs, or logs, this is a fast way to find what you're looking for before committing to an editor.

#Quick Selection and Navigation

The Filepicker is designed for speed. Two features sharpen it: quick selection — selecting a file with a single keystroke instead of several navigation steps — and close-on-selection, which automatically closes the picker once a file is chosen, so you're not left with the overlay still open.

For those who want to see even more in the picker, there's also the ability to use the Filepicker to jump between directories — navigate into a directory, read files there, then jump back. This is handy when you're exploring an unfamiliar codebase and want to inspect several files in sequence.

#The Strider File Explorer

While the Filepicker is temporary, Strider is Zellij's default file-explorer plugin that stays in a pane. It's the equivalent of a file manager inside the terminal — you can open it in a dedicated pane, navigate the filesystem continuously, and use the files there to open editors, run commands, or inspect files while other panes work alongside.

# Open Strider in a new pane
Ctrl+n p

The exact keybinding may vary, but the idea is consistent: open Strider in a pane, and you have a persistent file explorer. When you select a file in Strider, Zellij opens it — often in an editor — while Strider remains in its pane, ready for the next selection.

Strider also integrates with the rest of Zellij's tooling. You can start Strider from a layout, so every session you spawn already has a file explorer ready. And because Strider is a plugin, it can be placed in a pane of a layout alongside the other panes you need.

#Integration with Layouts and CLI Actions

The Filepicker and Strider aren't isolated — they plug into the automation world of episode 13. In a layout, you can place Strider as a pane, so the workspace opens with a file explorer already running:

layout {
    pane split_direction="vertical" {
        pane {
            plugin "strider"
        }
        pane {
            command "vim"
            args "notes.md"
        }
    }
}

And through CLI actions, you can automate file operations. For example, opening a file in an editor from a script:

zellij action write-chars "vim main.ts"
zellij action write-chars --newline

This pattern — combined with the Filepicker's speed and Strider's persistence — turns file navigation into something you can both feel and script: quick picks by hand, persistent explorers in layouts, and file-opening actions from automation.

#Common Pitfalls

1. Treating the Filepicker as a persistent pane. It's an overlay — it closes after selection. Fix: if you need ongoing navigation, use Strider as a pane instead.
2. Ignoring the preview. The preview shows file contents before you open them. Fix: use it to inspect files before choosing — it saves opening wrong files in an editor.
3. Forgetting close-on-selection. By default you may need to close the picker manually after selecting. Fix: enable close-on-selection so the picker closes automatically once a file is chosen.
4. Not using Strider in layouts. A file explorer that must be re-opened manually each session is a wasted opportunity. Fix: place Strider as a pane in your layouts for a ready-made explorer.
5. Overlooking CLI integration. File opening can be automated with zellij action. Fix: use write-chars + write-chars --newline for scripted file opening in automated workflows.

#Closing

Episode 14 armed you with Zellij's file navigation tools. The Filepicker gives you a quick overlay with live previews and close-on-selection; Strider gives you a persistent file explorer pane. Together they cover every file-related workflow — from a quick Ctrl+f to a dedicated explorer living in a layout, and they both integrate with the automation machinery from episode 13.

Key takeaways:

• Ctrl+f opens the Filepicker; it's a temporary overlay with previews.
• The preview lets you inspect files before opening them.
• Close-on-selection turns file picking into a single-press action.
• Strider is a permanent file-explorer pane for ongoing navigation.
• Both work in layouts and with CLI actions for scripted file workflows.

Episode 15 next kicks off the third phase of the Learn Zellij series — Zellij as a production tool. We'll explore how Zellij fits into serious day-to-day work: practical workflows, SSH and remote sessions, and production layouts you can actually run. See you in episode 15!