freebsd/freebsd-ports
MBrassey's Description of Work
New port: misc/agtop, a top-like terminal UI for monitoring AI coding agents (CPU, memory, tokens, estimated spend, session activity), written in Rust.
Upstream: https://github.com/MBrassey/agtop (v2.5.0, MIT)
Notes on the port:
- CATEGORIES=misc, per prior review guidance for AI tooling
- CARGO_CRATES generated with make cargo-crates into a separate Makefile.crates; distinfo generated with make makesum, both run on FreeBSD
- Single binary; PLIST_FILES=bin/agtop, no pkg-plist
- No post-install target (stripping is automatic under USES=cargo)
Testing was done on an AWS EC2 instance running FreeBSD 15.1-RELEASE-p2, with poudriere jails for both supported releases and both ports branches.
poudriere testport -j 151amd64 -p local -o misc/agtop
building for: FreeBSD 151amd64-local 15.1-RELEASE-p2 FreeBSD 15.1-RELEASE-p2 amd64
build of misc/agtop | agtop-2.5.0 ended at Sat Aug 15 06:34:09 UTC 2026
build time: 00:01:22
poudriere testport -j 144amd64 -p local -o misc/agtop
building for: FreeBSD 144amd64-local 14.4-RELEASE-p8 FreeBSD 14.4-RELEASE-p8 amd64
build of misc/agtop | agtop-2.5.0 ended at Sat Aug 15 05:45:59 UTC 2026
build time: 00:01:23
poudriere testport -j 151amd64 -p quarterly -o misc/agtop (2026Q3)
building for: FreeBSD 151amd64-quarterly 15.1-RELEASE-p2 FreeBSD 15.1-RELEASE-p2 amd64
build of misc/agtop | agtop-2.5.0 ended at Sat Aug 15 07:18:54 UTC 2026
build time: 00:01:19
poudriere testport -j 144amd64 -p quarterly -o misc/agtop (2026Q3)
building for: FreeBSD 144amd64-quarterly 14.4-RELEASE-p8 FreeBSD 14.4-RELEASE-p8 amd64
build of misc/agtop | agtop-2.5.0 ended at Sat Aug 15 08:03:33 UTC 2026
build time: 00:01:19
portlint -A
looks fine.
portclippy Makefile and portfmt -D Makefile produced no findings.
make stage && make stage-qa && make check-plist && make package, followed by install, run, deinstall, pkg add of the built package, run again, and reinstall: all clean.
Upstream test suite built and run natively with the ports rust:
test result: ok. 93 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out
Runtime check of the packaged binary (TUI, --once, --json) on:
FreeBSD 15.1-RELEASE-p2 releng/15.1-n283596-aadd58dddcbc GENERIC amd64