OneFetch: Your Project's Snapshot, Right in the Terminal
Ever jump into a new codebase and immediately want to know the lay of the land? What language is it? How long has it been around? Who's the primary contributor? You could click through a dozen GitHub pages, or you could get that information, elegantly displayed, in a single command. That’s the entire premise of OneFetch.
It’s a command-line tool written in Rust that gives you a quick, at-a-glance summary of a local Git repository. Think of it as a neofetch for your code projects—it surfaces the key details you care about in a clean, colorful, and instantly readable format.
What It Does
OneFetch is a Git information tool. Run onefetch inside any Git repository, and it will instantly generate a summary that includes:
- The primary programming language and its percentage in the project.
- The project's commit history, including the total number of commits and the most recent one.
- The total lines of code.
- The repository's age (first commit) and its most recent activity.
- The number of authors and the top contributor.
- The project's license, if it can be detected.
- A clean ASCII art logo of the detected primary language.
All of this is formatted into a beautiful, color-coded layout that makes it incredibly easy to parse.
Why It’s Cool
The magic of OneFetch isn't just that it shows data; it's how it shows it. The implementation is clever—it’s fast because it’s built in Rust, and it’s smart about detecting languages and licenses without needing a network connection. It’s a purely offline tool for your local repos.
For developers, the use cases are everywhere. Use it to quickly contextualize a project you’re about to work on, to show off your own work in a terminal screenshot, or even as a quick check to ensure a project aligns with your tech stack before diving in. It turns a series of manual git commands and guesses into one instantaneous, informative snapshot.
How to Try It
Getting started with OneFetch is straightforward. If you’re on a macOS system with Homebrew, it’s a simple:
brew install onefetch
For other platforms, you can grab a pre-built binary from the latest GitHub release or install it via Cargo if you have the Rust toolchain installed:
cargo install onefetch
Once installed, just cd into any Git repository and type onefetch. That’s it. The information will populate your terminal instantly.
Final Thoughts
OneFetch is one of those simple utilities that feels like it should have always existed. It’s a perfect example of a tool that does one thing and does it exceptionally well. It’s not trying to be a full-blown Git GUI; it’s a focused, fast, and visually pleasing dashboard for your project’s vitals. For any developer who lives in the terminal, it’s an easy recommendation to add to your toolkit.
Check out the project on GitHub to contribute, report issues, or just show some love: github.com/o2sh/onefetch
— Follow us on Twitter for more cool projects: @githubprojects