Release v1.0.2: Cross-platform support with global commands

## Major Changes

### Cross-Platform Support
- Added macOS/Linux installation and uninstallation scripts
- Updated tool to automatically detect platform (Windows/macOS/Linux)
- Platform-independent configuration path detection
- All script files are executable on Unix-like systems

### Global Command Support
- Windows: Automatic PATH configuration for global 'omo' command
- macOS/Linux: Symbolic link creation in /usr/local/bin
- Commands can be used from any directory after installation

### Project Structure Refactoring
- Created src/ directory for source code
- Created scripts/ directory for all installation/uninstallation scripts
- Clean separation of concerns
- Removed redundant wrapper scripts from root directory

### Other Improvements
- Removed config.example.json (tool auto-detects config file)
- Updated CI workflow to use new project structure
- Improved regex-based plugin status detection
- Enhanced error messages and user feedback

## Files Added
- scripts/install.sh - macOS/Linux installer
- scripts/uninstall.sh - macOS/Linux uninstaller
- scripts/omo.sh - macOS/Linux wrapper
- AGENTS.md - Development guidelines

## Files Removed
- config.example.json - No longer needed
- Root-level *.bat/*.sh shortcuts - Redundant

## Testing
- Verified on Windows with Node.js v24.13.0
- All commands tested: on, off, enable, disable, status
- Configuration file modification verified

Author: OhMyOpenCode Toggle Tool

.github/workflows/ci.yml

@@ -24,17 +24,25 @@ jobs:
 
     - name: Test toggle script
       run: |
-        # Create test config
-        cp config.example.json opencode.json
-        
+        # Create test config directory and file
+        mkdir -p ~/.config/opencode
+        cat > ~/.config/opencode/opencode.json << 'EOF'
+        {
+          "$schema": "https://opencode.ai/config.json",
+          "plugin": [
+            "oh-my-opencode"
+          ]
+        }
+        EOF
+
         # Test status
-        node omo-toggle/omo-toggle.js status
-        
+        node src/omo-toggle.js status
+
         # Test disable
-        node omo-toggle/omo-toggle.js off
-        
+        node src/omo-toggle.js off
+
         # Test enable
-        node omo-toggle/omo-toggle.js on
-        
+        node src/omo-toggle.js on
+
         # Verify config changes
-        cat opencode.json
+        cat ~/.config/opencode/opencode.json

.gitignore

@@ -52,9 +52,8 @@ coverage/
 # dotenv environment variables file
 .env
 
-# Local config files (keep example configs)
+# Local config files
 config.json
-!config.example.json
 
 # OpenCode specific (keep private)
 oh-my-opencode.json

AGENTS.md

@@ -0,0 +1,161 @@
+# AGENTS.md - OhMyOpenCode Toggle Tool
+
+This repository contains a simple Node.js tool for toggling OhMyOpenCode plugin status.
+
+## Build/Test Commands
+
+**Note:** This project has no build step. It's a pure Node.js script.
+
+### Running Tests
+Tests are manual integration checks via CI. Run locally:
+
+```bash
+# Setup test config
+cp config.example.json opencode.json
+
+# Test all commands
+node omo-toggle/omo-toggle.js status
+node omo-toggle/omo-toggle.js off
+node omo-toggle/omo-toggle.js on
+
+# Or use the convenience script (after installation)
+cd %USERPROFILE%\.config\opencode
+omo status
+omo off
+omo on
+```
+
+**Test via CI:**
+```bash
+# GitHub Actions workflow (automated)
+./.github/workflows/ci.yml
+# Tests on Node.js 16.x, 18.x, 20.x
+```
+
+### Running the Tool
+```bash
+# Direct execution
+node omo-toggle/omo-toggle.js [command]
+
+# After installation
+odo [command]
+opo [command]
+
+# Valid commands: on, off, enable, disable, status
+```
+
+## Code Style Guidelines
+
+### JavaScript/Node.js
+
+**Language:** CommonJS (not ESM modules)
+
+**Imports:**
+- Use `require()` for built-in modules only
+- No external dependencies
+- Import order: built-ins first (fs, path, etc.)
+
+```javascript
+// ✅ Correct
+const fs = require('fs');
+const path = require('path');
+```
+
+**Indentation:**
+- 4 spaces (no tabs)
+
+**Naming Conventions:**
+- Variables: camelCase (`configText`, `configPath`)
+- Files: kebab-case (`omo-toggle.js`)
+
+**Error Handling:**
+- Use try-catch blocks for file operations
+- Console.error for error messages
+- `process.exit(1)` on fatal errors
+
+```javascript
+try {
+  configText = fs.readFileSync(configPath, 'utf8');
+} catch (error) {
+  console.error('无法读取配置文件:', error.message);
+  process.exit(1);
+}
+```
+
+**Comments & Messages:**
+- Use Chinese for user-facing messages
+- Use English for inline code comments (mixed codebase)
+- Include emoji for status messages: ✅ ❌
+
+```javascript
+// 获取命令行参数
+const command = process.argv[2];
+
+console.log('✅ OhMyOpenCode 已启用');
+console.error('无法读取配置文件:', error.message);
+```
+
+### Code Organization
+
+**Project Structure:**
+- `/omo-toggle/` - Core tool directory
+  - `omo-toggle.js` - Main logic
+  - `omo.bat` - Windows batch wrapper
+- `/` - Root directory
+  - `omo.bat` - Installation shortcut
+  - `install.bat` - Windows installer
+  - `config.example.json` - Config template
+  - `README.md` - Chinese documentation
+
+**Script Entry Point:**
+- Shebang: `#!/usr/bin/env node`
+- CLI args: `process.argv[2]` for commands
+- Exit codes: 0 for success, 1 for errors
+
+### Files & Configurations
+
+**Target Config File:** `opencode.json` (not in repo)
+- Location: Parent directory of script
+- Modified in-place for enable/disable toggling
+
+**No Build Tools:**
+- No package.json
+- No dependencies
+- No TypeScript
+- No linting config
+
+### Windows Batch Scripts
+
+**Style:**
+- Use `@echo off` (silent execution)
+- SET variables for paths
+- XCOPY for directory copy
+- COPY for file copy
+- `>nul` to suppress copy output
+- Error handling with `errorlevel`
+
+```batch
+@echo off
+setlocal enabledelayedexpansion
+set TARGET_DIR=%USERPROFILE%\.config\opencode
+```
+
+## Development Notes
+
+**Core Logic:**
+- Plugin enabled when `"oh-my-opencode"` appears in config
+- Plugin disabled when `"oh-my-opencode"` appears commented (`//` prefix)
+- Simple string replacement: removes/adds `//` prefix
+- Status check: searches for unquoted plugin string
+
+**Critical Paths:**
+- Config path: `path.join(__dirname, '..', 'opencode.json')`
+- This assumes the script runs from `omo-toggle/` subdirectory
+
+**Platform Support:**
+- Primary: Windows (batch scripts)
+- Cross-platform: Node.js script runs anywhere
+
+**No Testing Framework:**
+- Manual testing only
+- CI runs direct Node.js commands (no test harness)

README.md

@@ -1,49 +1,93 @@
-# GitHub 发布说明
+# OhMyOpenCode Toggle Tool
 
-## Release v1.0.0 说明
-
-### 🎉 首次发布
-
-OhMyOpenCode Toggle Tool 是一个简单的命令行工具，用于在 OhMyOpenCode 插件的启用和禁用状态之间切换。
+一个简单的命令行工具，用于在 OhMyOpenCode 插件的启用和禁用状态之间切换。
 
 ### ✨ 特性
 
 - 🔄 简单的命令行开关（`omo on/off/status`）
 - ⚡ 即时状态检查
 - 🗂️ 清晰的目录结构
-- 💻 跨平台支持（Windows 批处理 + Node.js）
-- 📦 自动安装脚本
+- 💻 跨平台支持（Windows/macOS/Linux）
+- 🌐 全局命令支持（任意目录可用）
+- 📦 自动化安装脚本
 
 ### 🚀 安装方法
 
-#### 方法1: 手动安装
-1. 下载项目文件
-2. 运行 `install.bat`
-3. 在 OpenCode 配置目录中使用 `omo` 命令
+#### Windows
+```bash
+# 双击运行或在命令行中执行
+scripts\install.bat
+```
+
+#### macOS/Linux
+```bash
+# 给脚本添加执行权限
+chmod +x scripts/install.sh
+
+# 运行安装脚本
+./scripts/install.sh
+```
 
-#### 方法2: 直接复制
-1. 将 `omo-toggle/` 目录复制到你的 OpenCode 配置目录
-2. 将 `omo.bat` 复制到配置目录根目录
-3. 使用命令行工具
+如果提示需要管理员权限：
+```bash
+sudo ./scripts/install.sh
+```
 
 ### 📖 使用说明
 
+安装完成后，无论在哪个目录都可以使用 `omo` 命令：
+
 ```bash
 # 查看当前状态
 omo status
 
 # 启用 OhMyOpenCode
 omo on
+# 或者
+omo enable
 
 # 禁用 OhMyOpenCode
 omo off
+# 或者
+omo disable
+```
+
+### ⚙️ 工作原理
+
+工具通过修改 `~/.config/opencode/opencode.json` 文件来切换插件状态：
+
+- **启用**: `    "oh-my-opencode"`
+- **禁用**: `    //"oh-my-opencode"`
+
+修改后需要重启 OpenCode 才能使更改生效。
+
+工具会自动检测 OpenCode 配置文件，无需手动创建。
+
+### 🔧 高级用法
+
+#### 自定义配置路径
+如果 OpenCode 配置路径不在默认位置，可以设置环境变量：
+
+```bash
+# Windows
+set OPENCODE_CONFIG_PATH=C:\custom\path\to\config
+
+# macOS/Linux
+export OPENCODE_CONFIG_PATH=/custom/path/to/config
+```
+
+#### 直接使用 Node.js
+```bash
+# 进入 src 目录后
+cd ~/.config/opencode/src
+node omo-toggle.js [command]
 ```
 
-### ⚠️ 注意事项
+### ⚠️ 系统要求
 
-- 需要重启 OpenCode 才能使更改生效
-- 需要安装 Node.js
-- 需要有修改配置文件的权限
+- Node.js（已安装）
+- 修改配置文件的权限
+- OpenCode 已正确安装
 
 ### 🤝 贡献
 
@@ -57,13 +101,20 @@ omo off
 oh-my-opencode-toggle/
 ├── README.md                 # 项目说明
 ├── LICENSE                   # MIT 许可证
-├── .gitignore               # Git 忽略文件
-├── package.json             # Node.js 包配置
-├── config.example.json      # 示例配置文件
-├── install.bat              # Windows 安装脚本
-├── omo.bat                  # 根目录快捷方式
-└── omo-toggle/              # 工具目录
-    ├── omo-toggle.js        # Node.js 核心脚本
-    ├── omo.bat             # 本地批处理脚本
-    └── README.md           # 工具详细说明
-```
+├── AGENTS.md                 # 代码规范
+├── .gitignore                # Git 忽略文件
+├── src/                      # 源代码目录
+│   └── omo-toggle.js        # Node.js 核心脚本
+└── scripts/                  # 脚本目录
+    ├── install.bat          # Windows 安装脚本
+    ├── install.sh           # macOS/Linux 安装脚本
+    ├── uninstall.bat        # Windows 卸载脚本
+    ├── uninstall.sh         # macOS/Linux 卸载脚本
+    ├── omo.bat              # Windows 命令包装器
+    ├── omo.sh               # macOS/Linux 命令包装器
+    └── README.md            # 脚本详细说明
+```
+
+## License
+
+MIT License