From b59177683945957170cee8f07bf2bc44a997dd84 Mon Sep 17 00:00:00 2001
From: To Nguyen <hanh.tonguyen@visssoft.com>
Date: Thu, 19 Mar 2026 07:45:09 +0700
Subject: [PATCH] Update README: add sudo npm link and direct node run as two
 install methods

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 README.md | 40 ++++++++++++++++++++++++++++++----------
 1 file changed, 30 insertions(+), 10 deletions(-)

diff --git a/README.md b/README.md
index ae43926..370a32b 100644
--- a/README.md
+++ b/README.md
@@ -26,8 +26,11 @@ Superpowers is an incredible skill-based workflow system that gives AI coding as
 ```bash
 git clone https://git.visssoft.com/hanh.tonguyen/antigravity-superpowers.git
 cd antigravity-superpowers
-npm link
+sudo npm link                # cách A: link global
 antigravity-superpowers init
+
+# hoặc chạy trực tiếp (không cần install)
+node bin/antigravity-superpowers.js init
 ```
 
 ---
@@ -53,30 +56,47 @@ antigravity-superpowers init
 ```bash
 git clone https://git.visssoft.com/hanh.tonguyen/antigravity-superpowers.git
 cd antigravity-superpowers
-npm link
 ```
 
-Verify CLI is available:
+**Cách A: Link global (cần sudo)**
+
+```bash
+sudo npm link
+```
+
+Sau đó dùng ở bất kỳ đâu:
 
 ```bash
 antigravity-superpowers --version
-# 0.2.0
+antigravity-superpowers init
 ```
 
+**Cách B: Chạy trực tiếp bằng node (không cần sudo)**
+
+```bash
+node bin/antigravity-superpowers.js --version
+node bin/antigravity-superpowers.js init /path/to/your/project
+```
+
+> Cách B không cần cài đặt, chạy được ngay. Thay `antigravity-superpowers` bằng `node bin/antigravity-superpowers.js` trong tất cả lệnh bên dưới.
+
 ### Update to latest version
 
 ```bash
 # 1. Pull source mới
 cd antigravity-superpowers
 git pull
-npm link
 
-# 2. Tại mỗi project đã init trước đó — update profile với backup
-cd /path/to/your/project
-antigravity-superpowers init --force --backup
+# 2. (Chỉ nếu dùng cách A) Link lại
+sudo npm link
 
-# 3. Kiểm tra profile sau update
-antigravity-superpowers validate
+# 3. Update profile tại project đã init — giữ backup bản cũ
+antigravity-superpowers init --force --backup /path/to/your/project
+# hoặc
+node bin/antigravity-superpowers.js init --force --backup /path/to/your/project
+
+# 4. Kiểm tra profile sau update
+antigravity-superpowers validate /path/to/your/project
 ```
 
 Bản cũ được giữ lại tại `.agent-backup-<timestamp>`. Nếu cần rollback: