Repolode
Submit
yorukot

yorukot/superfile

A modern terminal file manager written in Go, built with Bubble Tea, for browsing and managing files from the command line.

View on GitHubWebsite
Stars
23,885
Forks
832
Open issues
289
Last commit
20 hours ago

What is it?

superfile is a terminal user interface (TUI) file manager written in Go and built on the Bubble Tea framework. It runs in the terminal and lets you navigate directories, open and manage files without leaving the command line. The project is installed as a single binary named spf.

The tool is aimed at developers and terminal users who want a visual, keyboard-driven file browser rather than a plain ls or cd workflow. Installation is available through a shell script on macOS and Linux, a PowerShell script, Winget and Scoop on Windows, and it can also be built from source with Go. Linux and macOS are listed as supported systems, while Windows support is described as not yet complete.

Behavior is customizable through configuration files covering themes, hotkeys, and plugins. The project also offers an optional update check that can be turned off in the superfile config.

Key features

  • 01Terminal-based file browsing with a keyboard-driven interface.
  • 02Installable on macOS, Linux and Windows via scripts, Winget, Scoop, or source build.
  • 03Customizable themes and hotkeys through configuration.
  • 04Plugin support for extending functionality.
  • 05Optional update check that can be disabled in config.

Use cases

  • Navigating and managing files over SSH or on a headless server without a GUI.
  • Replacing repeated ls and cd commands with a visual file browser in the terminal.
  • Customizing a keyboard-centric file manager that fits a vim-style workflow.

Quick start

  1. 1

    Run the official install script for macOS and Linux from the README

  2. 2

    Or install on Windows with Winget

    winget install --id yorukot.superfile
  3. 3

    Start superfile

    spf

Things to know

  • Windows support is not fully supported yet, according to the README.

Topics

#terminal#tui#file-manager#golang#bubbletea#cli#filemanager#filesystem#hacktoberfest#linux-app

FAQ

What is superfile?
A modern terminal file manager written in Go, built with Bubble Tea, for browsing and managing files from the command line. superfile is a terminal user interface (TUI) file manager written in Go and built on the Bubble Tea framework. It runs in the terminal and lets you navigate directories, open and manage files without leaving the command line. The project is installed as a single binary named spf.
Is superfile free to use? What license does it have?
superfile is open source under the MIT license. Check the license terms before using it in commercial products.
Is superfile still maintained?
Actively maintained. The last commit to superfile was on Oct 21, 2026.
What can I use superfile for?
Navigating and managing files over SSH or on a headless server without a GUI. Replacing repeated ls and cd commands with a visual file browser in the terminal. Customizing a keyboard-centric file manager that fits a vim-style workflow.
How do I install superfile?
Run the official install script for macOS and Linux from the README Or install on Windows with Winget: winget install --id yorukot.superfile Start superfile: spf
Where can I get superfile?
The source code and installation instructions are on GitHub: https://github.com/yorukot/superfile

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects