
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
How to get it
- 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
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
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
| Project | Stars | Type | Level | Updated | Best for |
|---|---|---|---|---|---|
| superfile (this) | 24k | App | beginner | 7 days ago | People who spend a lot of time in the terminal and want a visual file browser there |
| yazi | 43.2k | App | intermediate | 4 days ago | People who already spend time in a terminal and want a faster way to browse folders |
| gh-dash | 12.7k | CLI | intermediate | 11 days ago | Developers who spend most of their day in the terminal |
| bubbletea | 45.6k | Library | intermediate | 5 days ago | Go developers who want to build interactive command-line tools with a visual interface |
| tview | 14.1k | Library | intermediate | 3 months ago | Go developers building interactive command-line tools with menus, forms, or tables |
| lipgloss | 12k | Library | intermediate | 4 days ago | Go 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.