agent-tools

Small, self-contained CLI tools built for AI agents to use during development work. Every tool is a single static Go binary with a text-first interface: input formats an agent can read and write directly, and output (names, errors, previews) explicit enough that the agent understands the result without opening an image viewer.

Tool	Binary	What it does
pixel-sprite-maker/	spritec	Turns .sprite text files (palette + character grid) into PNG/JPG/SVG pixel art, up to 256x256 px per sprite. Combines several sprites into sprite sheets / animation strips whose file names document the layout (walk_8x8_4x1.png = 8x8 px frames, 4 columns, 1 row).
mesh-tool/	mesht	Creates, inspects and edits 3D models (OBJ + STL). ASCII multi-view rendering + measurements (bbox, volume, watertightness) let an agent see a model, edit it (scale/rotate/mirror/merge/primitives) and verify the result.
bitmap-font-maker/	fontc	Turns .font text files (pixel glyph grids, proportional widths) into font atlases (PNG + JSON metrics) and renders text strings to PNG or the terminal.
sfx-maker/	sfxc	Synthesizes retro game sound effects (sfxr-style) from .sfx text presets to 16-bit WAV: waves, envelope, pitch slides, vibrato, arpeggio, filters. Deterministic, with built-in presets (jump, coin, laser…).
hitbox-tool/	hitbox	Scans sprite sheet PNGs and writes per-frame collision boxes as JSON from the alpha channel. Understands the spritec sheet naming convention including upscaled sheets.
notifyr/	notifyr	Sends and reads notifications on the homelab ntfy bus — alert a human, or check what the infra has been complaining about.
svg-maker/	svgc	Builds SVG graphics from .svgd text descriptions (shapes, text, groups, color vars) with terminal preview, measurements and out-of-canvas warnings. Display via agent-helm: helmd share out.svg.
waitfor/	waitfor	Blocks until a shell condition holds (exit 0 + optional regex match) — replaces hand-rolled poll loops. --then hook composes with notifyr.
cronr/	cronr	Recurring/one-shot jobs as systemd user timers that survive session exit and reboot. add/list/run/logs/rm, schedules validated by systemd-analyze.
giteactl/	giteactl	Gitea Actions runs, job logs (API/web/ssh+zstd fallback), wait (block until green) and wait-quiet (the "serialize heavy builds" rule), release assets.

Each tool has its own folder, its own README with the full format/CLI reference, its own tests and its own dev branch (dev/<tool>).

Agent-capability & homelab-admin tools

doc/tool-parity.md compares the Google agent's built-in tools with Claude Code's, and specs the CLI tools that close the gaps so any agent gets the same capabilities via its shell tool. Built so far: notifyr, waitfor, cronr, giteactl, svgc (2026-08-07). Still on the list: fleet, envaudit, reghelper, pagepub, nbcell, wtreectl, fanout. Build order and rationale live there and in doc/plan.md. Agy finds the tools through the agent-tools skill in ~/.gemini/config/skills/.

Building

# Arch/Garuda prerequisite:
sudo pacman -S go

cd <tool>/ && go build -o build/<binary> .    # per tool
go test ./...                                 # per tool

VS Code: Terminal → Run Build Task — build builds every tool into its own <tool>/build/ folder; per-tool build <tool> and test <tool> tasks also exist.

CI / releases

.gitea/workflows/release.yml runs on every push to master/main on the self-hosted runner: tools whose folders changed are tested, built for linux x64 + arm64 (the Pi5), and published to a rolling release per tool on the repo's release page:

• tag pixel-sprite-maker-latest → assets spritec-linux-x64, spritec-linux-arm64, checksums.txt
• tag mesh-tool-latest → assets mesht-linux-x64, mesht-linux-arm64, checksums.txt

A manual workflow_dispatch run builds all tools regardless of diffs.

Branch layout

• main — stable, releases are built from here
• dev/pixel-sprite-maker, dev/mesh-tool — per-tool development branches