explaingit

yorukot/superfile

Analysis updated 2026-06-24

17,313GoAudience · developerComplexity · 2/5Setup · easy

TLDR

A keyboard-driven terminal file manager with a visual TUI, plugin and theme support, available for Linux, macOS, and partially Windows.

Mindmap

mindmap
  root((superfile))
    Inputs
      Keyboard shortcuts
      Plugin scripts
      Theme files
    Outputs
      File browser UI
      File operations
      Custom themed terminal
    Use Cases
      Replace ls and mv in daily work
      Manage files over SSH
      Customize a terminal workflow
    Tech Stack
      Go
      Bubbletea
      Linux
      macOS
      Windows
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Browse and move files in a terminal with a visual TUI instead of raw commands

USE CASE 2

Manage files on a remote server over SSH without a desktop environment

USE CASE 3

Customize file management with plugins and themes

USE CASE 4

Use spf as a daily-driver replacement for ranger or nnn

What is it built with?

GoBubbleteaTUI

How does it compare?

yorukot/superfileslackhq/nebulakeploy/keploy
Stars17,31317,32917,230
LanguageGoGoGo
Setup difficultyeasymoderatemoderate
Complexity2/54/53/5
Audiencedeveloperops devopsdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Single shell command on macOS or Linux, Windows support is partial.

In plain English

Superfile is a terminal-based file manager, a program that lets you browse, manage, and organize files and folders directly from the command line, with a visually appealing interface rather than raw text commands. Think of it as a prettier, more interactive alternative to typing individual commands like "ls" or "mv" in a terminal window. It runs in your terminal (the text-based interface on your computer) and provides a visual layout for navigating your file system, moving files, deleting items, and performing common operations using keyboard shortcuts. It also supports plugins (for adding extra functionality) and themes (for customizing the visual appearance). The app supports Linux, macOS, and Windows (with partial support on Windows). On macOS and Linux, you can install it with a single shell command. It can also be installed via Winget or Scoop on Windows, or via Homebrew on macOS. The command to launch it is simply "spf". It is built in Go using the Bubbletea library (a framework for building terminal user interfaces). You would use superfile if you prefer working in a terminal but find raw file management commands tedious, or if you want a fast, keyboard-driven file manager without needing a full desktop environment. It is aimed at developers and power users who spend time in the terminal and want a more ergonomic way to navigate their file system.

Copy-paste prompts

Prompt 1
Install yorukot/superfile on macOS with Homebrew and show me the default keybindings
Prompt 2
Walk me through writing a small superfile plugin that adds a git-status panel
Prompt 3
Show me a superfile theme config that matches my Catppuccin terminal
Prompt 4
Compare superfile with ranger and yazi for a developer who lives in tmux

Frequently asked questions

What is superfile?

A keyboard-driven terminal file manager with a visual TUI, plugin and theme support, available for Linux, macOS, and partially Windows.

What language is superfile written in?

Mainly Go. The stack also includes Go, Bubbletea, TUI.

How hard is superfile to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is superfile for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub yorukot on gitmyhub

Verify against the repo before relying on details.