Projects

Finished Projects

These projects are still in active development but may be considered "stable",

• check-symlinks
• connections
• connections-ssh
• docker-status
• go-bin
• homelab
• jmelahman.github.io
• manygo
• nature-sounds
• PKGBUILDs
• tag
• work

Unfinished Projects

• cycle-cli
• dashboard
• git-orchard
• runtainer

Subtrees

Most projects are tracked as git-subtrees. This allows them to be developed uniformly while leaving operational tasks, such as deployments, independent.

By design, each projects's directory (referred to as the subtree's <prefix>) matches the upstream repository name. For example, connections/ → github.com/jmelahman/connections. This is slightly more convenient to make shell functions since the git-subtree commands can be a bit cumbersome.

Update all upstreams with this command,

for d in */; do gsp "${d%/}"; done

And pulling from upstreams with,

for d in */; do gspull "${d%/}" -m "Update ${d%/}"; done

See my dotfiles for the gsp and gspull aliases.

Tooling

Upgrading

Github Actions

ratchet upgrade $(fd --hidden --type file --extension yml --full-path .github/workflows)

Golang

find . -name go.mod -execdir go get -u ./... \;

Linting

Generic

Check for broken symlinks,

uv run check-symlinks

Golang

find . -name go.mod -execdir golangci-lint run ./... \;

Github Actions

uv run zizmor $(fd --hidden --type file --extension yml --full-path .github/workflows)

Python

uv run ruff check

Shell

./tools/bin/shellcheck

Type-checking

Python

uv run ty check

Formatting

Python

uv run ruff format

Shell

./tools/bin/shfmt