PeronGH

sudo dnf install fex-emu fuse
mkdir -p ~/.fex-emu
echo '{"Config":{"RootFS":"/usr/share/fex-emu/RootFS/default.erofs"}}' > ~/.fex-emu/Config.json

PeronGH

OCI Custom Image Import on ARM Always Free — hard-won notes

Field notes from wiping a FreeBSD Always Free A1.Flex and standing up a fresh Fedora 43 aarch64 via BYOI. Captures the things that are either undocumented, contradicted between docs pages, or only discoverable by trying.

Environment: us-sanjose-1, VM.Standard.A1.Flex (4 OCPU / 24 GB), 200 GB BV / 10 VPUs, Fedora-Cloud-Base-Generic-43-1.6.aarch64.qcow2.

TL;DR — the working recipe

1. Upload the aarch64 qcow2 to an Object Storage bucket.
2. Create the custom image via raw API (CLI can't do it) with launchMode=CUSTOM and explicit launchOptions containing firmware=UEFI_64 plus PV everywhere.

PeronGH

#!/usr/bin/env -S deno run -A --env
/**
 * factory-api.ts — Factory.ai auth + local API proxy.
 *
 * Login (saves credentials to .env):
 *   deno run -A factory-api.ts login > .env
 *
 * Serve (auto-reads .env, proxies with injected credentials):
 *   deno run -A --env factory-api.ts serve [--port 8000] [--host 127.0.0.1]
 *

PeronGH

Prevent Sleep on Lid Close — Fedora (GNOME/GDM)

Tested on Fedora 43 with GNOME Shell 49.4. Two layers need to be configured: systemd-logind (the system) and GDM's gsd-power (the greeter), because GDM runs its own GNOME settings daemon that suspends independently.

1. Tell systemd-logind to ignore the lid switch

sudo mkdir -p /etc/systemd/logind.conf.d

sudo tee /etc/systemd/logind.conf.d/lid.conf << 'EOF'

PeronGH

Workflow

The existing code and its behavior are the source of truth. Every non-trivial change uses the Mikado method, adapted for agent workflows.

Mikado Plans (/docs/plans/)

Each plan is a numbered file (001-slug.md) tracking one top-level change. A fresh agent instance must be able to read the plan and know exactly where to start. Plans contain:

1. Goal: one-line summary of the top-level change.
2. Context: what the change is about and why it's needed — enough for a fresh instance to orient without reading the full codebase.

PeronGH

How to Set up ROCm in WSL on Strix Halo Systems

First, wsl --install Ubuntu-24.04

In Ubuntu 24.04:

Install deps:

sudo apt update
sudo apt install -y ca-certificates wget gpg

PeronGH

//usr/bin/env go run "$0" "$@"; exit

package main

import "fmt"

func main() {
	fmt.Println("Hello, world!")
}

PeronGH

#!/bin/bash

# safety tools
apt install apt-listbugs apt-listchanges

# modify apt source

# post upgrade
apt autoremove --purge
apt modernize-sources

PeronGH

! Remove YouTube preview in Gemini Web
gemini.google.com##.single-video-container

PeronGH

#!/bin/bash

# modern utils
brew install rg fd zoxide dust duf bat sd procs tlrc jq

# modern vcs
brew install jj