Skip to content

Commit 10817bd

Browse files
ZD Studiosclaude
andcommitted
docs: bring the README in line with what actually ships
The repo grew from five projects to nine over several sessions and the docs lagged behind in three places: - The integrations table listed only openclaw-os and OpenUI. Added Fabric, Caveman, Ponytail and Ruflo, and retitled it to make clear these are mounted into every agent rather than run as services. - The architecture diagram predated claude-code, the embed proxies and the whole mounted layer. Redrawn to show all six services with their real ports, the proxies that let openclaw/hermes render inside the Hub, and the Docker entry point. - `aios updates` (agent-supervised upstream updates) was missing from the command reference entirely, and `aios update` didn't mention that it now re-mounts skills too. Also updated the GitHub repo metadata to match: description now says nine projects rather than five, homepage points at the Pages root instead of /docs, and 20 topics added for discoverability (the API caps it at 20). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1 parent 30c68c6 commit 10817bd

1 file changed

Lines changed: 33 additions & 22 deletions

File tree

README.md

Lines changed: 33 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -117,37 +117,47 @@ aios url # open the Control Room
117117
| **claude-code** | Claude Code as an OpenAI-compatible API | `8000` | [codingworkflow/claude-code-api](https://github.com/codingworkflow/claude-code-api) |
118118
| **LifeOS** | Shared identity + skills mounted into the agents || [danielmiessler/LifeOS](https://github.com/danielmiessler/LifeOS) |
119119

120-
Plus two integrations that glue it together:
120+
Plus the integrations that glue it together — these aren't services, they're mounted into every agent:
121121

122122
| | Role | Upstream |
123123
|---|---|---|
124124
| **AIOS Hub** | The Control Room — unified dashboard + interconnect (`:8787`) | *(this repo)* |
125125
| **openclaw-os** | openclaw's generative-UI **dashboard** (a plugin, not an agent) | [thesys](https://github.com/thesysdev/openclaw-os) |
126126
| **OpenUI** | Generative-UI standard, mounted into every agent | [openui.com](https://www.openui.com) |
127+
| **Fabric** | **255 task patterns** run on your own model — `summarize`, `extract_wisdom`, … | [danielmiessler/fabric](https://github.com/danielmiessler/fabric) |
128+
| **Caveman** | Conciseness mode — ~65% fewer output tokens, accuracy kept | [JuliusBrussee/caveman](https://github.com/JuliusBrussee/caveman) |
129+
| **Ponytail** | Laziness mode — ~54% less code, YAGNI enforced | [DietrichGebert/ponytail](https://github.com/DietrichGebert/ponytail) |
130+
| **Ruflo** | Agent meta-harness — swarms, 314+ MCP tools, 30+ plugins | [ruvnet/ruflo](https://github.com/ruvnet/ruflo) |
127131

128132
## 🗺️ Architecture
129133

130134
```
131-
┌──────────────────────────────────────────────┐
132-
│ 💬 AIOS Hub — the Control Room :8787 │ talk to everything
133-
│ chat · broadcast · live status · interconnect
134-
└───────┬───────────┬───────────┬──────────┬────┘
135-
┌─────────────┘ ┌─────┘ ┌───┘ ┌───┘
136-
┌────────▼───────┐ ┌────────▼──────┐ ┌───▼──────┐ ┌▼──────────────┐
137-
│ opencode :4096 │ │ hermes :9119 │ │ openclaw │ │ CrewAI :4788 │
138-
│ coding engine │ │ autonomous │ │ :18789 │ │ multi-agent │
139-
└────────────────┘ └───────────────┘ └────┬─────┘ └───────────────┘
140-
every agent gets every other's URL │ hosts
141-
(agents call each other via the Hub) │
142-
┌─────────▼──────────┐
143-
│ openclaw-os (OpenUI) │ dashboard
144-
└──────────────────────┘
145-
┌──────────────────────────────────────────────────────────────────┐
146-
│ LifeOS skills + OpenUI context — mounted into every agent │
147-
└──────────────────────────────────────────────────────────────────┘
148-
149-
Single source of truth: aios.config.yaml + .env → rendered into each project's config
150-
Single control surface: ./aios <command> → state kept under .aios/
135+
┌────────────────────────────────────────────────────────────────────┐
136+
│ 💬 AIOS Hub — the Control Room :8787 │
137+
│ chat · canvas · task brain · taskflow · updates · audit · REST API │
138+
└──┬────────┬────────────┬────────────┬────────────┬─────────────────┘
139+
│ │ │ │ │ agents reach each other
140+
┌───────▼──┐ ┌───▼──────┐ ┌───▼──────┐ ┌───▼──────┐ ┌───▼─────────┐ through the Hub
141+
│ opencode │ │ hermes │ │ openclaw │ │ CrewAI │ │ claude-code │
142+
│ :4096 │ │ :9119 │ │ :18789 │ │ :4788 │ │ :8000 │
143+
│ coding │ │autonomous│ │28 channels│ │ crews │ │ your Claude │
144+
└──────────┘ └────┬─────┘ └────┬─────┘ └──────────┘ │subscription │
145+
│ │ hosts └─────────────┘
146+
┌──────▼────────────▼──────┐
147+
│ embed proxies :8791/:8792│ so their UIs render inside the Hub
148+
└──────────┬───────────────┘
149+
┌────▼─────────────────┐
150+
│ openclaw-os (OpenUI) │ generative-UI dashboard
151+
└──────────────────────┘
152+
┌────────────────────────────────────────────────────────────────────────┐
153+
│ Mounted into EVERY agent — not services: │
154+
│ LifeOS skills · OpenUI context · Fabric (255 patterns) │
155+
│ Caveman (say less) · Ponytail (build less) · Ruflo (swarms, MCP) │
156+
└────────────────────────────────────────────────────────────────────────┘
157+
158+
Single source of truth: aios.config.yaml + .env → rendered into each project
159+
Single control surface: aios <command> → state in .aios/aios.db
160+
Or run the whole thing: docker compose up -d
151161
```
152162

153163
## ✨ What you get
@@ -173,7 +183,8 @@ Plus two integrations that glue it together:
173183
| `aios restart [svc…\|all]` | Force a clean respawn (picks up new code after an update). `aios update` does this automatically. |
174184
| `aios status` | Table of each service: state, port, PID, health. |
175185
| `aios doctor` | Diagnose tools, config, deps and ports — with the exact fix for each. |
176-
| `aios update [--check]` | `git pull` + reinstall changed deps + re-render. `--check` just reports if updates exist (also auto-checked on start). |
186+
| `aios update [--check]` | `git pull` + reinstall changed deps + re-render + re-mount skills. `--check` just reports if updates exist (also auto-checked on start). |
187+
| `aios updates [--apply P]` | **Supervised** upstream updates — an agent reviews the commits and returns SAFE/RISKY/BLOCK before anything is applied; `--rollback P` restores a previous version. |
177188
| `aios autostart enable\|disable` | Run The AI OS on login/boot (Startup shortcut on Windows, systemd/`.bashrc` on Linux/WSL). |
178189
| `aios exec <cmd>` | Run a command through the agents' own **guardrailed, audited** shell. |
179190
| `aios channels` | List the **28 messaging channels** the gateway can bridge, and which are configured. |

0 commit comments

Comments
 (0)