Job79andClaude Opus 5.5 db8fb0d5a4 feat: root adds the ssh keys, mkosi ssh for the test VM
The setup no longer asks for an ssh key. Root logs in on the console and
adds keys for claude and root to /var/lib/agent. Root may log in with
ssh, and its home is a tmpfs that is wiped at every boot. The test VM
uses mkosi ssh instead of a forwarded port, so the agent.ssh-key
credential is gone.

Also mount /var with noatime, move STYLE.md into AGENTS.md and rewrite
comments to start with the name of what they describe.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-19 19:10:54 +01:00
2026-11-16 19:40:51 +01:00

agent-mkosi

A VM that runs Claude Code in the background. It is a minimal Fedora image built with mkosi. You control Claude from claude.ai/code or the Claude app (Remote Control), or log in with ssh.

  • Resets at reboot: the homes of Claude and root, /tmp and all containers are wiped at every boot. Only the setup answers, the ssh keys and Claude's login survive (/var/lib/agent).
  • Read-only OS: the root filesystem is read-only, so Claude can't change the OS. All state lives on /var.
  • Tools in containers: Claude runs as the user claude, without root, and runs its toolchains in containers with podman. The host has only git, ssh and basic command-line tools.
  • Self-updating: the os rebuilds weekly and updates with systemd-sysupdate.

Install

Download the disk image, resize it to the disk size you want and boot it with UEFI. At first boot, the console asks for a root password and a hostname. Then log in as root, add an ssh key for the user claude and run Claude once to sign in. The VM then shows up in claude.ai/code and the Claude app under its hostname.

Development

mkosi genkey    # local test only, CI uses the SECUREBOOT_KEY secret
mkosi build

mkosi.output/ then holds the disk image (agent_<version>.raw) and the UKI and root partitions that make up an update.

To build and boot a test VM (needs qemu-kvm-core edk2-ovmf openssh-clients socat):

mkosi -f vm    # opens its console: log in as root, password root
mkosi ssh      # in another terminal: ssh in as root
S
Description
No description provided
Readme
226 KiB
0 Stars 1 Watchers 0 Forks
Languages
Shell 100%