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)

Searching Database…

Что это такое?Agent0S — управляемое с клавиатуры окружение рабочего стола Arch Linux + Hyprland, форк Omarchy, созданное так, чтобы ИИ-кодинг-агенты могли читать, изменять и проверять систему через входящие в комплект AGENTS.md, CLAUDE.md и навыки агента.
Это полноценный Linux-дистрибутив или просто слой конфигурации поверх Omarchy/Arch?Это не самостоятельный дистрибутив — это форк dotfiles и настройки Hyprland из Omarchy, сохраняющий тот же тайловый рабочий стол Wayland и добавляющий поверх слой, готовый к работе с агентами.
Нужно ли сначала настроить Arch и Omarchy, прежде чем пробовать это?Да — нужно загрузиться с оригинального ISO Omarchy, так как у Agent0S пока нет собственного установочного образа; он надстраивается поверх этой основы.
В чём сейчас подвох процесса установки?Отдельного установщика или ISO для Agent0S пока нет, поэтому сначала придётся пройти установщик Omarchy, и только потом применятся изменения форка.
Работает ли это ещё и на macOS или Windows?Нет, это только Linux, сделанный специально для Arch и композитора Hyprland Wayland; гайд «Coming From Mac or Windows» — лишь советы по переходу для сменяющих платформу, а не поддержка запуска Agent0S на этих ОС.
Что за навыки агента входят в Agent0S?Это сценарии задач, хранящиеся в agents/skills/ и охватывающие приёмочные тесты, установочные скрипты, миграции, разработку для шелла и визуальную проверку; написаны так, чтобы ИИ-кодинг-агенты могли понимать систему и безопасно её изменять.
Почему форк Omarchy, а не создание с нуля?Agent0S сохраняет всё, что делает Omarchy приятным в повседневной работе, и просто добавляет сверху слой, ориентированный на агентов (AGENTS.md, CLAUDE.md, skills), вместо того чтобы изобретать рабочий стол заново.
Сколько тем идёт встроенными?Из коробки идут 22 встроенные темы плюс гайд по созданию собственных.
Обязательно ли пользоваться ИИ-кодинг-агентами, чтобы получить пользу?Нет — это прежде всего полноценный управляемый с клавиатуры рабочий стол Hyprland с отобранными темами и инструментами разработки; слой ИИ-агентов — приятный бонус поверх удобной системы на каждый день.
Creator
eli-labz
Size
237.9 MB
Stars
238
Age
1mo
Commits · 90 Days