Tools & Utilities

A small collection of command-line tools and utilities.

git-uptodate

Prints branch, stash, and working tree status for one or more repositories.

git uptodate [<dir>...]

Example output:

──── tools ─────────────────────────────────────────────────
[!] 2 staged, 1 modified file(s)
• main                --> origin/main                            [0 ahead, 0 behind]
• c9fa1977f2b0         @ /tmp/tools-detached

Install via Homebrew

brew tap baraverkstad/tools https://github.com/baraverkstad/tools
brew install git-uptodate

Optionally create a git alias in ~/.gitconfig:

[alias]
    up = uptodate

Manual install

DIR=~/.local/bin
MAN=~/.local/share/man/man1
URL=https://github.com/ghraw/baraverkstad/tools/main
mkdir -p $DIR $MAN
curl -o $DIR/git-uptodate $URL/bin/git-uptodate
curl -o $MAN/git-uptodate.1 $URL/man/git-uptodate.1
chmod +x $DIR/git-uptodate

Update your PATH/MANPATH if needed in ~/.zshrc:

export PATH="$HOME/.local/bin:$PATH"
export MANPATH="$HOME/.local/share/man:$MANPATH"

frontmatter

Prints the YAML front-matter block from one or more files or directories.

frontmatter [options] <file|dir>...

Options

Flag	Description
-h	Show usage information
--summary	Compact table output
--titles	Infer title from first heading if missing

Example output

Single file:

$ frontmatter post.md
title: My Post
date: 2026-05-31

Directory with --titles:

$ frontmatter --titles src/
==> src/index.md <==
drafted: 2026-05-31
status: active
title: My Notes

Directory with --summary --titles:

$ frontmatter --summary --titles src/
file           drafted     status    title
index.md       2026-05-31  active    My Notes
outliner.md    2026-04-19  active    Outliner

Install via Homebrew

brew tap baraverkstad/tools https://github.com/baraverkstad/tools
brew install frontmatter

Manual install

DIR=~/.local/bin
MAN=~/.local/share/man/man1
URL=https://github.com/ghraw/baraverkstad/tools/main
mkdir -p $DIR $MAN
curl -o $DIR/frontmatter $URL/bin/frontmatter
curl -o $MAN/frontmatter.1 $URL/man/frontmatter.1
chmod +x $DIR/frontmatter

Update your PATH/MANPATH if needed in ~/.zshrc:

export PATH="$HOME/.local/bin:$PATH"
export MANPATH="$HOME/.local/share/man:$MANPATH"