Files
Job79andClaude Opus 5.5 1707500c05
os / os (push) Waiting to run
refactor: rename to agentos, hand-picked /etc, user presets at first boot
- Rename the image from agent to agentos (ImageId, hostname, CI, docs).
- mkosi.finalize only copies /etc to /usr/share/factory/etc. The hand-written
  tmpfiles.d/factory-etc.conf links the 24 entries the image needs.
- /etc/systemd is writable: PID 1 applies the system presets at first boot
  and preset-global.service the user presets, as in ParticleOS.
- claude-remote runs in the user manager of agent, enabled by a user preset.
- Root has no /var subvolume, and the verity partitions shrink to 16M.
- Style pass over comments, CLAUDE.md and AGENTS.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-22 15:48:42 +01:00

773 B

This machine

A small Fedora VM, made for running Claude Code.

  • Claude runs as the user agent, without root or sudo.
  • The OS is read-only. Packages can't be installed on it.
  • Run toolchains, languages and services in containers with rootless podman.
  • For longer work, keep one container per worktree, named after its directory:
    • Start: podman run -d --name "${PWD##*/}" -v "$PWD:$PWD" -w "$PWD" quay.io/fedora/fedora:latest sleep infinity
    • Install: podman exec "${PWD##*/}" dnf install -y gcc
    • Run: podman exec "${PWD##*/}" make
    • Remove: podman rm -f "${PWD##*/}"
  • On the host: git, ssh, curl, tar, gzip, xz, zstd, find, diff, ps, ip.
  • The home directory (/home/agent), containers and images survive reboots.
  • /tmp is wiped at every boot.