Skip to content

COMPATIBILITY.md

Latest commit

 

History

History
74 lines (55 loc) · 2.62 KB

COMPATIBILITY.md

File metadata and controls

74 lines (55 loc) · 2.62 KB

Cross-Platform Compatibility Summary

✅ Host CLIs

Host CLI Plugin Path Install Method Status
Claude Code plugins/claude-code/ /plugin marketplace add MomePP/OpenAgentsControl then /plugin install oac ✅ Supported
opencode plugins/opencode/ curl ... install.sh | bash (or copy plugins/opencode/* into .opencode/) 🟡 Beta — see plugins/opencode/README.md

The shell install.sh targets opencode. For Claude Code use the plugin marketplace path — no shell installer needed.

✅ Operating Systems (for install.sh / opencode)

Platform Bash Version Status Installation Method
macOS 3.2.57+ ✅ Works curl ... | bash
Linux 3.2+ ✅ Works curl ... | bash
Windows (Git Bash) 4.4+ ✅ Works curl ... | bash
Windows (WSL) 4.0+ ✅ Works curl ... | bash
Windows (PowerShell) N/A ✅ Works Download + Git Bash

Quick Start by Platform

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/MomePP/OpenAgentsControl/main/install.sh | bash -s essential

Windows (Git Bash)

curl -fsSL https://raw.githubusercontent.com/MomePP/OpenAgentsControl/main/install.sh | bash -s essential

Windows (PowerShell)

Invoke-WebRequest -Uri "https://raw.githubusercontent.com/MomePP/OpenAgentsControl/main/install.sh" -OutFile "install.sh"
& "C:\Program Files\Git\bin\bash.exe" install.sh essential

Test Your System

curl -fsSL https://raw.githubusercontent.com/MomePP/OpenAgentsControl/main/scripts/tests/test-compatibility.sh | bash

Key Compatibility Features

✅ Bash 3.2+ Compatible - Works on macOS default bash
✅ No mapfile - Uses while-read loops for compatibility
✅ No process substitution issues - Uses temp files
✅ Cross-platform paths - Handles Unix and Windows
✅ Color detection - Disables on unsupported terminals
✅ Platform detection - Auto-detects macOS/Linux/Windows

Requirements

  • Bash: 3.2 or higher
  • curl: Any recent version
  • jq: 1.5 or higher

Full Documentation

See Platform Compatibility Guide for:

  • Detailed platform instructions
  • Troubleshooting guide
  • Manual installation steps
  • Known limitations

Issues?

  1. Run compatibility test: bash scripts/tests/test-compatibility.sh
  2. Check bash version: bash --version
  3. Report issues: GitHub Issues