chore: install Claude Code from its package repository, add style guide
Replace mkosi.prepare with Anthropic's rpm repository (mkosi.sandbox/), switch the workflow to the gitea context, and start STYLE.md with a consistent file header. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
10 files changed
+96
-28
No files matched your search
@@ -1,28 +1,27 @@
|
||||
# agent OS image
|
||||
#
|
||||
# Builds the OS image and publishes it as version "latest" of the generic package agent, where VMs
|
||||
# fetch their updates (mkosi.extra/usr/lib/sysupdate.d). Runs on every push, weekly for Fedora and
|
||||
# Claude Code updates, and by hand.
|
||||
# Builds the OS image and publishes it as version "latest". VMs fetch the build
|
||||
# images as updates (mkosi.extra/usr/lib/sysupdate.d). Runs on every push,
|
||||
# weekly for package updates, and by hand for critical CVE's.
|
||||
name: os
|
||||
on:
|
||||
push:
|
||||
branches: [main]
|
||||
schedule:
|
||||
- cron: "0 2 * * 0" # weekly (Sunday), picks up Fedora and Claude Code updates
|
||||
- cron: "0 2 * * 0" # weekly (Sunday), picks up package updates
|
||||
workflow_dispatch: # run by hand, e.g. for a CVE
|
||||
|
||||
jobs:
|
||||
os:
|
||||
runs-on: linux
|
||||
env:
|
||||
PKG: ${{ github.server_url }}/api/packages/${{ github.repository_owner }}/generic/agent/latest
|
||||
AUTH: "Authorization: token ${{ github.token }}"
|
||||
PKG: ${{ gitea.server_url }}/api/packages/${{ gitea.repository_owner }}/generic/agent/latest
|
||||
AUTH: "Authorization: token ${{ gitea.token }}"
|
||||
steps:
|
||||
- name: Install tools
|
||||
run: dnf install -yq mkosi sbsigntools
|
||||
- name: Check out
|
||||
uses: builtin:checkout
|
||||
# Signs systemd-boot and the UKI for Secure Boot (mkosi.conf, [Validation]).
|
||||
- name: Build
|
||||
env:
|
||||
KEY: ${{ secrets.SECUREBOOT_KEY }}
|
||||
@@ -35,7 +34,6 @@ jobs:
|
||||
zstd -q --rm -T0 -19 agent_*.root-*.raw
|
||||
qemu-img convert -c -O qcow2 "$(basename agent_*.efi .efi).raw" agent.qcow2
|
||||
sha256sum agent_*.efi agent_*.root-*.raw.zst > SHA256SUMS
|
||||
# Signs SHA256SUMS with the key whose public half is mkosi.extra/usr/lib/systemd/import-pubring.pgp.
|
||||
- name: Sign
|
||||
working-directory: mkosi.output
|
||||
env:
|
||||
@@ -44,7 +42,6 @@ jobs:
|
||||
export GNUPGHOME=$(mktemp -d)
|
||||
gpg -q --batch --import <<< "$KEY"
|
||||
gpg -q --batch -o SHA256SUMS.gpg --detach-sign SHA256SUMS
|
||||
# Replaces the previous version. SHA256SUMS goes last: until it's there, VMs find no update.
|
||||
- name: Publish
|
||||
working-directory: mkosi.output
|
||||
run: |
|
||||
|
||||
@@ -1,4 +1,2 @@
|
||||
# Build outputs.
|
||||
mkosi.output/
|
||||
# The Secure Boot private key (the SECUREBOOT_KEY secret); mkosi.crt is its certificate.
|
||||
mkosi.key
|
||||
@@ -23,7 +23,7 @@ As soon as Claude is logged in, `claude-remote.service` starts `claude remote-co
|
||||
|
||||
## Development
|
||||
|
||||
`mkosi.conf` defines the OS (`mkosi.extra/` is copied to `/`, `mkosi.repart/` is the disk layout, `mkosi.prepare` installs Claude Code).
|
||||
`mkosi.conf` defines the OS (`mkosi.extra/` is copied to `/`, `mkosi.repart/` is the disk layout, `mkosi.sandbox/` adds the Claude Code package repository).
|
||||
|
||||
```sh
|
||||
mkosi build
|
||||
|
||||
@@ -0,0 +1,44 @@
|
||||
# Style guide
|
||||
|
||||
For everyone who changes this repository, people and AI agents alike.
|
||||
|
||||
## General
|
||||
|
||||
- Keep it simple. Prefer fewer files, fewer lines and the defaults. Delete what isn't needed.
|
||||
- Each fact lives in one place. Elsewhere, refer to it by path instead of repeating it.
|
||||
- Write plain English in short sentences.
|
||||
|
||||
## File header
|
||||
|
||||
Every file that allows comments starts with a header. It goes after the shebang, if there is one:
|
||||
|
||||
```sh
|
||||
#!/bin/sh
|
||||
# Image version
|
||||
#
|
||||
# Prints the build time in UTC (YYYYMMDDhhmm). Every build gets a higher version than the one
|
||||
# before, which is how systemd-sysupdate tells that an update is newer.
|
||||
```
|
||||
|
||||
- Line 1 is a title: a few words, in sentence case, with no full stop.
|
||||
- Then a line with only the comment character.
|
||||
- Then what the file does and why, naming the files it works with by path.
|
||||
|
||||
Files that can't hold comments (JSON, `subuid`, `machine-id`) are explained in the file that uses
|
||||
them or in the README.
|
||||
|
||||
## Comments
|
||||
|
||||
- Explain why, not what. Leave out comments that only repeat the code.
|
||||
- Put a comment right above the line or block it is about.
|
||||
- Wrap comments at 100 columns.
|
||||
|
||||
## Shell
|
||||
|
||||
- Use `#!/bin/sh` with `set -eu`. Switch to `#!/bin/bash` with `set -euo pipefail` only when the
|
||||
script needs bash.
|
||||
- Quote variables: `"$var"`.
|
||||
|
||||
## Config files
|
||||
|
||||
- Put one value per line in lists, with a comment explaining the less obvious entries.
|
||||
+3
-1
@@ -1,5 +1,5 @@
|
||||
# agent: a Fedora VM image that runs Claude Code in the background, built with mkosi.
|
||||
# mkosi.extra/ is copied to /, mkosi.repart/ defines the disk, mkosi.prepare adds Claude Code.
|
||||
# mkosi.extra/ is copied to /, mkosi.repart/ defines the disk, mkosi.sandbox/ adds the Claude Code repo.
|
||||
# The root filesystem, /etc included, is read-only and replaced whole by updates; all state lives
|
||||
# on /var. Claude can't change the OS: it runs its tools in containers.
|
||||
|
||||
@@ -27,6 +27,7 @@ Bootloader=systemd-boot
|
||||
# - openssh-server ssh login for the user (keys only)
|
||||
# - zram-generator-defaults compressed swap in RAM
|
||||
# - podman, podman-docker containers, for all of Claude's toolchains (also as docker)
|
||||
# - claude-code Claude Code (mkosi.sandbox/etc/yum.repos.d)
|
||||
# - git-core, openssh-clients Claude Code uses git; it pushes over ssh
|
||||
# - the rest basic command-line tools Claude uses on the host
|
||||
Packages=
|
||||
@@ -46,6 +47,7 @@ Packages=
|
||||
zram-generator-defaults
|
||||
podman
|
||||
podman-docker
|
||||
claude-code
|
||||
git-core
|
||||
openssh-clients
|
||||
curl
|
||||
|
||||
@@ -1,5 +1,4 @@
|
||||
{
|
||||
"permissions": { "defaultMode": "bypassPermissions" },
|
||||
"skipDangerousModePermissionPrompt": true,
|
||||
"env": { "DISABLE_AUTOUPDATER": "1" }
|
||||
"skipDangerousModePermissionPrompt": true
|
||||
}
|
||||
@@ -1,12 +0,0 @@
|
||||
#!/bin/sh
|
||||
# Installs Claude Code: the latest stable release, checked against the sha256 in its release manifest.
|
||||
# The image updates weekly, so Claude's own auto-updater is off (/etc/claude-code/managed-settings.json).
|
||||
set -eu
|
||||
u=https://storage.googleapis.com/claude-code-dist-86c565f3-f756-42ad-8dfa-d59b1c096819/claude-code-releases
|
||||
v=$(curl -fsS "$u/stable")
|
||||
sum=$(curl -fsS "$u/$v/manifest.json" | tr -d ' \n' | sed -n 's/.*"linux-x64":{[^}]*"checksum":"\([0-9a-f]*\)".*/\1/p')
|
||||
[ -n "$sum" ]
|
||||
# The binary is ~300 MB: when the download stalls (under 1 kB/s for a minute), resume it.
|
||||
curl -fsS --retry 10 --retry-all-errors --speed-limit 1000 --speed-time 60 -C - -o "$BUILDROOT/usr/bin/claude" "$u/$v/linux-x64/claude"
|
||||
echo "$sum $BUILDROOT/usr/bin/claude" | sha256sum -c
|
||||
chmod 755 "$BUILDROOT/usr/bin/claude"
|
||||
@@ -0,0 +1,29 @@
|
||||
-----BEGIN PGP PUBLIC KEY BLOCK-----
|
||||
|
||||
mQINBGnK73ABEACnbytJXkjweYrwIr0aLEFRlH+C0nF44KxFc7gQmJ6PjSPMGZAD
|
||||
dxZcaixU7zZl8WxEpVO0wLmIH8cf2zGOdyuZg1Yaugk1vHb2b8WBhAGCQJdPgB8W
|
||||
XquedepEYtk56uP/gCoTjJDUZluEGBHnlnuujSJ4orxEdhSykEoAUfJZGEILPpMd
|
||||
bphFt/Sn+Eb/TxM5jpKPdwnv8AShNF/1mZU1fWTQq9tRKJUakZj04gdaDFElQXak
|
||||
CtTij+GT6yoYCARSHwGO+PC/Pr6q4tc+D7LRjxSBvUWDoFSmlqb/PJ1hj9D/7I2O
|
||||
e4XXniAPWMR56KvxHlzOzrNQdJujbJdSkCwh1ZijkSd3y8ayW5WYUTGdRab99NUw
|
||||
agzlabe/VVF6kzJ0Scn5q3PihB2Y9Bwo0CKnkYk7a7KT77EWv0Kkq+VHmOtqX3a2
|
||||
hhX+b6a6ve9rzJ1qZYGj+obv/C3Sx1LzUjAfqVy7RJDf2uAoP5t2g8u/TkSpUxhM
|
||||
VEjZBkSxYZhMyzQM6t8IgkUfnSrIPTHixbDWARZ4beMOBjxyPZK1nP7OOrNR3TkK
|
||||
JtwLMQAabURCDnL0PjS0iwBTU4jtumBD1XSULyWuoTvMljrpQr1nV1oDyOt0OLqa
|
||||
KA2McWtd9PdXhC8y2EIg7TmrTlJLfHYbdmkiCYj4J49Q8HWkN/6WE+RTUwARAQAB
|
||||
tD5BbnRocm9waWMgQ2xhdWRlIENvZGUgUmVsZWFzZSBTaWduaW5nIDxzZWN1cml0
|
||||
eUBhbnRocm9waWMuY29tPokCUQQTAQoAOxYhBDHd3iTd+rZ59C170rqpKf8afsrO
|
||||
BQJpyu9wAhsPBQsJCAcCAiICBhUKCQgLAgQWAgMBAh4HAheAAAoJELqpKf8afsrO
|
||||
l5IP/2I8X1dFy5xYczWB/coIxGjuzS/V6ByZGZZEJsbr04pmuHiFUykJqPGWGQ6q
|
||||
U0YF5iEwvEkaagS5m7DzhSEf3FM3Cgafax/6d70tar9Vr1D+w6uPfxetu7u/WYJp
|
||||
aolIsdh5fTrBh9zSM1Njl8FM8wG8CwZQjS33Oa7d8cwRkgdUWbt6LXgz+cTQNuBn
|
||||
BgW6Ks7oZFI25dfu0ojDR+aDFJg4+4wZoyDLPvJz1SIrJ5WFGs67zsx9SfS3yZnf
|
||||
XKmBe+f0dUy+GJ2nFZrXFf99+c0dPEHYO8DCeAHZizjkFrdYtUHdDU0YDYEGkLJa
|
||||
bE+pgcpkHf5EvsZzHsyDbl95W/eh7pcXMbwkN+W4CBYUE9X4uHhqzWaC5yAVRWUA
|
||||
1BJ9V4LjZfHPLEJt0I3TxzXiEg9/BVeaTYq9RjaxIFo9Nfk158HqJY6SA5jslBlx
|
||||
Gv/No8u+xVcze2UJyGVfEIUfm92+0UAIkny3+5cuVV0ICzJxXlXj0CnLM9Lt50wE
|
||||
p3suVwuBEviCbZ08eAH1Ht8gbBdSsiOkIU8CX3v/scwHHx5q0+NBL6xLrQObg13a
|
||||
tRXBlKObfElkPN3lTUbUnJOW4U8uSjH8VRP+AujKWMDFe7x0zCs+iYY1mTOvbrTS
|
||||
9n3CmZUmbynZ+E/QWNENpW/pDNZdWFy43PASmML5FHu4m9Sn
|
||||
=oqMI
|
||||
-----END PGP PUBLIC KEY BLOCK-----
|
||||
@@ -0,0 +1,9 @@
|
||||
# Claude Code
|
||||
#
|
||||
# Anthropic's package repository, stable channel. The key's fingerprint is
|
||||
# 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE.
|
||||
[claude-code]
|
||||
name=Claude Code
|
||||
baseurl=https://downloads.claude.ai/claude-code/rpm/stable
|
||||
gpgcheck=1
|
||||
gpgkey=file:///etc/pki/rpm-gpg/claude-code.asc
|
||||
+3
-1
@@ -1,3 +1,5 @@
|
||||
#!/bin/sh
|
||||
# The image version: the build time, so every build is newer than the last.
|
||||
# Image version
|
||||
#
|
||||
# The build time (UTC), so every build is newer than the last.
|
||||
date -u +%Y%m%d%H%M
|
||||
Reference in new issue
Block a user