Job79andClaude Opus 5.5 3a4a9f715a
os / os (push) Waiting to run
fix: run Remote Control in ~/work, which Claude can trust
Claude never saves trust for a home directory, so claude-remote.service
now runs in ~/work, which tmpfiles makes and pre-trusts in .claude.json.
Its status screen on stdout no longer floods the journal.

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

agentos

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.

  • Read-only OS: /usr is read-only, so Claude can't change the OS. Secure Boot verifies the UKI (kernel, initrd and command line), which holds the dm-verity hash that verifies /usr.
  • Encrypted with a TPM: everything that isn't read-only, such as /etc, /var and /home, is encrypted. The TPM unlocks it only for correctly signed UKIs.
  • Easy to reset: a factory reset wipes everything that isn't read-only, and the VM sets itself up again as at first boot.
  • Tools in containers: Claude runs as the user agent, without root, and runs its toolchains in containers with podman.
  • Self-updating: the image rebuilds weekly. A bad update rolls back by itself.

Install

Download the disk image, resize it to the disk size you want and boot it with UEFI and a TPM. At first boot, the screen offers a recovery key for the encrypted disk and asks for a root password. Then log in as root and put your ssh key in /home/agent/.ssh/authorized_keys (for root: ~/.ssh/authorized_keys), which starts sshd. As agent, run claude once in ~/work to sign in and trust that folder, where Remote Control runs. The VM then shows up in claude.ai/code and the Claude app under its hostname: agentos- and four hex digits.

To start over, run systemctl start factory-reset.target as root. It reboots and wipes the root partition (/etc, /var and /home), and the VM sets itself up as at first boot.

Development

mkosi genkey    # This is for local tests. CI uses the SECUREBOOT_KEY secret.
mkosi build

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

To build and boot a test VM:

mkosi -f vm    # This opens the console. Log in as root, password root.
mkosi ssh      # This logs in as root with ssh, in another terminal.
S
Description
No description provided
Readme
226 KiB
0 Stars 1 Watchers 0 Forks
Languages
Shell 100%