Skip to content

superfile

A terminal file manager written in Go, with a modern look and a TUI interface.

Stars
24k
Forks
836
Licence
MIT
Language
Go
Last update
7 days ago
Type
App

What it is

superfile is a file manager that runs inside a terminal window, letting you browse, open and manage folders and files with the keyboard. It is built in Go using the Bubble Tea terminal UI framework, and the README describes it as a pretty, modern terminal file manager. It is launched with the command spf.

  • Browse and move through folders on a remote machine over a terminal session
  • Perform common file operations such as copy, move and delete from one interface, as shown in the README demo
  • Customize the look with themes and extend it with plugins listed on the project wiki

Great for

  • People who spend a lot of time in the terminal and want a visual file browser there
  • Linux and macOS users, which the README lists as supported systems
  • Users who want to customize themes, hotkeys and plugins
  • Vim or Neovim users, who can switch to vim-style hotkeys

Not ideal for

  • Users who want a graphical file manager with windows and mouse-first menus, since this runs in the terminal
  • Windows users who need full stability, since the README says Windows support is not fully supported yet
Step-by-step guide: how to use superfileInstall, first run, examples, tips and FAQs

How to get it

  1. 1

    See the README

    Install on macOS and Linux (review the script first, as the README suggests)

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

    Install on Windows with Winget

    winget install --id yorukot.superfile
  2. 2

    Run it

    • Run the install command for your operating system from the README
    • Open a terminal and type spf to start superfile
    • Use the tutorial on superfile.dev to learn the basic controls
    • Optionally change hotkeys to the vim version if you use vim or neovim
  3. 3

    Get the most out of it

    • Set auto_check_update to false in the config if you do not want update prompts
    • Customize colors using the theme guide on the project website
    • Add plugins from the plugin list on the project website
    • Review the hotkey wiki to tailor keyboard shortcuts

Downloads

Strengths

  • Installable with a one-line script, Winget, or Scoop according to the README
  • Open source under the MIT license with an active project and a large star count
  • Configurable through themes, hotkeys and a config file

Trade-offs

  • The README says Windows support is not fully supported yet
  • Hotkeys default to a non-vim layout, so vim users must change the config
  • Some setup details and features are only documented on the external website, not in the README

How it compares

ProjectStarsTypeLevelUpdatedBest for
superfile (this)24kAppbeginner7 days agoPeople who spend a lot of time in the terminal and want a visual file browser there
yazi43.2kAppintermediate4 days agoPeople who already spend time in a terminal and want a faster way to browse folders
gh-dash12.7kCLIintermediate10 days agoDevelopers who spend most of their day in the terminal
bubbletea45.6kLibraryintermediate4 days agoGo developers who want to build interactive command-line tools with a visual interface
tview14.1kLibraryintermediate3 months agoGo developers building interactive command-line tools with menus, forms, or tables
lipgloss12kLibraryintermediate4 days agoGo developers building terminal user interfaces

Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.