git-point(1)

📦 version 0.2.2, in nixos 26.05, nixpkgs unstable

💖 git-point(1) — the manual, but make it make sense 💖

okay so real talk, bestie: this is git-point, and honestly? it's the glow-up git update-ref never got. we're setting arbitrary refs without shooting yourself in the foot, because it's a porcelain git update-ref and we're being responsible about it ✨

✨ SYNOPSIS ✨

git-point [-n|--new] [-W|--allow-worktree] [--color] [--mangen]
[-h|--help] [-V|--version] [FROM] [TO]

🌸 DESCRIPTION 🌸

Set arbitrary refs without shooting yourself in the foot, a porcelain git update-ref 🎀

like. that's the whole pitch. you get to point refs wherever you want, but with guardrails so you don't accidentally nuke your repo's whole vibe. it's giving "responsible main character energy" 💅

🦋 OPTIONS 🦋

  • -n, --new=KIND — create a brand new ref of KIND instead of updating one that already exists 🆕

here's the menu of possible values, no cap:

  • tag — new lightweight tag in refs/tags/<FROM>
  • branch — new branch at refs/heads/<FROM>
  • remote-branch — refs/remotes/<FROM> (e.g. refs/remotes/origin/main)
  • raw — no prefix, interpreted literally (like update-ref, be careful! 💀)
  • -W, --allow-worktree — allow mutating refs that are currently checked out. and listen, this will *not* change any of the actual files in the worktree, so don't @ me 🙈
  • --color=COLOR [default: auto] — when should we use terminal colors, bestie 🌈

[possible values: auto, always, never]

  • --mangen — generate the git-point.1 man page straight to stdout, then exit 📄✨
  • -h, --help — print help (see a summary with -h) 🫶
  • -V, --version — print version 👑
  • [FROM] — the ref to update, iykyk 🎯
  • [TO] — the revision to point <FROM> to 🔥

🎀 VERSION 🎀

v0.2.2 ⭐

👑 AUTHORS 👑

Qyriad <qyriad@qyriad.me> — absolute icon, we stan 💜

ngl the one thing to actually be careful about is --new=raw, because it's interpreted literally with no prefix. that's update-ref behavior and it can absolutely ruin your day if you typo. be careful fr fr 😭

okay bye bestie, go point some refs responsibly 🦋💖 — this page is from git-point 0.2.2 (which is also the source/version in the footer), and that's the whole manual, periodt ✨🌸

📦 where this page comes from