From 2f15b7fd00336c059b82987e720524f44c69e9d6 Mon Sep 17 00:00:00 2001
From: syui <syui@syui.ai>
Date: Fri, 27 Feb 2026 13:03:03 +0900
Subject: [PATCH] update readme

---
 README.md | 187 +-----------------------------------------------------
 1 file changed, 2 insertions(+), 185 deletions(-)

diff --git a/README.md b/README.md
index 1ddc2af..92c72af 100644
--- a/README.md
+++ b/README.md
@@ -1,188 +1,5 @@
-# <img src="./icon/ai.png" width="30"> ai `os`
+# aios
 
-**aios** = ArchLinux + Claude Code + aigpt in systemd-nspawn
+An environment where AI (Claude) operates an OS (Arch Linux/systemd-nspawn) as a character with memory, publishing via AT Protocol, managed through Git and a custom shell.
 
-A minimal ArchLinux environment optimized for Claude Code with shared AI memory.
 
-```
-systemd-nspawn container
-├── Claude Code (AI interface)
-├── aigpt (shared memory)
-└── zsh (.zshrc configured)
-
-$ sudo machinectl shell aios
-$ claude  # Start Claude Code
-```
-
-## Philosophy
-
-**Insert AI into existing flows**
-
-Instead of building a new AI chat interface, use **Claude Code** (which already works).
-
-aios provides:
-1. Pre-installed **aigpt** (MCP server for shared memory)
-2. Pre-installed **Claude Code** (`npm i -g @anthropic-ai/claude-code`)
-3. Environment isolation with **systemd-nspawn**
-4. Shared memory across containers
-
-## What's Included
-
-### 1. Claude Code
-
-Pre-installed and ready to use:
-
-```sh
-$ claude
-# Claude Code starts, with MCP connection to aigpt
-> Install rust development environment
-✓ Installing rust, rust-analyzer, neovim
-```
-
-### 2. aigpt (Shared Memory)
-
-MCP server that provides persistent memory to Claude Code:
-
-```
-~/.config/syui/ai/gpt/memory.db (SQLite, WAL mode)
-  ↓ bind mount
-aios-dev, aios-prod, etc. (all share same DB)
-```
-
-AI remembers your preferences across all containers.
-
-### 3. systemd-nspawn
-
-Lightweight container environment:
-
-```sh
-$ sudo machinectl shell aios
-# Inside container with aigpt + Claude Code
-```
-
-Multiple containers can share the same memory.
-
-## Architecture
-
-```
-Host
-├── ~/.config/syui/ai/gpt/memory.db (shared)
-│
-└── /var/lib/machines/aios/ (container)
-    ├── ArchLinux base
-    ├── aigpt (MCP server)
-    ├── Claude Code
-    ├── .zshrc (aliases: ai=claude)
-    └── Bind mount → shared memory
-```
-
-## Quick Start
-
-```sh
-# 1. Clone repository
-$ git clone https://github.com/syui/aios
-$ cd aios
-
-# 2. Run installer (creates systemd-nspawn container)
-$ sudo ./aios-install.sh
-
-# 3. Enter container
-$ sudo machinectl shell aios
-
-# 4. Start Claude Code
-$ claude
-# or
-$ ai
-```
-
-## Container Distribution
-
-Pre-built containers are available:
-
-```sh
-# Docker
-$ docker run -it git.syui.ai/ai/os
-$ docker run -it ghcr.io/syui/aios
-
-# Podman
-$ podman pull aios  # using shortname alias
-```
-
-## Configuration
-
-### Directory Structure
-
-```
-~/.config/syui/ai/
-├── gpt/memory.db      # Shared memory (SQLite WAL)
-├── mcp.json           # MCP server config
-└── config.toml        # aios config
-```
-
-### MCP Configuration
-
-Claude Code connects to aigpt via MCP:
-
-```json
-{
-  "mcpServers": {
-    "aigpt": {
-      "command": "aigpt",
-      "args": ["server", "--enable-layer4"]
-    }
-  }
-}
-```
-
-This enables Claude Code to use aigpt's memory system.
-
-## Building from Source
-
-```sh
-$ pacman -S base-devel archiso docker git rust nodejs npm
-$ ./build.zsh
-# Creates: aios-bootstrap.tar.gz
-```
-
-## How It Works
-
-1. **systemd-nspawn** provides lightweight containers
-2. **aigpt** runs as MCP server, stores memories in SQLite
-3. **Claude Code** connects to aigpt via MCP
-4. Shared memory (`~/.config/syui/ai/gpt/memory.db`) is bind-mounted
-
-**Result:** Claude Code can remember your preferences across all containers.
-
-## Why Not Just Use Claude Code?
-
-You can! aios just provides:
-- Pre-configured environment
-- Shared memory (aigpt) pre-installed
-- Container isolation
-- Easy multi-environment setup
-
-## Links
-
-- Repository: https://github.com/syui/aios
-- Git: https://git.syui.ai/ai/os
-- aigpt: https://git.syui.ai/ai/gpt
-- Container: https://git.syui.ai/ai/-/packages/container/os
-
-## Philosophy
-
-**Insert AI into existing flows**
-
-Don't build a new AI chat interface. Use Claude Code (which already works).
-
-Don't create a new container system. Use systemd-nspawn (lightweight, standard).
-
-Just provide:
-1. aigpt for shared memory
-2. Pre-configured environment
-3. Automation scripts
-
-Simple. Minimal. Effective.
-
----
-
-© syui