From c957c76278bc2e50f855629599264537fe4b32c2 Mon Sep 17 00:00:00 2001
From: AIOSAI <aipass.system@gmail.com>
Date: Thu, 23 Apr 2026 01:07:32 -0700
Subject: [PATCH] =?UTF-8?q?feat(system):=20docs:=20add=20uninstall=20secti?=
 =?UTF-8?q?on=20to=20README=20=E2=80=94=20remove=20AIPass=20from=20project?=
 =?UTF-8?q?,=20remove=20single=20agent?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: @devpulse <devpulse@aipass>
---
 README.md | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/README.md b/README.md
index 946e2855..b74d56b8 100644
--- a/README.md
+++ b/README.md
@@ -244,6 +244,35 @@ Each agent documents its own operational status in its branch README — what wo
 
 ---
 
+<details>
+<summary>Uninstall</summary>
+
+### Remove AIPass from a project
+
+AIPass stores everything locally in your project directory. To remove it:
+
+```bash
+# Remove AIPass files from your project
+rm -rf .aipass/ .claude/ .ai_mail.local/ hooks/ src/
+rm -f CLAUDE.md AGENTS.md GEMINI.md STATUS.local.md *_REGISTRY.json .gitignore
+
+# If you installed via pip
+pip uninstall aipass
+```
+
+No cloud accounts, no external services, no cleanup beyond your local filesystem.
+
+### Remove a single agent
+
+Delete the agent's directory under `src/` and remove its entry from the registry JSON file:
+
+```bash
+rm -rf src/agent_name/
+# Then edit *_REGISTRY.json to remove the agent's entry
+```
+
+</details>
+
 <details>
 <summary>Subscriptions & Compliance</summary>