back to projects

mugshot.nvim

a git blame card for the line under the cursor, with the commit author's avatar drawn inline via the kitty graphics protocol.

view source
mugshot.nvim

stack

NeovimNeovimLuaLua

about

mugshot opens a small float for the line under the cursor, showing the author, the relative and absolute time, the short sha, and the commit summary, with the author’s avatar drawn in the corner when the terminal can render images. the avatar resolves from the commit’s GitHub author, falling back to Gravatar and then a generated silhouette, and everything off the blame (the GitHub lookup, the download, the resize) runs async so the card opens immediately. without image support the same card renders as plain text. made it for fun more than anything else, inspired by GitLens in VS Code.

features

  • blame card for the line under the cursor: author, relative + absolute time, short sha, and summary
  • inline author avatars drawn via the kitty graphics protocol, through image.nvim
  • avatar resolution chain: the commit's GitHub author, then Gravatar, then a generated placeholder silhouette
  • card actions to open the commit page, copy the full sha, or jump to the PR that introduced the line
  • disk-cached avatars keyed by GitHub login, reused across a contributor's later commits
  • capability gating across image.nvim, the terminal protocol, and tmux passthrough, degrading to a text-only card when any piece is missing
  • zero-config :Mugshot command works on load; setup() is only needed to bind the trigger keymap