agency
A bootable NixOS installer that turns a spare laptop or PC into a dedicated machine where AI coding agents run as root with their own desktop.
At a Glance
Self-hosted agency installer and NixOS-based machine for agents, licensed under MIT.
Engagement
Available On
Alternatives
Listed Nov 2026
About agency
agency is an open-source, MIT-licensed NixOS-based system that turns an old x86-64 laptop or PC into a dedicated computer for AI coding agents. You write an installer to a USB stick, boot the machine from it, and answer a short setup screen. The agents then run as root with their own desktop, and you reach the machine over SSH or a browser.
What It Is
agency packages the machine setup that people would otherwise do by hand: installing Linux with an encrypted disk, configuring SSH and Tailscale, installing and signing in to agents, and wiring up virtual desktops. The project says this takes about 5 minutes. The setup asks for network, name and GitHub user, the disk to erase, Tailscale, and which apps to install, and it does not touch the disk until you confirm on the last screen. Afterwards you log in with ssh agent@agency.local on the same network, or over Tailscale.
How the Machine Works for Agents
The project provides skills for Claude Code, Codex and OpenCode so the agents already know how the machine works. Agents have root access, and every change is a commit, so agency rollback can undo a change. Desktops run virtually and can be watched or taken over from a browser tab. Secrets are stored encrypted and agents read them as environment variables. The machine updates itself weekly and unattended, and it uses TPM disk unlock.
Day-to-Day Use
The agency command shows what the machine is doing. Other subcommands include agency update, agency secret set, agency backup restore for hourly backups, and agency export --home to carry the setup to another machine. A dashboard shows CPU, memory, disks and a desktop, and works over Tailscale only. The machine is designed to sit on a shelf: with the lid shut it never sleeps and charges to 80%.
Setup Path
Requirements are an x86-64 laptop or PC with UEFI and TPM 2.0, a disk of 20 GB or more, an 8 GB or larger USB stick, Secure Boot turned off, internet during install, and a GitHub account with an SSH key. On macOS or Linux a single curl command writes the stick, and on Windows you download the ISO and write it with balenaEtcher or Rufus in DD mode. The README also documents trying it in a Nix-based virtual machine or running it on an existing NixOS machine.
Community Discussions
Be the first to start a conversation about agency
Share your experience with agency, ask questions, or help others learn from your insights.
Pricing
Open Source
Self-hosted agency installer and NixOS-based machine for agents, licensed under MIT.
- MIT License
- Bootable USB installer (3.2 GB ISO)
- Skills for Claude Code, Codex and OpenCode
- Rollback via agency rollback
- Encrypted secrets
Capabilities
Key Features
- Bootable USB installer that sets up a dedicated agent machine
- Skills for Claude Code, Codex and OpenCode
- Root access for agents with every change committed and rollback via agency rollback
- Virtual desktops viewable and controllable from a browser
- Encrypted secrets exposed to agents as environment variables
- Weekly unattended self-updates
- TPM disk unlock
- Hourly backups with restore
- Dashboard available over Tailscale only
- Setup export and import between machines
- SSH and Tailscale configured at first boot
- Try-out VM via Nix
