omarchy

项目简介

omarchy 是一个开源的现代化 Linux 发行版项目，致力于提供一套美观、统一且富有主见的 Linux 使用体验。与传统发行版不同，omarchy 从设计之初就将 AI Agent 集成作为核心目标，内置 Claude Code 兼容层、agents/skills 工作流、自动化脚本生态，并配备完整的主题系统、Shell 配置和文档体系。项目目前处于活跃开发阶段，代码结构清晰，适合开发者参与贡献或基于此构建自己的定制发行版。

核心功能

• AI Agent 原生集成：内置 agents/skills 目录，提供与 Claude Code 深度兼容的工作流定义
• 美观统一的主题系统：提供经过精心设计的桌面主题，覆盖深色和浅色模式
• 现代化 Shell 配置：预置开箱即用的 Shell 环境（可能为 zsh 或 fish），包含常用别名和插件
• 完整文档体系：配备 AGENTS.md、CLAUDE.md 等 AI 可读的协作文档，以及用户手册
• 计划任务管理：内置 plans 目录用于规划功能路线图
• 多架构支持：提供 Applications、config、install、shell、themes 等完整子系统
• 开发者友好：采用标准开源协作流程（GitHub Actions CI、PR 审核），代码结构模块化

技术实现

omarchy 采用 Lua 作为核心配置语言（.luarc.json），这种设计选择使系统配置具有声明式和可编程的双重特性。项目结构遵循「发行版即代码」理念：系统配置、主题、安装脚本和默认应用选择均以文本文件形式保存在仓库中，可通过 Git 进行版本控制。agents/skills 目录对标 Claude Code 的 skills 协议，允许 AI Agent 直接读取系统状态文件并执行操作，实现「AI 与操作系统深度协作」的愿景。安装系统通过 install 脚本实现半自动化，config 目录管理全局配置，themes 目录提供可替换的主题资源，manual 则提供人类可读的指南文档。

快速上手

第一步：访问 GitHub 仓库主页，查看 README.md 了解当前开发状态和安装要求 第二步：克隆仓库 git clone https://github.com/omacom/omarchy，切换到 quattro 分支（当前活跃开发分支） 第三步：阅读 manual 目录下的安装指南，执行安装脚本（建议在虚拟机中首次体验） 第四步：启动系统后，查看 AGENTS.md 了解 AI Agent 可用的系统接口 第五步：根据个人偏好修改 config 和 themes 目录中的文件，打造自己的定制版本

适用人群

• Linux 爱好者：希望体验新兴发行版的尝鲜用户
• AI 开发者：想探索 AI Agent 与操作系统深度集成的工程师
• 开源贡献者：对 Linux 发行版开发感兴趣，希望参与项目贡献的开发者
• 定制化玩家：希望基于源码构建专属发行版的进阶用户