pldev — Personal machine helper, memory doctor, setup & fleet CLI (Go + Zig up)
  • Go 90.1%
  • Zig 9.9%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-04 07:29:52 +01:00
.github/workflows feat(up): add fleet & verify modules + Go/Zig CI workflow 2026-10-27 17:25:11 +09:00
docs feat: pldev release — one-command local build/sign/verify/publish (#16) 2026-06-16 00:31:21 +02:00
internal fix(setup): include Apt in TestBuildPlanClassifies backend map for Linux CI 2026-11-04 07:29:52 +01:00
up/src feat(up): add 16-bit AGC word <-> 1.585 bits/trit SPQT base-243 codec 2026-10-28 20:47:54 +09:00
.gitignore feat(up): pure-Zig 0.16 rebuild of pldev (ps, doctor mem, setup @8b, wupz SIMD xorFold/byteDiff/popcount) 2026-10-27 16:33:49 +09:00
go.mod feat(release): hybrid ed25519 + ML-DSA-65 dual-signing in CI + Taskfile 2026-06-15 22:01:59 +02:00
go.sum feat(verify): ML-DSA-65 post-quantum sign/verify (cloudflare/circl) 2026-06-15 21:47:49 +02:00
main.go feat: pldev release — one-command local build/sign/verify/publish (#16) 2026-06-16 00:31:21 +02:00
README.md feat(up): add fleet & verify modules + Go/Zig CI workflow 2026-10-27 17:25:11 +09:00
SKILL.md feat(fleet): probe-user — auto-detect each node's ssh user 2026-06-15 17:18:00 +02:00
Taskfile.yml feat(up): pure-Zig 0.16 rebuild of pldev (ps, doctor mem, setup @8b, wupz SIMD xorFold/byteDiff/popcount) 2026-10-27 16:33:49 +09:00

pldev & up (Pure-Zig 0.16 Rebuild)

Single-entrypoint personal machine helper (pldev in Go + up in pure Zig 0.16.0 paired with 8b-is/wupz SIMD kernels, mirrored at 8b-is/up and 8b-is/pldev). Modules: doctor mem, ps, setup, fleet, verify, fold.

Build & Install (up in Zig + pldev in Go)

# Pure-Zig `up` (zero-alloc Darwin sysctl + wupz @Vector SIMD kernels)
zig test -lc up/src/main.zig
zig build-exe -O ReleaseSafe -lc up/src/main.zig -femit-bin=~/.local/bin/up
up ps
up doctor mem
up setup @8b --dry-run
up fleet
up verify ~/.local/bin/up
up fold "8b-is sovereign core"

# Go `pldev`
task build      # -> ./pldev   (stamps version/commit/date)
task install    # -> ~/.local/bin/pldev
task version    # build + print embedded build info
task test
pldev --version # pldev <ver> (<sha>, <commit-date>, go1.x)

Use

pldev                 # interactive root menu
pldev doctor mem      # memory doctor (report + guided fixes)
pldev doctor mem --report   # non-interactive dump (ssh/scripts)
pldev ps              # neofetch-style system overview panel
pldev setup              # interactive tool installer
pldev setup @dev         # install the 'dev' profile
pldev setup jq+bun --dry-run

Flags: --report, --yes (safe fixes only), --no-color, --version.

Releasing

Build, dual-sign (ed25519 + ML-DSA-65), and verify locally on the M3:

pldev release v0.0.2            # dry-run: artifacts + sigs in dist/, prints notes
pldev release v0.0.2 --publish  # triple-ack gate, then GitHub upload

Publish requires a token (gh auth login or GH_TOKEN) and the signing keys (~/.ssh/id_pldev_ci, ~/.config/pldev/keys/brett-shaw_pldev_mldsa.key). Verify any artifact with pldev verify <file>.

Action log

Every command emits a one-action-per-line log to stderr (data output stays on stdout, pipe-clean). Lines are logfmt:

ts=2026-06-15T11:40:02Z lvl=info scope=pldev>setup action=install target=ripgrep status=ok dur=820ms

status ∈ ok/fail/skip/have/do/dry. Control via env:

  • PLDEV_LOG=plain|pretty|json — force render mode (default: pretty on a TTY, plain when piped).
  • NO_COLOR=1 — disable color (forces plain).
  • PLDEV_NESTED — set automatically for child pldev processes; forces plain + nested scope (parent>child). Don't set by hand.