ONEFETCH(1)

📦
version 3.2.0 · 8 versions
, in arch rolling

💖 ONEFETCH(1) 💖

okay bestie so this is the user commands girlie of the manual pages, and honestly? she ate. it's onefetch — the command-line Git information tool — and she's about to tell you literally everything about your repo in the cutest way possible. no cap, you're gonna be obsessed. 🎀

✨ SYNOPSIS ✨

onefetch [OPTIONS] [INPUT]

🌸 DESCRIPTION 🌸

Command-line Git information tool. that's it, that's the whole vibe. it peeks at your repo and gives you the whole main character rundown. 💅

🦋 Arguments 🦋

  • [INPUT] — makes it run as if onefetch was started in <input> instead of the current working directory. so like, you can point at your repo from anywhere and she'll just go there. iconic.

👑 OPTIONS 👑

🧚 INFO 🧚

  • -h, --help — print help (see a summary with '-h'). yes girl, the short version exists, use it.
  • -V, --version — print version. identity check! ⭐
  • -d, --disabled-fields <FIELD>... — lets you disable FIELD(s) from appearing in the output. bye bestie, you're not in this scene anymore 💀
  • --no-title — hides the title. mysterious. no name, just vibes.
  • --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. ok so heads up: by default the actual value is non-deterministic because of time-based computation, and it gets shown in the field label as "Churn (NUM)". so don't come for her when the number looks different, she's just built like that 😭
  • --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. not invited to the party, fr fr.
  • --no-bots[=<REGEX>] — exclude [bot] commits. use <REGEX> to override the default pattern. robots out 🫶
  • --no-merges — ignores merge commits. no merge drama in this group chat.
  • -E, --email — show the email address of each author. doxxing your contributors (affectionate) 🙈
  • --http-url — display repository URL as HTTP.
  • --hide-token — hide token in repository URL. protect the token bestie!! 🔥
  • --include-hidden — count hidden files and directories. yes, even the ones in the shadows.
  • -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. organized queen behavior ⭐
  • --number-separator <SEPARATOR> — which thousands SEPARATOR to use. [default: plain] [possible values: plain, comma, space, underscore]
  • --no-bold — turns off bold formatting. no shouting allowed 💀

🌈 ASCII 🌈

  • --ascii-input <STRING> — takes a non-empty STRING as input to replace the ASCII logo. and you can literally 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. paint her cute! 🎀
  • -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. muted era.
  • --no-art — hides the ascii art or image if provided. minimalism, i guess 😭
  • --nerd-fonts — use Nerd Font icons. replaces language chips with Nerd Font icons. so fancy 🧚

💅 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. she speaks many tongues 💖
  • -p, --package-managers — prints out supported package managers.
ngl bestie, every single flag up there is real and does exactly what it says — don't go inventing new ones, she's got enough going on already 🫶

and that's the whole page, diva!! this gorgeous little guide is onefetch 3.2.0, dated October 2026 — go forth and make your terminal pretty. 💖✨🎀🦋🌸💅👑

📦 where this page comes from