~/blog

My open notebook

I have been writing here since 2015. These days it is mostly about AI agents, Linux and the tools I build myself, what worked and what broke along the way. At heart I write about my own studies and experiments for myself; if you are reading, that is a bonus :)

23 articles

RSS FEED

01 Nov 202611 min read424 specs across 26 repositories, one harness
My AI harness with RPI: from Superpowers and TLC to Forja 2.0
Harness is everything that runs around the model. Mine came out of almost a year of projects, tests, and study on top of Superpowers and tlc-spec-driven, and now it is becoming Forja 2.0.
#harness
#rpi
#agents
Quick preview
TL;DR // KEY POINTS
- Harness is everything that is not the model: rule, skill, spec, test, review. Mine took almost a year of projects and study.
- The plan that named my RPI told me to use Superpowers and, in task 3, deleted Superpowers itself.
- Forja 2.0 started over from scratch to take this harness into an app, with approvals in the user's hands.
Summarize with AI:
28 Oct 20265 min read571 test cases across 42 BATS files
Treating dotfiles as software
A dotfiles script runs from a shortcut, a timer and a hook, where nobody sees the error. How I test mine with shellcheck and BATS, swap dependencies for stubs and let AI write almost everything without losing trust.
#dotfiles
#shell
#quality
Quick preview
TL;DR // KEY POINTS
- A script that runs from a shortcut, timer or hook fails with nobody watching; that is why it has a test.
- Every external dependency is swappable via an environment variable, and the test points it at a stub.
- A fixed bug becomes a test named after the bug, and it goes red if someone reintroduces the error.
Summarize with AI:
28 Oct 202610 min readFrom a full day to a few hours per reinstall
Does your system have memory? A dotfiles from the first symlink to a reinstall
Formatting cost me a full day and a week remembering what I had missed. How to build a dotfiles that keeps the configs and the why of each one, and how it reinstalls the whole system on a blank machine, with what broke anyway.
#dotfiles
#linux
#shell
Quick preview
TL;DR // KEY POINTS
- The dotfiles starts with a symlink: the file lives in the repository, and every change goes through Git.
- Secrets stay out of the repository: the versioned file has the structure, and the value lives in a local file that Git ignores.
- Each reinstall makes the next one shorter, because what I had to remember becomes a line of code or of a playbook.
Summarize with AI:
26 Oct 20265 min read
My Gitflow scripts: from 31 lines of Bash to a Claude Code skill
Around 2019 I wrote a few scripts so I would not type the same git flow every time I opened a branch. They grew, got rewritten with AI and today live in a skill. The idea is still the same.
#git
#shell
#productivity
23 Oct 20268 min readPalette at about 3 KB gzip, downloaded on the first Ctrl+K
Ctrl+K on my site: a command palette that only downloads when someone hits the key
Site-wide search, G + letter shortcuts and single-key actions, in plain TypeScript with no library. Anyone who never opens the palette downloads nothing of it, and what cost the most bytes was the loader, not the palette.
#front-end
#javascript
#accessibility
Quick preview
TL;DR // KEY POINTS
- The palette is a separate file: anyone who never hits Ctrl+K downloads not a byte of it.
- For about a hundred items, stripping accents and requiring every term is enough; a fuzzy search lib would blow the budget.
- What weighed was import(): Vite's helper cost about 717 B gzip and the script budget rose to 2304 B.
Summarize with AI:
20 Oct 20269 min read15 colors fixed to pass WCAG AA
Terminal Noir: the theme of my site became the theme of my whole system
The colors of my site became the theme of my whole desktop: twelve apps, an open source repository, its own site and a beta release, in a single night.
#linux
#niri
#terminal
Quick preview
TL;DR // KEY POINTS
- One palette, named by role, and every app generated from it: changing a color is editing one file and running make build.
- The light variant failed contrast on 13 roles and nobody would have noticed without measuring. Today a test fails the build.
- The site's Shiki also got the theme: terminal-noir and terminal-noir-paper, generated from the same syntax.json and tested token by token.
Summarize with AI:
19 Oct 20266 min readMonths to quit Alt+Tab
Dynamic tiling or stacked windows: what I learned quitting Alt+Tab
Niri, Hyprland and Pop!_OS's new COSMIC arrange the windows for you, and all three let you float a window when you need to. After months to quit Alt+Tab, I am not going back, but that does not make tiling the right way for everyone.
#linux
#niri
#wayland
Quick preview
TL;DR // KEY POINTS
- In dynamic tiling the windows split the screen, and the compositor decides size and position every time a window opens or closes.
- Niri puts each window in a column of an endless horizontal row: nothing gets squeezed, the new window just joins the queue.
- All three let you float a window, and COSMIC turns tiling on per workspace, the easiest way to try both models.
Summarize with AI:
18 Oct 20266 min read6 reviewers, 2 models, 1 aggregator
Cross-model review: why a second agent finds what the first one misses
Different models fail in different places. How I put a second model to review the code the first one wrote, how I merge both sets of findings, what Codex caught on this site and why today the reviewer is agy.
#code review
#agents
#quality
Quick preview
TL;DR // KEY POINTS
- A single reviewer latches onto the first topic; six reviewers with one topic each go through the diff in parallel.
- A finding pointed out by two different models weighs more: coincidence becomes much harder to call chance.
- agy's sandbox does not block writes, so it reviews a disposable copy of the repository and never the real one.
Summarize with AI:

Drafts in progress

AEO vs SEO: is SEO dead?
The AI designer put the business rule in the copy: my prompt told it to
Blog comments without page weight: Giscus only loads when you reach the end
From Noctalia v4 to v5: I ported the plugins with both shells running
Screen recording to GIF with a shortcut, with a counter on the bar

Updates in the terminal

Subscribe to the technical article feed

Zero marketing. Just new articles when they go live.

By subscribing, you agree to the privacy policy.