sagaz-ai 0.1.1 → 0.1.2

package/INSTALL.md

@@ -8,12 +8,41 @@
 - GitHub CLI (`gh`) installed and authenticated if you want GitHub Ops.
 - Access to the local Codex skills folder.
 
+## Platform Support
+
+Sagaz can be used on Windows and macOS through Codex Desktop. The npm installer uses the current user's home directory and installs the skill into the standard Codex skills folder:
+
+- Windows: `C:\Users\YOUR_USER\.codex\skills\sagaz`
+- macOS: `~/.codex/skills/sagaz`
+
+If your Codex Desktop installation uses a custom home folder, pass `--codex-home <path>`.
+
 ## Recommended: Install With npx
 
+### Windows PowerShell
+
 ```powershell
 npx sagaz-ai install
 ```
 
+Optional ecosystem copy:
+
+```powershell
+npx sagaz-ai install --ecosystem C:\Users\YOUR_USER\Documents\Sagaz\ai-orchestration-ecosystem
+```
+
+### macOS Terminal
+
+```bash
+npx sagaz-ai install
+```
+
+Optional ecosystem copy:
+
+```bash
+npx sagaz-ai install --ecosystem ~/Documents/Sagaz/ai-orchestration-ecosystem
+```
+
 Then open a new Codex Desktop thread and test:
 
 ```text
@@ -22,32 +51,52 @@ Sagaz: explain the available workflows.
 
 ## Optional Commands
 
+### Windows PowerShell
+
 ```powershell
 npx sagaz-ai status
 npx sagaz-ai doctor
 npx sagaz-ai install --force
 ```
 
-To also copy the ecosystem to a chosen folder:
+### macOS Terminal
 
-```powershell
-npx sagaz-ai install --ecosystem C:\Users\YOUR_USER\Documents\Sagaz\ai-orchestration-ecosystem
+```bash
+npx sagaz-ai status
+npx sagaz-ai doctor
+npx sagaz-ai install --force
 ```
 
 ## Manual Install
 
-Copy:
+Copy the Sagaz skill folder from the repository.
+
+Windows source folder:
 
 ```text
 codex-skill\sagaz
 ```
 
-into:
+macOS source folder:
+
+```text
+codex-skill/sagaz
+```
+
+into the platform-specific Codex skill folder.
+
+Windows:
 
 ```text
 C:\Users\YOUR_USER\.codex\skills\sagaz
 ```
 
+macOS:
+
+```text
+~/.codex/skills/sagaz
+```
+
 Then open a new Codex Desktop thread and test:
 
 ```text
@@ -64,6 +113,8 @@ Sagaz: use the appropriate workflow for this project. Maintain run state, handof
 
 ## GitHub Ops
 
+### Windows PowerShell
+
 Authenticate GitHub CLI:
 
 ```powershell
@@ -75,4 +126,26 @@ Verify:
 ```powershell
 gh auth status
 git --version
-```
+```
+
+### macOS Terminal
+
+Install Git and GitHub CLI if needed:
+
+```bash
+xcode-select --install
+brew install gh
+```
+
+Authenticate GitHub CLI:
+
+```bash
+gh auth login -h github.com
+```
+
+Verify:
+
+```bash
+gh auth status
+git --version
+```

package/README.md

@@ -77,14 +77,17 @@ Key areas:
 
 ### Recommended: Install With npx
 
-```powershell
-npx sagaz-ai install
-```
+Sagaz supports Windows and macOS through Codex Desktop. The npm installer installs the skill into the current user's Codex skills folder:
 
-Then open a new Codex Desktop thread and run:
+- Windows: `C:\Users\YOUR_USER\.codex\skills\sagaz`
+- macOS: `~/.codex/skills/sagaz`
 
-```text
-Sagaz: explain the available workflows.
+If your Codex Desktop installation uses a custom home folder, pass `--codex-home <path>`.
+
+#### Windows PowerShell
+
+```powershell
+npx sagaz-ai install
 ```
 
 Optional: also copy the ecosystem to a known local folder:
@@ -100,36 +103,79 @@ npx sagaz-ai status
 npx sagaz-ai doctor
 ```
 
+#### macOS Terminal
+
+```bash
+npx sagaz-ai install
+```
+
+Optional: also copy the ecosystem to a known local folder:
+
+```bash
+npx sagaz-ai install --ecosystem ~/Documents/Sagaz/ai-orchestration-ecosystem
+```
+
+Check installation:
+
+```bash
+npx sagaz-ai status
+npx sagaz-ai doctor
+```
+
+Then open a new Codex Desktop thread and run:
+
+```text
+Sagaz: explain the available workflows.
+```
+
 ### Manual Installation
 
 #### 1. Clone Or Download The Repository
 
+Windows PowerShell:
+
 ```powershell
 git clone https://github.com/tscabral1/sagaz.git
 ```
 
+macOS Terminal:
+
+```bash
+git clone https://github.com/tscabral1/sagaz.git
+```
+
 Or download the ZIP from GitHub.
 
 #### 2. Copy The Skill Into Codex
 
-On Windows, the local Codex skills folder is usually:
+Copy the Sagaz skill folder from the repository.
+
+Windows source folder:
 
 ```text
-C:\Users\YOUR_USER\.codex\skills
+codex-skill\sagaz
 ```
 
-Copy this folder:
+macOS source folder:
 
 ```text
-codex-skill\sagaz
+codex-skill/sagaz
 ```
 
-into:
+into the platform-specific Codex skills folder.
+
+Windows:
 
 ```text
 C:\Users\YOUR_USER\.codex\skills\sagaz
 ```
 
+macOS:
+
+```text
+~/.codex/skills/sagaz
+```
+
 #### 3. Keep The Ecosystem Available
 
 Keep `ai-orchestration-ecosystem/` accessible in the Codex workspace or in a known local folder.

package/bin/sagaz.js

@@ -23,9 +23,16 @@ Usage:
   npx sagaz-ai doctor
 
 Options:
-  --codex-home <path>     Override Codex home. Default: ~/.codex
+  --codex-home <path>     Override Codex home. Default: ~/.codex on Windows, macOS, and Linux
   --ecosystem <path>      Also copy ai-orchestration-ecosystem to a target folder
   --force                 Overwrite existing installed skill
+
+Examples:
+  Windows:
+    npx sagaz-ai install --ecosystem C:\\Users\\YOUR_USER\\Documents\\Sagaz\\ai-orchestration-ecosystem
+
+  macOS:
+    npx sagaz-ai install --ecosystem ~/Documents/Sagaz/ai-orchestration-ecosystem
 `);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sagaz-ai",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Sagaz AI orchestration ecosystem installer for Codex Desktop.",
   "type": "module",
   "bin": {