superfile
Pretty fancy and modern terminal file manager
Superfile: a terminal file manager that warns vim users
A modern terminal file manager written in Go whose README mostly covers hotkeys, an auto-update prompt, and a thank-you note to JetBrains.
What the README actually says
Superfile describes itself as a pretty fancy and modern terminal file manager. The README is short, four blocks of prose total, and it does not try to sell the project hard. The code is written in Go under the MIT license, with the homepage at superfile.dev, and the repository has gathered a large following since it began in 2024. What documentation exists focuses on three things: hotkeys, the auto-update check, and a credit line.
The vim warning
The loudest note in the README is a warning, and it is aimed at a specific crowd. If you are a vim or nvim user, change your default hotkeys config to the vim version. That single line tells you two things: the defaults are not vim-compatible, and a vim mapping exists for people who want one. For everyone else, the defaults presumably stand as they are.
Updates and credits
An auto-update feature fetches the latest released version from GitHub, but only when the last version check happened less than 24 hours ago, and it prints a prompt to the user when a newer version exists. If you would rather not be asked, you can switch it off by setting auto check update to false in the superfile config, and the README links to a config wiki for details. The final block is a thank-you to the JetBrains team for providing open source licenses that support the project's maintenance.
What a thin README leaves out
There is no installation guide, no feature tour, and no screenshot tour in this README. The project points elsewhere for that, and the notes here read more like housekeeping than marketing. For a file manager with this much adoption, the docs are strikingly minimal, and the review reflects only what the README actually contains.
Community notes