CoreDesktop

CoreDesktop is a set of scripts that turns a fresh Arch Linux + GNOME install into a keyboard-driven tiling desktop with the software we use at Federated Computer. It isn't a distribution: Arch does the heavy lifting, and CoreDesktop installs, configures and keeps things up to date on top of it.

Using CoreDesktop

Installing: install Arch, then CoreDesktop
Configure: connect to your Federated Computer Core and sign in to the AI agents
Updating: update, refresh, version, update notifications and snapshots
Software and Settings: software, shell, firewall and system defaults
Sandboxed AI Agents: how opencode, Hermes Agent and Claude Code are contained
Troubleshooting: common problems and fixes

Working on CoreDesktop

How CoreDesktop Works: repository layout and what runs when
Update Hooks: adding a step to update
Migrations: getting a change onto machines that are already installed
Configure Items: adding something to configure
Sibling Projects: building your own project on top of CoreDesktop

Quick reference

Command	What it does
`update`	Update CoreDesktop, Arch, AUR, Flatpaks and everything else
`refresh`	Re-run the installer to pick up newly added software
`configure`	Set up your Core, Tailscale, Nextcloud, email and AI agents
`version`	Show the CoreDesktop version, kernel and last update
`sibling`	Install, list or remove sibling projects
`unsandboxed <agent>`	Run an AI agent outside its sandbox

Using CoreDesktop

Working on CoreDesktop