Claude Agent OS — Documentation skill for Claude Code
Agent operating system for Claude Code: a CEO agent plans, five roles execute, you get 15-minute tasks and decisions.
How to install Claude Agent OS
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open KamilMatysikAI/claude-agent-os and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Claude Agent OS does
Agent operating system for Claude Code: a CEO agent plans, five roles execute, you get 15-minute tasks and decisions. Plain Markdown files, MIT.
Alternatives in Documentation
- 会话管理(Session Manager)需求文档(PRD / Markdown) — 目标:对 Codex / Claude Code 的本地会话记录进行可视化管理,并提供“一键复制 / 一键终端恢复”能力 31.7k ★
- Repo Recap — Generate a structured recap of the repository state: open PRs, open issues, recent releases, and executive sum 11.9k ★
- Ars Format Convert — ARS academic-paper format-convert mode — convert to LaTeX / DOCX / PDF / Markdown 4.5k ★
README
claude-agent-os
A small company of agents for Claude Code, kept in plain Markdown files.
A `ceo` agent turns your goal into a plan and tasks. Five roles (marketing, copy, web, soft, research) do the work, and an optional queue picks up one task every 30 minutes with a restricted permission profile. You only get two kinds of work back: tasks that take 15 minutes or less, and decisions with a recommendation already written.
It grew out of a real business that is not a software house (property development, online retail, rentals) and has been running there since August 2026. The 40 rules in this repo were written after things went wrong there.
Status: v0.1.1. Works on Windows, macOS and Linux (CI on all three). Expect rough edges.
Who it is for
**A good fit if you**
- run several projects at once, alone or with a very small team, and use Claude Code daily;
- want agents to keep working between your sessions, but only inside limits you set;
- prefer files you can read and edit in any editor (or Obsidian) over another web app with a database.
**Not a good fit if you**
- already run your team in Jira, Linear or similar and need agents to fit that flow;
- want a hosted product with accounts, budgets per agent and a mobile app (look at Paperclip);
- are not comfortable letting an agent edit files in a folder on its own. The queue is off by default, but it is the point of the system.
Start in 5 minutes
Requirements: Python 3.11+, [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installed and logged in, git. No other dependencies: the engine is stdlib only.
git clone https://github.com/KamilMatysikAI/claude-agent-os.git
cd claude-agent-os
python install.py # wizard: workspace folder, name, language, time zone, queue, panel, notifications, rule packs, demo
cd
claude
The installer creates a private virtual environment in `/.agentos/venv
Related Skills
MushroomTW Skills
Five portable Agent Skills for README authoring, dependency decisions, repository bug audits, and SonarQube qu
Plans
A markdown convention for tracking what you are building. Plain files in your repo, one source of truth for wh
Samemind
Keep your decisions, projects, and context when you switch between Claude Code, Cursor, opencode, and the rest
Project Architect
Documentation-first project planning agent skill. Generates specs, implementation plans, tasks, and single-sho
Portable Agent Project Operating Protocol
Portable Markdown rules and shell tools for agent discipline: two governance modes (strict approval / autonomo
Sop
Generate a Markdown Standard Operating Procedure — install, recovery, and manual-override steps.
Related Agents
Blues
Work planner agent. Breaks tasks into structured PLAN.md with actionable steps, file ownership, test criteria,
Agent Contract: Direct Markdown Sharing
This contract defines the public Proof SDK flow for creating and operating on shared documents over HTTP.
Project Architect
Designs system architecture, plans features, breaks work into tasks, and makes technology decisions. Use when