FileTug – modern CLI file browser/picker with neat UI

• Developed using Go programming language
• Free to use & open source - GPLv3 License
  • You can support development of FileTug by sponsoring it on GitHub or by becoming a patron at Patreon.

We build with our own tooling:

• SpecScore — specify requirements as SpecScore.md artifacts
• SpecStudio — author & manage specs across their lifecycle
• inGitDB — store structured data in Git where applicable
• DALgo — data access layer for Go
• cover100.dev — drive toward 100% test coverage
• DataTug — query & explore data

We currently have 100% test coverage!

While this is a strong baseline, there is always room to improve test quality and depth. We are committed to maintaining and strengthening our test suite to ensure FileTug remains reliable and stable. Pull requests that improve tests are very welcome and will be very much appreciated.

Other file managers show what files exist. Users want to know what those files are.

It is fast! Non-blocking progressive UI (that pulls data in the background). Predictive pre-fetching (to be implemented) Caching of data for network resources (with in-background refresh - to be implemented) Smart summarizer that provides a concise overview of directory contents Smart previewers showing summary and key info for a file Quick selection of files and directories by mask with a collection of named patterns Quick navigation to favorite, frequently used, and recent directories Build-in git client that provides git status and allows to stage/commit/rollback/etc. Log viewer with milestones

brew tap filetug/filetug
brew install filetug
ft

To be implemented.

To be implemented.

go install github.com/filetug/filetug@main
ln -s "$(go env GOPATH)/bin/filetug" "$(go env GOPATH)/bin/ft"
ft

To start in the current directory:

ft

To start at the specific directory or file:

ft <PATH_TO_DIRECTORY_OR_FILE>

• tview - Modern, rich, and extensible Go UI library for terminal applications
• chroma - Go syntax highlighting library

Contributions are welcome!

Please read the CONTRIBUTING.md for details on how to contribute to this project.

All contributors and AI agents should follow our guidelines.