refactor: rename to agentos, hand-picked /etc, user presets at first boot
os / os (push) Waiting to run

- 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>
This commit is contained in:
Job79andClaude Opus 5.5 committed 2026-11-22 15:48:42 +01:00
1 parent 186d133cbc
commit 1707500c05
25 files changed
+253 -249

No files matched your search

@@ -1,24 +1,26 @@
# 50-agent.preset enables the services of the image. mkosi runs systemctl
# preset-all, which applies it. It sorts before Fedora's presets, so it wins
# where they disagree.
# 50-agent.preset enables the services of the image. PID 1 applies it at first
# boot, so a change reaches existing machines only after a factory reset. It
# sorts before Fedora's presets, so it wins where they disagree.
# systemd-networkd is disabled by Fedora, which uses NetworkManager.
enable systemd-networkd.service
enable systemd-resolved.service
# sshd.path starts sshd once there is an ssh key, so Fedora's preset of
# sshd.service is overruled.
# preset-global.service applies the user presets.
enable preset-global.service
# sshd.path starts sshd once there is an ssh key.
enable sshd.path
disable sshd.service
# getty@.service is the login on the screen, which Fedora disables (tty1, and
# tty2-6 through its autovt@ alias).
# getty@.service is the login on the screen, which Fedora disables.
enable getty@.service
enable claude-remote.path
enable systemd-sysupdate-update.timer
enable systemd-sysupdate-reboot.timer
# authselect-apply-changes would rewrite /etc/authselect, which links into the
# read-only /usr (mkosi.finalize), and fails.
# authselect-apply-changes fails, because /etc/authselect is on read-only /usr.
disable authselect-apply-changes.service
# systemd-homed, systemd-userdbd and systemd-nsresourced are unused here.
# Fedora enables them.
disable systemd-homed.service
disable systemd-homed-activate.service
disable systemd-userdbd.socket
@@ -1,10 +0,0 @@
# claude-remote.path starts claude-remote.service once Claude has a login: at
# boot, or as soon as the user first logs in.
[Unit]
Description=Start Claude Remote Control once logged in
[Path]
PathExists=/home/agent/.claude/.credentials.json
[Install]
WantedBy=multi-user.target
@@ -1,15 +0,0 @@
# claude-remote.service runs Claude Code in the background, as the user agent
# in its home, so it can be used from claude.ai/code or the Claude app.
# claude-remote.path starts it once Claude is logged in.
[Unit]
Description=Claude Code Remote Control
Wants=network-online.target user@1000.service
After=network-online.target user@1000.service
[Service]
User=agent
WorkingDirectory=~
Environment=XDG_RUNTIME_DIR=/run/user/1000
ExecStart=/usr/bin/claude remote-control --name %H
Restart=always
RestartSec=10s
@@ -0,0 +1,20 @@
# preset-global.service applies the user presets at first boot, as PID 1 does
# for the system presets. It runs before basic.target, so before any user
# manager starts, which needs DefaultDependencies=no. It is the same as
# ParticleOS's. systemd 263 can apply presets at build time instead, with
# systemctl preset-all --vendor.
[Unit]
Description=Apply the user presets
ConditionFirstBoot=yes
DefaultDependencies=no
Before=basic.target
Conflicts=shutdown.target
Before=shutdown.target
[Service]
Type=oneshot
RemainAfterExit=yes
ExecStart=systemctl preset-all --global
[Install]
WantedBy=basic.target
+1 -3
View File
@@ -1,7 +1,5 @@
# sshd.path starts sshd only once root or the user agent has an ssh key, so a
# new VM has no open port. Root adds the keys after the first boot
# (README.md). The ssh.authorized_keys.root credential also fills root's, such
# as for mkosi ssh.
# new VM has no open port.
[Unit]
Description=Start sshd once an ssh key is set
@@ -0,0 +1,3 @@
# 50-agent.preset enables the user services of the image.
# preset-global.service applies it at first boot.
enable claude-remote.path
@@ -0,0 +1,13 @@
# claude-remote.path starts claude-remote.service once Claude is logged in.
# It runs in the user manager of agent, which linger starts at boot
# (mkosi.extra/usr/lib/tmpfiles.d/agent.conf). ConditionUser keeps it out of
# the user manager of root.
[Unit]
Description=Start Claude Remote Control once logged in
ConditionUser=agent
[Path]
PathExists=%h/.claude/.credentials.json
[Install]
WantedBy=default.target
@@ -0,0 +1,12 @@
# claude-remote.service runs Claude Code in the background, in the home of the
# user agent, so it can be used from claude.ai/code or the Claude app.
# claude-remote.path starts it once Claude is logged in. The user manager can't
# wait for the network, so Restart= retries until it is up.
[Unit]
Description=Claude Code Remote Control
[Service]
WorkingDirectory=~
ExecStart=/usr/bin/claude remote-control --name %H
Restart=always
RestartSec=10s