Workspace · agents
The agent is a second user of the machine
The desktop is files, commands, and undo. An agent can read those. You pick the agent on first boot. We do not sell API keys.
We do not write the OS. Official ISO on a new name-brand chassis. Secure Boot off. Radios tested. UPS. You sign into the agent.
$ omarchy default agent ok CLI is text ok config is files ok update takes a snapshot ok radios tested before the box leaves # You sign into the agent. We do not sell the key.
Not a prompt
Agents need a computer
Upstream
What Omarchy already ships
01
Everything is a command, and every command is text
omarchy display text size. omarchy plugin add. Config is Lua, JSONC, TOML.
02
The OS ships a briefing
System files live in /usr/share/omarchy/ — do not touch. Your files live in ~/.config/ — edit these.
03
Undo is an OS feature
A bootable snapshot on every omarchy update. Factory reset lives in the setup menu. Plan mode first.
Permission
How much computer the agent should get
Connect the permission to the specific change. “Edit this window rule” is not “give me sudo.” If the agent is logged into your bank, your host portal, or your cloud dashboard, the sandbox is theater.
Five rungs of access
Open a config, a log, a screenshot of state.
Always start here.
Commitment ladder
Four ways to try this. One of them is a laptop.
1
Try Omarchy app
Real desktop in a VM on a Mac. Lowest risk. Not a computer that keeps running when you close the other lid.
2
Official ISO
Free. Under two minutes once the stick boots. You own Secure Boot, the Wi-Fi 7 card, NVIDIA, and suspend.
3
Dual-boot or a spare disk
Your files stay on the other OS. Still your Saturday.
4
A machine we already made agree
Official ISO on a warrantied Lenovo, Dell, HP, Acer, or Asus. Radios tested. UPS.