refactor: rename to agentos, hand-picked /etc, user presets at first boot
os / os (push) Waiting to run
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:
25 files changed
+253
-249
No files matched your search
@@ -1,18 +1,15 @@
|
||||
# This machine
|
||||
|
||||
You run on a small Fedora VM made for you, as the user `claude`, without root.
|
||||
A small Fedora VM, made for running Claude Code.
|
||||
|
||||
- **The OS is read-only**: you can't install anything on it. Run toolchains, languages and
|
||||
services in containers, with rootless `podman`. For quick commands:
|
||||
`podman run --rm -v "$PWD:/w" -w /w docker.io/library/python:3 python script.py`.
|
||||
For longer work, keep one dev container per worktree or session, named after its directory,
|
||||
that you install into:
|
||||
`podman run -d --name "${PWD##*/}" -v "$PWD:$PWD" -w "$PWD" quay.io/fedora/fedora:latest sleep infinity`,
|
||||
then `podman exec "${PWD##*/}" dnf install -y gcc` and `podman exec "${PWD##*/}" make`.
|
||||
Remove it with `podman rm -f` when the work is done.
|
||||
- On the host: git, ssh, curl, tar/gzip/xz/zstd, find, diff, ps, ip.
|
||||
- **Your files survive reboots**: your home (/home/claude), containers and images stay.
|
||||
/tmp is wiped at every boot. The VM may reboot at about 04:10 to update.
|
||||
- **To start over**, push what you want to keep, then remove all containers and images with
|
||||
`podman system reset --force` and delete everything in your home but `~/.claude` and
|
||||
`~/.claude.json`, which hold your Claude login.
|
||||
- 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.
|
||||
Reference in new issue
Block a user