darrenhinde 1a0f458e1a fix: cross-platform installer compatibility for bash 3.2+ and Windows

Critical fixes:
- Fix argument mismatch (accept 'core' and '--core' formats)
- Fix bash 3.2 compatibility (replace mapfile with while-read loops)
- Fix process substitution issues (use temp files)
- Add platform detection (macOS/Linux/Windows)
- Add bash version check (3.2+ required)
- Add conditional color support for Windows terminals

Enhancements:
- Platform-specific dependency installation instructions
- Improved help text with usage examples
- Better error messages for unsupported platforms

Testing:
- Add comprehensive compatibility test suite (12 tests)
- Add collision detection tests
- Organize tests in scripts/tests/ directory
- All tests pass on macOS (bash 3.2.57)

Documentation:
- Add Windows installation instructions to README
- Add platform compatibility guide
- Add COMPATIBILITY.md quick reference
- Update all test script references

Tested on:
- macOS 13+ (bash 3.2.57) ✓
- Linux (bash 4.0+) ✓
- Windows Git Bash (bash 4.4+) ✓

Closes issues with curl installation failing on macOS and Windows

2025-11-18 13:57:18 +00:00

3.1 KiB

Raw Blame History

GitHub Repository Settings Checklist

After merging this PR, update these GitHub repository settings:

1. About Section

Current: (needs update)

New Description:

AI agent framework for plan-first development workflows with approval-based execution. Multi-language support (TypeScript, Python, Go, Rust) with automatic testing, code review, and validation.

Website: https://github.com/darrenhinde/opencode-agents

2. Topics (Add All 16)

Go to: Settings → General → Topics

Must-Have Topics (10):

ai-agents
code-generation
developer-tools
llm
typescript
python
automation
testing
opencode
workflow

Nice-to-Have Topics (6):

prompt-engineering
go
rust
code-validation
context-aware
multi-language

Go to: Settings → General → Social Preview

Action: Upload a 1280x640px image showing:

Repository name
Tagline: "Plan-First AI Development Framework"
Key features icons (agents, testing, validation)
Your branding

Quick Option: Use Canva or similar to create from template

4. Features to Enable

Go to: Settings → General → Features

Enable:

✅ Wikis (for extended documentation)
✅ Issues (already enabled)
✅ Discussions (for community Q&A)
✅ Projects (for roadmap tracking)

5. Issue Labels

Go to: Issues → Labels

Add these labels:

good first issue (color: #7057ff) - For newcomers
help wanted (color: #008672) - Community contributions welcome
documentation (color: #0075ca) - Documentation improvements
enhancement (color: #a2eeef) - New features
bug (color: #d73a4a) - Something isn't working
question (color: #d876e3) - Further information requested

6. GitHub Discussions

Go to: Settings → General → Features → Discussions

Enable Discussions and create these categories:

💡 Ideas - Feature requests and suggestions
🙏 Q&A - Questions and answers
📣 Announcements - Updates and releases
💬 General - General discussion
🎨 Show and Tell - Share your workflows

7. Branch Protection (Optional but Recommended)

Go to: Settings → Branches → Add rule

For main branch:

✅ Require pull request reviews before merging
✅ Require status checks to pass before merging
✅ Require conversation resolution before merging

Verification Checklist

After completing the above:

About section updated with keyword-rich description
All 16 topics added
Social preview image uploaded
Discussions enabled
Issue labels created
At least 2-3 issues created with "good first issue" label
First discussion post created welcoming contributors

Quick Win Metrics

After these changes, you should see within 1 week:

📈 Improved GitHub search ranking for "AI agents", "code generation"
👀 Increased profile views from topic pages
⭐ More stars from improved discoverability
💬 Community engagement in Discussions

Estimated Time: 30-45 minutes total Expected Impact: 10x improvement in discoverability

3.1 KiB Raw Blame History