Skip to content
Get packs

Guide · Open source

How to use onefetch: install, run and read the output

Updated · written with AI from the project's own documentation and checked against our catalogue data

Onefetch is a command-line tool that displays project information and code statistics for a local Git repository directly in your terminal. It works offline and is aimed at developers who want a quick overview of a project without opening a browser or IDE. After this guide you will be able to install it, run it on a repository, and adjust which information it shows.

Onefetcho2sh/onefetch · ★ 12.1k · MIT

Quick start

  1. 1Install onefetch. Use the package manager for your system, such as brew on macOS, pacman on Arch Linux, or winget on Windows.
  2. 2Open a terminal. Open a shell and change into the Git repository you want to inspect, or note its path.
  3. 3Run onefetch. Run onefetch in the repository folder, or run onefetch followed by the path to the repository.
  4. 4Adjust the output if needed. Use command-line options such as --type to change which language categories appear.
  5. 5Fix duplicate authors. If one person appears more than once, add a .mailmap file to the repository.

Install onefetch on Linux, macOS or Windows

Onefetch is available on Linux, macOS, and Windows. The project also publishes binaries on its release page. Pick the command that matches your system.

  • Ubuntu: download the .deb package and install it with dpkg (the README command also removes the downloaded file).
  • Arch Linux: use pacman.
  • openSUSE: use zypper.
  • macOS: use Homebrew.
  • Windows: use winget.
pacman -S onefetch

Run onefetch on a repository

You can pass the path to a repository, or change into the repository and run the command with no arguments. Both forms are shown in the project's usage section.

Onefetch reads a local Git repository, so the folder must be a Git project on your machine.

onefetch /path/of/your/repo

Customize the output with command-line options

Onefetch can be customized with command-line arguments. According to the README, you can adjust text styling, disable info lines, ignore files and directories, and output in multiple formats such as JSON and YAML. The full list of options is on the project's wiki, so check it there for exact flag names.

Language filtering is one common adjustment. By default only programming and markup languages are shown. To include prose and data languages, pass them with --type.

onefetch --type programming markup prose data

Fix missing languages and duplicate authors

If a language is missing from the output, it may be a prose or data language that is hidden by default. Adding --type with the categories you want fixes this.

Duplicate authors happen when one person committed under different names or emails, because onefetch reads authors from the Git history. The README suggests adding a .mailmap file to the repository to merge these entries.

  • Language missing: add the prose and data types with --type.
  • Duplicate authors: add a .mailmap file to the repository.

What people use it for

  • Getting a quick overview of an unfamiliar local repository before reading the code.
  • Seeing the language breakdown of a Git project from the terminal.
  • Capturing repository stats in a terminal screenshot or summary.
  • Exporting project information in JSON or YAML using the documented output options.

Frequently asked questions

How do I install onefetch?

Use the command for your platform: brew install onefetch on macOS, pacman -S onefetch on Arch Linux, zypper install onefetch on openSUSE, or winget install onefetch on Windows. On Ubuntu, the README gives a wget and dpkg command that downloads the .deb package from the releases page.

Why isn't my language showing up in onefetch?

By default onefetch only displays programming and markup languages. Languages classified as prose, such as Markdown or Org mode, and data, such as JSON, YAML, or TOML, are hidden unless you include them with --type.

Why does onefetch show the same author twice?

Onefetch reads authors from the Git history. If the same person committed with different names or emails, they can appear more than once. Adding a .mailmap file to the repository merges those entries.

Does onefetch need an internet connection?

The README says onefetch works completely offline. It reads a local Git repository, so it does not pull data from GitHub or GitLab.

Can onefetch show data from GitHub or GitLab?

No. The README says onefetch works on a local repository, so remote hosted repository data is not part of what it shows.

What tools are similar to onefetch?

The source lists git-quick-stats, gitstats, and tokei as comparable projects. Onefetch is a single-command overview for a local repo, so choose based on whether you want a quick summary or deeper statistics.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

Onefetch suits developers and terminal users who want a fast, offline overview of a local Git repository, including language breakdowns. It is not the right choice if you need a graphical interface, remote GitHub or GitLab data, or a language the project does not yet support.

Install options & downloads