---
name: "onefetch"
section: "1"
platform: "linux"
package: "onefetch"
version: "3.2.0-1"
release: "Arch Linux 2026-11-07"
platforms: ["linux"]
url: "https://carta.tech/man/onefetch"
---

# onefetch(1)

Command-line Git information tool

## NAME

onefetch - Command-line Git information tool

## SYNOPSIS

**onefetch** \[*OPTIONS*\] \[*INPUT*\]

## DESCRIPTION

Command-line Git information tool

### Arguments:

-

  \[INPUT\]

-

  Run as if onefetch was started in \<input\> instead of the current working directory

## OPTIONS

- **-h**, **--help**

  Print help (see a summary with '-h')

- **-V**, **--version**

  Print version

### INFO:

- **-d**, **--disabled-fields** \<FIELD\>...

  Allows you to disable FIELD(s) from appearing in the output

- **--no-title**

  Hides the title

- **--number-of-authors** \<NUM\>

  Maximum NUM of authors to be shown

-

  \[default: 3\]

- **--number-of-languages** \<NUM\>

  Maximum NUM of languages to be shown

-

  \[default: 6\]

- **--number-of-file-churns** \<NUM\>

  Maximum NUM of file churns to be shown

-

  \[default: 3\]

- **--churn-pool-size** \<NUM\>

  Minimum NUM of commits from HEAD used to compute the churn summary

-

  By default, the actual value is non-deterministic due to time-based computation and will be shown in the field label as "Churn (NUM)"

- **--activity-months** \<NUM\>

  NUM of months shown in the activity field

-

  \[default: 12\] \[possible values: 3, 6, 12\]

- **-e**, **--exclude** \<EXCLUDE\>...

  Ignore all files & directories matching EXCLUDE

- **--no-bots\[=**\<REGEX\>\]

  Exclude \[bot\] commits. Use \<REGEX\> to override the default pattern

- **--no-merges**

  Ignores merge commits

- **-E**, **--email**

  Show the email address of each author

- **--http-url**

  Display repository URL as HTTP

- **--hide-token**

  Hide token in repository URL

- **--include-hidden**

  Count hidden files and directories

- **-T**, **--type** \<TYPE\>...

  Filters output by language type

-

  \[default: programming markup\] \[possible values: programming, markup, prose, data\]

### TEXT FORMATTING:

- **-t**, **--text-colors** \<X\>...

  Changes the text colors (X X X...)

-

  Goes in order of title, ~, underline, key, separator, and value

-

  For example:

-

  '--text-colors 9 10 11 12 13 14'

- **-z**, **--iso-time**

  Use ISO 8601 formatted timestamps

- **--number-separator** \<SEPARATOR\>

  Which thousands SEPARATOR to use

-

  \[default: plain\] \[possible values: plain, comma, space, underscore\]

- **--no-bold**

  Turns off bold formatting

### ASCII:

- **--ascii-input** \<STRING\>

  Takes a non-empty STRING as input to replace the ASCII logo

-

  It is possible to pass a generated STRING by command substitution

-

  For example:

-

  '--ascii-input "$(fortune \| cowsay **-W** 25)"'

- **-c**, **--ascii-colors** \<X\>...

  Colors (X X X...) to print the ascii art

- **-a**, **--ascii-language** \<LANGUAGE\>

  Which LANGUAGE's ascii art to print

- **--true-color** \<WHEN\>

  Specify when to use true color

-

  If set to auto: true color will be enabled if supported by the terminal

-

  \[default: auto\] \[possible values: auto, never, always\]

### IMAGE:

- **-i**, **--image** \<IMAGE\>

  Path to the IMAGE file

- **--image-protocol** \<PROTOCOL\>

  Which image PROTOCOL to use

-

  \[possible values: kitty, sixel, iterm\]

- **--color-resolution** \<VALUE\>

  VALUE of color resolution to use with SIXEL backend

-

  \[default: 64\] \[possible values: 16, 32, 64, 128, 256\]

### VISUALS:

- **--no-color-palette**

  Hides the color palette

- **--no-art**

  Hides the ascii art or image if provided

- **--nerd-fonts**

  Use Nerd Font icons

-

  Replaces language chips with Nerd Font icons

### DEVELOPER:

- **-o**, **--output** \<FORMAT\>

  Outputs Onefetch in a specific format

-

  \[possible values: json, yaml\]

- **--generate** \<SHELL\>

  If provided, outputs the completion file for given SHELL

-

  \[possible values: bash, elvish, fish, powershell, zsh\]

### OTHER:

- **-l**, **--languages**

  Prints out supported languages

- **-p**, **--package-managers**

  Prints out supported package managers