NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules · #123 by repository stars
Last release 10 days ago
28 Sep 2026
Ships fairly regularly
a new release about every 3 weeks
Nearly every release is documented
notes for 18 of 18 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
100 releases · first in 2024
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per month.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
This release focuses on preview reliability, richer file metadata, configurable sidebar behavior, and a refreshed website and logo design, alongside n
This release focuses on preview reliability, richer file metadata, configurable sidebar behavior, and a refreshed website and logo design, alongside navigation improvements, better error messages, refactoring, dependency updates, and bug fixes.
Click me to know how to install
split_file_panel key function and navigation improvements for file panels. Thanks @robert-zaremba, @xelavopelk, and @padda78 for the implementation
--debug-info flag by @barsaskn in #1332split_file_panel key function by @robert-zaremba in #1344natural_sort as sort option by @majiayu000 in #1237--help for fch by @booth-w in #1391FormatFileSize to use configured units by @booth-w in #1419ioReqCnt thread-safe by @xelavopelk in #1420behviour -> behaviour typo in tmux.md by @pikammmmm in #1427Full Changelog: v1.5.0...v1.6.0
2026-06-08
Add configuration options for sidebar section visibility and ordering #1323
Add binary architecture detection for ELF, PE, and Mach-O #1328
Add —debug-info flag #1332
Focus on current directory on navigation to parent directory in a filepanel #1340
Add split_file_panel key function #1344
Refresh file metadata when focusing metadata panel #1372
Add Desktop directory to well-known directories #1386
Add support for Postscript files #1399
Bubbletea v2 migration #1406
Detailed information about delete operation errors for the user #1408
Add file type byte to permissions column #1410
New website & logo design #1423
Add Linux attributes to metadata #1432
More informative content of the error text for file text preview #1436
Resolve Nix build failure #1298
Prune Inaccessible Items from clipboard before pasting #1300
Correct jump back to parent directories cursor position #1316
Move toggleDot files to fileModel and force re render on toggle #1324
Update xz to v0.5.15 to enable cross-compile again #1327
Prevent crash due to invalid theme #1355
Prevent panic from zero-value Renderer usage #1358
Remove panic statements in production code #1359
Allow natural_sort as sort option #1237
Disable interactive commands in shell mode(darwin/linux) #1364
Multy-column header misalignment #1362
Remove showing two fractional digits of Byte for files with small size #1370
Resolve Nix build failure #1373
Disable broken Nix check phase #1374
Reword —help for fch #1391
Unable to select Natural sort #1413
Change FormatFileSize to use configured units #1419
Thread safe ioReqCnt #1420
Files processed in deterministic order #1421
Detailed information about paste operation errors for the user #1431
Refactor sort Modal to seperate package #1325
Refactor helpMenu Modal to seperate package #1335
Refactor utils package to pkg #1365
Add jetbrains logo #1292
Grammar corrections in readme and removed a redundant link in site #1302
Add special thanks page #1317
Add missing fields to vim like superfile hotkeys #1318
Add download badges to README #1404
Fix behviour -> behaviour typo in tmux.md #1427
Update core contributer #1429
Add notice page and fix tutorial page discuss issue #1433
Fix broken demo GIF path #1465 by @NouemanKHAL
Update astro monorepo #1313 , #1376
Update Astro and Starlight dependencies #1294 , #1308 , #1319 , #1338 , #1383 , #1394
Update expressive-code plugins #1309 , #1310 , #1366 , #1377
Update website dependencies #1395 , #1396
Update Go module dependencies #1296 , #1314 , #1329 , #1339 , #1389 , #1400 , #1401 , #1418 , #1426 , #1430 , #1447 , #1450
Update tracking code #1301
Add sidebar section layout test #1384
Fix incomplete test coverage in navigation_test.go #1387
Add new workflow for PR auto labeling #1398
Fix GitHub auto-labeling workflow #1405
Update GitHub Actions workflow triggers and permissions #1424
Some tests for modal error message #1435
Update workflow configuration #1451
SPF_INSTALL_VERSION=1.6.0-rc1 bash -c " $( curl -sLo- https://superfile.dev/install.sh ) "
SPF_INSTALL_VERSION=1.6.0-rc1 bash -c "$(curl -sLo- https://superfile.dev/install.sh)"Note: If you have spf installed via brew or another package manager, remove that installation first. Otherwise, running spf in the terminal might still point to the package manager version instead of the pre-release installed by the script.
$env:SPF_INSTALL_VERSION = "1.6.0-rc1"
Invoke-Expression ((New-Object System.Net.WebClient).DownloadString("https://superfile.dev/install.ps1"))Note: You can also build it from source. Refer to the README file in the repository for more information.
After installation, ensure that spf --version prints:
superfile version v1.6.0-rc1
behviour -> behaviour typo in tmux.md by @pikammmmm in #1427Full Changelog: v1.5.0...v1.6.0-rc1
Nothing published for this version
Nothing published for this version
Nothing published for this version
This release brings major new features, including video and PDF preview support, multi-column file panels, and configurable navigation, alongside sign
This release brings major new features, including video and PDF preview support, multi-column file panels, and configurable navigation, alongside significant code refactoring and comprehensive bug fixes.
Click me to know how to install
spf to open files with specific extensions with your choice of editor application. Thanks @litvinov-git for the implementation See this PR for more details: #1197spf /a/b/c.txt will launch in /a/b with c.txt as the selected file.
#1177 by @lazysegtree#1187 by @xelavopelk#1153 by @nicolaic#1171 by @xelavopelk#1197 by @litvinov-git#1178 by @Yassen-Higazi#1198 by @Yassen-Higazi#1215 by @lazysegtree#1220 by @lazysegtree#1236 by @lazysegtree#1250 by @majiayu000#1268 by @xelavopelk#1119 by @nikero41#1133 by @xelavopelk#1155 by @lazysegtree#1194 by @lazysegtree#1192 by @lazysegtree#1127 by @lazysegtree#1201 by @lazysegtree#1218 by @lazysegtree#1222 by @lazysegtree#1227 by @lazysegtree#1233 by @lazysegtree#1243 by @lazysegtree#1241 by @xelavopelk#1248 by @lazysegtree#1251 by @lazysegtree#1267 by @lazysegtree#1271 by @xelavopelk#1277 by @booth-w#1100 by @sarff#1195 by @lazysegtree#1223 by @lazysegtree#1224 by @lazysegtree#1228 by @lazysegtree#1245 by @lazysegtree#1249 by @lazysegtree#1142 by @wleoncio#1212 by @wcbing#1184 by @ninetailedtori#1010 by @renovate[bot]#1020 by @renovate[bot]#1138, #1157, #1158 by @dependabot[bot], @renovate[bot]#1134 by @dependabot[bot]#1038 by @renovate[bot]#1189, #1246 by @renovate[bot]#1256 by @renovate[bot]#1257 by @renovate[bot]#1136, #1190 by @renovate[bot]#1275, #1278, #1280 by @renovate[bot]#1276, #1191 by @renovate[bot]#1286 by @renovate[bot]#1120 by @nikero41#1114 by @fzahner#1140 by @yorukot#1145 by @nonepork#1141 by @yorukot#1143 by @yorukot#1135 by @lazysegtree#1185 by @lazysegtree#1180 by @lazysegtree#1186 by @lazysegtree#1203 by @lazysegtree#1264 by @lazysegtreeFull Changelog: v1.4.0...v1.5.0
2026-01-11
allow hover to file #1177
show count selected items in select mode #1187
Add icon alias for kts to kt #1153
link icon and metadata #1171
user configuration of editors by file extension #1197
add video preview support #1178
Add pdf preview support #1198
Add icons in pinned directories #1215
Enable fast configurable navigation #1220
add Trash bin to default directories for Linux #1236
add terminal stdout support for shell commands #1250
More columns in file panel (MVP) #1268
only calculate checksum on files #1119
Linter issue with PrintfAndExit #1133
Remove repeated os.ReadDir calls #1155
Disable COPYFILE in macOS #1194
add missing hotkeys to help menu #1192
Fetch latest version automatically #1127
Use async methods to prevent test race conditions #1201
update metadata and process bar sizes when toggling footer #1218
File panel dimension management #1222
Layout fixes with full end-to-end tests #1227
Fix flaky tests #1233
modal confirmation bug with arrow keys #1243
small file panel optimization #1241
use ExtractOperationMsg for extraction #1248
skip open_with from missing field validation #1251
border height validation fixes #1267
fix case with two active panes #1271
help model formatting #1277
simplify renameIfDuplicate logic #1100
separate FilePanel into dedicated package #1195
File model separation #1223
Dimension validations #1224
layout validation and sidebar dimension fixes #1228
user rendering package and removal of unused preview code #1245
user rendering package for file preview #1249
update Fish shell setup docs #1142
fix macOS typo #1212
stylistic and linguistic cleanup of config documentation #1184
update astro monorepo #1010
update starlight-giscus #1020
bump astro versions #1138 , #1157 , #1158
bump vite #1134
update setup-go action #1038
update expressive-code plugins #1189 , #1246
update sharp #1256
update fontsource monorepo #1257
update urfave/cli #1136 , #1190
update astro / starlight / ansi / toolchain deps #1275 , #1278 , #1280
update python and go versions #1276 , #1191
update golangci-lint action #1286
update CI input names #1120
Everforest Dark Hard theme #1114
migrate tutorial demo assets to local #1140
new logo asset #1145
mirror repository to codeberg #1141
sync package lock #1143
bump golangci-lint version #1135
add gosec linter #1185
enable MND linter and clean magic numbers #1180
skip permission tests when running as root #1186
release v1.4.1-rc #1203
1.5.0-rc1 housekeeping changes #1264
SPF_INSTALL_VERSION=1.5.0-rc1 bash -c "$(curl -sLo- https://superfile.netlify.app/install.sh)"
MacOS/Linux
SPF_INSTALL_VERSION=1.5.0-rc1 bash -c "$(curl -sLo- https://superfile.netlify.app/install.sh)"
Note - If you have spf installed via brew or other package manager, you would need to remove that installation; otherwise, running spf command in the terminal might still point to the one you installed via the package manager, not the one you installed via the script.
Windows
powershell -ExecutionPolicy Bypass -Command "$env:SPF_INSTALL_VERSION=1.5.0-rc1; Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://superfile.netlify.app/install.ps1'))"
Note - You can also build it from source. Refer to the README file in the repository for more information.
Ensure that spf --version prints superfile version v1.5.0-rc1
Major Changes
Full Changelog: v1.4.1-rc...v1.5.0-rc1
Nothing published for this version
Nothing published for this version
Nothing published for this version
SPF_INSTALL_VERSION=1.4.1-rc bash -c "$(curl -sLo- https://superfile.netlify.app/install.sh)"
MacOS/Linux
SPF_INSTALL_VERSION=1.4.1-rc bash -c "$(curl -sLo- https://superfile.netlify.app/install.sh)"
Note - If you have spf installed via brew or other package manager, you would need to remove that installation; otherwise, running spf command in the terminal might still point to the one you installed via the package manager, not the one you installed via the script.
Windows
powershell -ExecutionPolicy Bypass -Command "$env:SPF_INSTALL_VERSION=1.4.1-rc; Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://superfile.netlify.app/install.ps1'))"
Note - You can also build it from source. Refer to the README file in the repository for more information.
spf /path/to/1.txt will open the directory containing 1.txt with 1.txt sepectedFull Changelog: v1.4.0...v1.4.1-rc
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
SPF_INSTALL_VERSION=1.4.0-rc1 bash -c "$(curl -sLo- https://superfile.netlify.app/install.sh)"
MacOS/Linux
SPF_INSTALL_VERSION=1.4.0-rc1 bash -c "$(curl -sLo- https://superfile.netlify.app/install.sh)"
Note - If you have spf installed via brew or other package manager, you would need to remove that installation; otherwise, running spf command in the terminal might still point to the one you installed via the package manager, not the one you installed via the script.
Windows
powershell -ExecutionPolicy Bypass -Command "$env:SPF_INSTALL_VERSION=1.4.0-rc1; Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://superfile.netlify.app/install.ps1'))"
Full Changelog: v1.3.3...v1.4.0-rc1
Hey folks. Releasing v1.4.0 with many new features, improvements, and bug fixes.
We have an async file preview now, a zoxide panel, and various new features improving UX.
Click me to know how to install
We have the Zoxide Panel now. Ensure zoxide is installed on your system, set zoxide_support to true in the config, and press z to use zoxide.
File previewing is now async, meaning reduced lag while scrolling through images, or on slow systems.
Many bug fixes. See 'Detailed Change Summary'
tea.Cmd pattern.
Full Changelog: v1.3.3...v1.4.0
2025-10-10
feat: File operation via tea cmd by #963
feat: processbar improvements, package separation, better channel management by #970
feat: processbar improvements, package separation, better channel management by #973
feat: enable lll and recvcheck linter, fix tests, more refactors by #977
feat: Remove channel for notification models by #979
feat: enable cyclop, funlen, gocognit, gocyclo linters, and refactor large functions by #984
feat: Add a new hotkey to handle cd-on-quit whenever needed by #924
feat: added option to permanently delete files by #987
feat: Preview panel separation by #1021
feat: Add search functionality to help menu by #1011
feat: Use zoxide lib by #1036
feat: Add zoxide directory tracking on navigation by #1041
feat: Zoxide integration by #1039
feat: Select mode with better feedback by #1074
feat: owner/group in the metadata by #1093
feat: Async zoxide by #1104
fix: sorting in searchbar by #985
fix: Async rendering, Include clipboard check in paste items, and update linter configs by #997
fix: Move utility functions to utils package by #1012
fix: Refactoring and separation of preview panel and searchbar in help menu by #1013
fix(filePanel): allow focusType to be set correctly by #1033
fix(ci): Update gomod2nix.toml, allow pre release in version output, release 1.4.0-rc1, bug fixes, and improvements by #1054
fix(nix): resolve build failures in the nix flake by #1068
fix: Retry the file deletion to prevent flakies (#938) by #1076
fix(issue-1066): Fixed issue where enter was not searchable by #1078
fix(#1073): Tech debt fix by #1077
fix: fix deleted directory not able to remove from pins (#1067) by #1081
fix: fix child process spawning attached by #1084
fix: always clear images when showing a FullScreenStyle by #1094
fix: Allow j and k keys in zoxide by #1102
fix: Zoxide improvements and 1.4.0-rc2 by #1105
fix: rename cursor beginning on wrong character because of multiple dots in name (#813) by #1112
fix: check and fix file panel scroll position on height changes by #1095
docs: fix incorrect zoxide plugin config name by #1049
docs(hotkeys): Fix typo in vimHotkeys.toml comments by #1080
docs: add section for core maintainers in README.md by #1088
chore: add winget install instruction to readme and website by #943
chore(deps): update dependency go to v1.25.0, golangci-lint to v2, golangci-lint actions to v8 by #750
chore(deps): update amannn/action-semantic-pull-request action to v6 by #1006
chore(deps): update actions/first-interaction action to v3 by #1005
chore(deps): update actions/checkout action to v5 by #1004
chore(deps): bump astro from 5.10.1 to 5.12.8 by #982
fix(deps): update module golang.org/x/mod to v0.27.0 by #989
fix(deps): update dependency @expressive-code/plugin-collapsible-sections to v0.41.3 by #990
fix(deps): update dependency sharp to v0.34.3 by #992
fix(deps): update dependency @expressive-code/plugin-line-numbers to v0.41.3 by #991
chore(deps): update dependency go to v1.25.0 by #994
fix(deps): update astro monorepo by #995
fix(deps): update dependency @astrojs/starlight to ^0.35.0 by #1000
fix(deps): update module github.com/urfave/cli/v3 to v3.4.1 by #1001
fix(deps): update module golang.org/x/text to v0.28.0 by #1003
chore: migrate from superfile.netlify.app to superfile.dev by #1087
refactor(filepanel): replace filePanelFocusType with isFocused boolean by #1040
refactor(ansi): Migrate from github.com/charmbracelet/x/exp/term/ansi to github.com/charmbracelet/x/ansi by #1044
refactor: common operation on pinned directory file using PinnedManager by #1085
test: unit tests for pinned manager by #1090
SPF_INSTALL_VERSION=1.4.0-rc2 bash -c "$(curl -sLo- https://superfile.netlify.app/install.sh)"
MacOS/Linux
SPF_INSTALL_VERSION=1.4.0-rc2 bash -c "$(curl -sLo- https://superfile.netlify.app/install.sh)"
Note - If you have spf installed via brew or other package manager, you would need to remove that installation; otherwise, running spf command in the terminal might still point to the one you installed via the package manager, not the one you installed via the script.
Windows
powershell -ExecutionPolicy Bypass -Command "$env:SPF_INSTALL_VERSION=1.4.0-rc2; Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://superfile.netlify.app/install.ps1'))"
Note - You could also build it from source. Refer to the README file in the repository for more information.
Full Changelog: v1.4.0-rc1...v1.4.0-rc2
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Hey folks. Releasing v1.3.3 with bug fix related to config file, and improvements in metadata panel feature.
Hey folks. Releasing v1.3.3 with bug fix related to config file, and improvements in metadata panel feature.
Click me to know how to install
Full Changelog: v1.3.2...v1.3.3
2025-07-25
feat: Metadata loading via bubbletea’s tea.Cmd method, removed usage channels and custom goroutines by #947
feat: Metadata panel into separate package, UI bug fixes, Code improvements #950
fix: windows test ci by #941
fix: fixing config.toml by #952
chore: update pnpm-lcok.yaml by #937
feat: add support for Python virtual environment in testsuite setup #956
Nothing published for this version
Hey folks. Releasing v1.3.2 with multiple new features including implementation image preview using kitty protocol, and various bug fixes and internal
Hey folks. Releasing v1.3.2 with multiple new features including implementation image preview using kitty protocol, and various bug fixes and internal improvements.
Click me to know how to install
Full Changelog: v1.3.1...v1.3.2
2025-07-16
Normalize user-facing naming to superfile #880
Add kitty protocol for image preview #841
feat: add Zoxide support for path resolution in initial configuration #892
feat: update superfile’s help output #908
feat: Add Action to Publish to Winget #925
feat: update superfile build test for the windows and macOS #922
Compress all files selected #821
Theme: add 0x96f theme #860
fix: outdated and broken nix flake #846
fix: handle UTF-8 BOM in file reader #865
fix icon displayed on spf prompt when nerdfont disabled #878
fix: create item check for dot-entries #817
fix: prevent pasting a directory into itself, avoiding infinite loop #887
fix: clear search bar value on parent directory reset #906
fix: enhance terminal pixel detection and response handling #904
fix: Cannot Build superfile on Windows #921
fix: Improve command tokenization to handle quotes and escapes #931
fix: Dont read special files, and prevent freeze #932
Metadata and filepanel rendering refactor #867
refactor: simplify panel mode handling in file movement logic #907
refactor: standardize TODO comments and ReadMe to README #913
enhance: add detailed documentation for InitIcon function and update … #879
docs: add documentation for image preview #882
docs: update contributing guide and PR template #885
docs: update README and plugin documentation for clarity and structure #902
feat(docs): Update arch install package docs #929
ci: add PR title linting with semantic-pull-request action #884
ci: improve PR workflows with contributor greeting and title linter fix #886
build(deps): bump prismjs from 1.29.0 to 1.30.0 in /website #786
fix(deps): update dependency astro to v5.8.0 #787
chore(deps): bump vite from 6.3.3 to 6.3.5 in /website #822
fix(deps): update dependency sharp to v0.34.2 #909
fix(deps): update astro monorepo #894
fix(deps): update fontsource monorepo to v5.2.6 #910
chore(license): update copyright year #895
feat: add ignore missing field flag #881
feat: add sitemap integration and update giscus input position #912
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Replace custom giscus implementation with official starlight-giscus plugin #843
2025-05-27
Replace custom giscus implementation with official starlight-giscus plugin #843
Add ‘Type’ option for sorting by file extension with fallback #829
Correct icons for clipboard files #845
Replace mattn/rundwidth with ansi package for more robust StringWidth #848
Purego package update #837
Added a Command-Prompt for SuperFile specific actions #752
2025-05-22
Added a Command-Prompt for SuperFile specific actions #752
Allow specifying multiple panels at startup #759
Initial draft of rendering package #775
Render unit tests for prompt model #809
Chooser file option, —lastdir-file option, and improvements in quit, and bug fixes #812
Prompt feature leftover items #804
SPF Prompt tutorial and fixes #814
Write prompt tutorial, rename prompt mode to spf mode, add develop branch in GitHub workflow, show_panel_footer_info flag #815
Theme: Add gruvbox-dark-hard #828
Sidebar separation #767
Sidebar code separation #770
Rendering package and rendering bug fixes #781
Refactor CheckForUpdates #797
Rename metadata strings #731
Fix crash with opening file with editor on an empty panel #730
Fix: Add some of the remaining linter and fix errors #756
Golangci lint fixes #757
Fix: Remove redundant function containsKey #765
Fix: Correctly resolve path in open and cd prompt actions #802
Prompt dynamic dimensions and unit tests fix #805
Fix: Convert unicode space to normal space, use rendered in file preview to fix layout bugs, Release 1.3.0 #825
Adding linter to CI/CD and fix some lint issues #739
Linter fixes, new feature of allowing multiple directories at startup, other code improvements #764
Model unit tests #803
Nothing published for this version
Add show_image_preview flag #728
2025-03-26
Add show_image_preview flag #728
Allow specifying directory icon color in theme files #709
—hotkey-file flag and fix in configFileFlag #700
File preview: Add bat as plugin #686
Monokai Theme #673
Fix broken link in website causing 404 #714
Fix sidebar disk listing #708
Switch to semver for newer 1.2.1 release #687
Fix: icon consts #719
Refactor and unit tests for scrolling #710
Refactor of wheel functions #695
Add info about auto update #721
add cd_on_quit for fish shell #696
Add Pixi installation instructions #690
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Add keys PageUp and PageDown for better navigation #498
2024-01-05
OneDark Theme added #477
Add keys PageUp and PageDown for better navigation #498
Add hotkey for copying PWD to clipboard #510
Add desktop entry #501
Enable cd_on_quit when current directory is home directory #518
Edit superfile config #509
Fix rendering directory symlinks as directories, not files #481
Fix opening files on Windows #496
Fix lag in dotfile toggle with multiple panels #499
Fix parent directory navigation on Windows #502
Fix panic when deleting last file in directory #529
Fix panic when scrolling through an empty metadata list #531
Fix panic when trying to get folder size without needed permissions #532
Fix lag when navigating directories with large image files #525
Fix typo in welcome message #494
Optimize file move operation #522
Optimize file extraction #524
Warn overwrite when renaming files #526
Work without trash #527
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →