tools

caa 10032026

these are the tools i currently use :3

notes

• __curPos.file will give the full evaluated path of the nix file it is called in. See this issue for more information.
• to get home-manager logs on darwin, use darwin-rebuild instead of nh
• on alpha, run rebuilds via nix develop -c just rb from the repo root. if rosetta-builder flakes out with platform mismatch / remote builder issues, run just rb a second time — it often succeeds on retry.
• kikir uses UID 502 for rafiq and shares ~/Agents through Syncthing at 100.109.192.110:22000.
• Development hosts sync only Pi's ~/.pi/agent/sessions state. Before moving a session to another machine, wait for the pi-sessions folder to finish syncing on both machines. Then start Pi in the equivalent local project before using /resume, and never continue the same session concurrently on multiple machines.

to kill Hyprland from an SSH session

pkill .Hyprland-wrapp

verify Hyprland lua config (without switching)

# verify the active config file
Hyprland --verify-config -c ~/.config/hypr/hyprland.lua

# check runtime-reported config errors
hyprctl configerrors

systemd-boot EFI persistent entry overrides

If bootctl status shows a stale Default Entry or Preferred Entry while /boot/loader/loader.conf has a newer default, an EFI variable is overriding loader.conf:

• LoaderEntryDefault is written by bootctl set-default or D in the boot menu.
• LoaderEntryPreferred is written by bootctl set-preferred or d in the boot menu.

Inspect current entry selection:

sudo bootctl status | rg "Current Entry|Preferred Entry|Default Entry"
sudo grep '^default ' /boot/loader/loader.conf

Set EFI default explicitly:

sudo bootctl set-default nixos-generation-<N>.conf

Unset EFI overrides (use loader.conf as source of truth):

just clear-systemd-boot-entry-overrides

Equivalent command:

sudo bash -lc 'for v in /sys/firmware/efi/efivars/LoaderEntryDefault-* /sys/firmware/efi/efivars/LoaderEntryPreferred-*; do [ -e "$v" ] || continue; chattr -i "$v" 2>/dev/null || true; rm -f "$v" || true; done'

Note: on this machine, unsetting from boot.loader.systemd-boot.extraInstallCommands did not persist (the variable reappeared by end of switch). The reliable approach here is to unset it after nh os switch completes (wired into Justfile rb).

acknowledgements

• ornicar, for being my inspiration to start using Nix, open source, and being a full fledged software engineer
• NixOS & Flakes Book for teaching me how to use NixOS, flakes, and home-manager: the best damn tutorial on the internet I've seen yet
• NotAShelf for introducing me to the idea of monorepos and custom logic (read: over-engineering) for Nix flakes
• drupol/infra for introducing the dendritic pattern to me, and mightyiam for pioneering it.
• Cross-compiling to ARM64 in GitHub Actions
• fishstiz for Cursors Extended, adapted here as a desktop cursor theme.
• Refri for Pixel Cursors, adapted here as a desktop cursor theme.
• kylon for Pixel Cursor ++, and Astropulse for the Familiar Pixel Cursors inspiration.
• NicSonic for Windows 98 Cursors, adapted here as a desktop cursor theme.