AgentOS README

The project's README from github.com/eli-labz/AgentOS. As one markdown file: README.md.

Agent0S

Agent0S

A beautiful, keyboard-driven Linux desktop built for working alongside AI agents.

Stars Last commit MIT License Arch Linux Hyprland

Getting Started · Manual · Agent Skills · Report a Bug


Why Agent0S?

Agent0S is a fork of Omarchy that keeps everything that makes it a joy to use and adds a layer designed for agentic workflows: a system your AI coding agents can understand, modify and verify.

The Agent0S desktop cycling through built-in themes
A few of the 22 built-in themes. See Themes to switch or make your own.

Quick start

Agent0S doesn't have its own ISO yet, so installs currently start from the upstream Omarchy ISO. Follow the Getting Started guide for the full walkthrough. Coming from macOS or Windows? Read Coming From Mac or Windows first.

For AI agents

File What it gives an agent
AGENTS.md Project conventions and how the repo fits together
CLAUDE.md Guidance for Claude-based coding agents
agents/skills/ Task playbooks: acceptance tests, install scripts, migrations, shell dev, visual verification and more

The Manual

The full manual lives in manual/.

The Basics
The Applications
Configuration
The Rest

Contributing

Issues and pull requests are welcome. If you're using an AI agent to contribute, point it at AGENTS.md and the agent skills first.

If Agent0S is useful to you, a ⭐ helps other people find it.

Credits

Agent0S is built on Omarchy, created by David Heinemeier Hansson and its contributors. Agent0S is an independent fork and is not affiliated with or endorsed by the Omarchy project.

License

Released under the MIT License.

AgentOS (eli-labz/AgentOS)

tiling-window-manager
Searching Database…

What is this?Agent0S is a keyboard-driven Arch Linux + Hyprland desktop environment forked from Omarchy, built so AI coding agents can read, modify and verify the system via included AGENTS.md, CLAUDE.md and agent skills.
Is this a full Linux distro or just a config layer on top of Omarchy/Arch?It's not a standalone distro — it's a fork of Omarchy's dotfiles and Hyprland setup, keeping the same tiling Wayland desktop and adding an agent-ready layer on top.
Do I need Arch and Omarchy already set up before trying this?Yes — you need to boot from the upstream Omarchy ISO since Agent0S doesn't ship its own installer image yet; it layers on top of that base.
What's the catch with the install process right now?There's no dedicated Agent0S installer or ISO yet, so you're bootstrapping through Omarchy's installer first before the fork's changes apply.
Does it run on macOS or Windows too?No, it's Linux-only, built specifically for Arch and the Hyprland Wayland compositor; the 'Coming From Mac or Windows' guide is just onboarding advice for people switching over, not support for running Agent0S on those OSes.
What are the agent skills included with Agent0S?They're task playbooks stored in agents/skills/ covering things like acceptance tests, install scripts, migrations, shell development and visual verification, written so AI coding agents can understand and safely modify the system.
Why fork Omarchy instead of building from scratch?Agent0S keeps everything that makes Omarchy pleasant day-to-day and simply adds an agent-aware layer (AGENTS.md, CLAUDE.md, skills) on top, rather than reinventing the desktop experience.
How many themes come built in?It ships with 22 built-in themes out of the box, plus a guide for creating your own.
Do I need to use AI coding agents to benefit from this?No — it's first and foremost a complete keyboard-driven Hyprland desktop with curated themes and dev tooling; the AI-agent layer is an added bonus on top of a usable daily driver.
Creator
eli-labz
Size
237.9 MB
Stars
238
Age
1mo
Commits · 90 Days