KamilMatysikAI

Claude Agent OS — Documentation skill for Claude Code

Documentation community

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