Superfile: The Open-Source Terminal File Manager That Makes the Command Line Beautiful — 20,600+ GitHub Stars

If you spend hours in the terminal, you know the pain: navigating directories with cd, listing files with ls, copying with cp, and switching between tabs for every operation. What if your terminal had a file manager as powerful and beautiful as any GUI alternative?

Enter superfile — a modern terminal file manager that has captivated over 20,600 developers on GitHub. Built with Go and powered by the Bubble Tea TUI framework, superfile brings the elegance of graphical file managers to your command line without sacrificing speed or efficiency.

In this deep dive, we'll explore why superfile has become one of the most-starred terminal tools of 2025, how it compares to established alternatives, and how you can integrate it into your development workflow today.

Why Superfile? The Problem It Solves

Traditional terminal file management is fragmented. You open one terminal tab to browse files, another to copy or move them, and a third to check on a long-running operation. Tools like mc (Midnight Commander) and ranger have tried to bridge this gap, but they often feel dated or require steep learning curves.

Superfile takes a different approach. It presents five panels simultaneously on a single screen:

• Sidebar — Pinned directories and quick navigation
• File Panel — The main file browser with support for multiple tabs
• Processes — Real-time progress tracking for file operations
• Metadata — File details, permissions, and preview
• Clipboard — Visual tracking of cut/copied items

This multi-panel layout means you never lose context. You can see where you are, what you're doing, and what's in progress — all at a glance.

Installation: Up and Running in 30 Seconds

Superfile's installation is remarkably simple. Choose your platform:

macOS and Linux

bash -c "$(curl -sLo- https://superfile.dev/install.sh)"

Windows (PowerShell)

powershell -ExecutionPolicy Bypass -Command "Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://superfile.dev/install.ps1'))"

Windows Package Managers

# Using winget
winget install --id yorukot.superfile

# Using Scoop
scoop install superfile

Build from Source

If you prefer building from source (requires Go installed):

git clone https://github.com/yorukot/superfile.git --depth=1
cd superfile
./build.sh
sudo mv ./bin/spf /usr/local/bin

Once installed, simply type spf in your terminal and press Enter. That's it — no configuration required to get started.

Core Features That Set Superfile Apart

1. Multi-Panel File Management

Unlike single-pane file managers, superfile lets you open multiple file panels simultaneously. Press n to create a new panel, w to close one, and Tab or L to switch between them. This is incredibly useful for:

• Comparing directory contents side by side
• Dragging files between two locations
• Keeping a reference directory open while working elsewhere

2. Vim-Inspired Keybindings

If you're a Vim user, superfile will feel instantly familiar. Navigation uses h, j, k, l keys, and the selection mode mirrors Vim's visual mode. Press v to enter selection mode, then use J (Shift+j) to select items while moving down, or K (Shift+k) to select while moving up.

Non-Vim users needn't worry — arrow keys and standard shortcuts like Ctrl+C, Ctrl+V, and Ctrl+X work perfectly too.

3. Built-In Process Tracking

One of superfile's standout features is the processes panel. When you copy or move large files, you can see real-time progress in the bottom-left corner. No more wondering if that 10GB transfer is still running — superfile shows you exactly where it stands.

4. File Compression and Decompression

Archive management is built right in:

• Ctrl+A — Compress selected files/folders
• Ctrl+E — Decompress archives

No need to remember tar flags or zip syntax. Superfile handles it with a single keystroke.

5. Built-In Command Prompt

Press : to open the command bar and execute any shell command in the current directory. Press > for SPF mode, where you can run superfile-specific commands like:

# Open a new panel at a specific path
open ~/projects/my-app

# Change directory of current panel
cd ~/workspace

# Split panel at current location
split

6. Smart Search

Press / to activate instant search. Type a filename and superfile dynamically filters results in the current directory. It's fast, intuitive, and eliminates the need for find commands for quick lookups.

Customization: Themes and Plugins

Beautiful Themes Out of the Box

Superfile ships with a curated collection of themes, including popular choices like Catppuccin Mocha, Dracula, and One Dark. Switching themes is a one-line change in the config file:

# ~/.config/superfile/config.toml
theme = "catppuccin"

Want to create your own? Theme files use TOML format and let you control every color in the interface:

# Custom theme example
full_screen_fg = "#a6adc8"
full_screen_bg = "#1e1e2e"
gradient_color = ["#89b4fa", "#cba6f7"]
file_panel_fg = "#a6adc8"
file_panel_bg = "#1e1e2e"
file_panel_border = "#6c7086"
file_panel_border_active = "#b4befe"
cursor = "#f5e0dc"

Themes also support code syntax highlighting via the code_syntax_highlight option, powered by the Chroma library.

Plugin System

Superfile's plugin system extends functionality without modifying core code. The community has built plugins for everything from Git integration to file previewers, and the plugin API is straightforward for developers who want to build their own.

Real-World Example: A Developer's Daily Workflow

Let's see how superfile transforms a common development task. Imagine you need to:

1. Find a specific config file in a large project
2. Copy it to a backup location
3. Edit it in your preferred editor
4. Compress the modified project for deployment

Without superfile, you'd run something like:

find ~/projects/app -name "config.yaml" 2>/dev/null
cp ~/projects/app/src/config.yaml ~/backups/config.yaml.bak
nano ~/projects/app/src/config.yaml
cd ~/projects/app && tar -czf ~/deploy/app-v2.tar.gz .

With superfile, the same workflow becomes:

1. Open superfile: spf
2. Navigate to your project with h/j/k/l
3. Press / to search for "config.yaml" — found instantly
4. Open a second panel with n, navigate to ~/backups
5. Select the file with v then L, copy with Ctrl+C, paste with Ctrl+V
6. Press e to open in your editor
7. After editing, select the project folder and press Ctrl+A to compress

The entire operation stays within one terminal window, with visual feedback at every step. No context switching, no tab juggling.

Key Benefits of Using Superfile

• 🚀 Zero Configuration — Works out of the box with sensible defaults. Install and start using in under 30 seconds.
• 🎨 Beautiful by Default — Modern TUI with gradient accents, smooth animations, and a polished look that makes terminal work enjoyable.
• ⌨️ Dual Keybinding Modes — Supports both Vim-style and standard hotkeys, so every developer feels at home.
• 📊 Visual Progress Tracking — The processes panel shows real-time status of all file operations, eliminating guesswork.
• 🔌 Extensible — Plugin system and TOML-based configuration make it easy to customize for your workflow.
• 🔄 Auto-Update — Built-in update checker keeps you on the latest version without manual effort.
• 🌍 Cross-Platform — Full support for Linux and macOS, with growing Windows compatibility.
• 🆓 Free and Open-Source — MIT licensed, community-driven development with active GitHub maintenance.

How Does It Compare?

Here's how superfile stacks up against established terminal file managers:

Feature	Superfile	Ranger	Midnight Commander
Multi-panel view	✅ Unlimited	⚠️ 3 columns	⚠️ 2 panels
Modern TUI	✅ Bubble Tea	❌ Curses	❌ Curses
Process tracking	✅ Built-in	❌	⚠️ Basic
Custom themes (TOML)	✅	⚠️ Limited	⚠️ Skins
Plugin system	✅	✅ Python	❌
Built-in compression	✅	⚠️ Via commands	✅
Auto-update	✅	❌	❌
Language	Go	Python	C

Getting Started: Your First 5 Minutes with Superfile

Here's a quick-start guide to get productive immediately:

# 1. Install
bash -c "$(curl -sLo- https://superfile.dev/install.sh)"

# 2. Launch
spf

# 3. Navigate with h/j/k/l or arrow keys
# 4. Press ? for the help menu
# 5. Press q to exit

Pro tips for new users:

• Press ? to see all available hotkeys in an interactive help menu
• Press . to toggle dotfile visibility
• Press o to sort files by name, size, or date modified
• Press P (Shift+p) to pin frequently-used folders to the sidebar
• Set EDITOR=nvim in your shell to use your preferred editor with the e key

The Growing Superfile Ecosystem

With 20,600+ GitHub stars and active development, superfile has built a thriving community. The project benefits from:

• Active maintenance — Regular releases with new features and bug fixes
• Community contributions — Hundreds of contributors improving the codebase
• JetBrains support — Open-source license provided by JetBrains for maintenance
• Comprehensive documentation — Detailed guides at superfile.dev

Whether you're a seasoned CLI warrior or a developer looking to improve your terminal workflow, superfile offers something valuable. It proves that command-line tools don't have to be ugly or unintuitive — they can be both powerful and beautiful.

---

Frequently Asked Questions

What is superfile?

Superfile is an open-source terminal file manager written in Go that provides a modern, GUI-like interface for navigating and managing files directly from the command line. It features multiple panels, custom themes, Vim-inspired hotkeys, and cross-platform support for Linux, macOS, and Windows.

How do I install superfile?

On macOS and Linux, run: bash -c "$(curl -sLo- https://superfile.dev/install.sh)". On Windows, use PowerShell or package managers like winget and Scoop. Building from source requires Go installed on your system.

Does superfile support custom themes?

Yes! Superfile supports fully customizable themes using TOML configuration files. It includes built-in themes like Catppuccin Mocha, and you can create your own by editing theme files. Themes control colors for panels, sidebars, modals, cursors, and code syntax highlighting.

Can I use superfile on Windows?

Yes, superfile runs on Windows and can be installed via PowerShell, winget, or Scoop. Core file management features work, though some advanced functionality may have platform-specific limitations as Windows support is still evolving.

What are the key differences between superfile and other terminal file managers?

Superfile stands out with its modern TUI built using Bubble Tea, unlimited file panels, dedicated process tracking, clipboard management, built-in compression/decompression, a plugin system, and auto-update — features that most legacy file managers lack.

Is superfile free and open-source?

Yes, superfile is completely free and open-source. The source code is available on GitHub, and contributions from the community are actively welcomed and encouraged.

Does superfile work with my existing editor?

Absolutely. Set the EDITOR environment variable or configure the editor option in superfile's config file. It works seamlessly with Vim, Neovim, Nano, VS Code, and any other editor you prefer.