1a0f458e1a
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 |
||
|---|---|---|
| .. | ||
| contributing | ||
| features | ||
| getting-started | ||
| github | ||
| README.md | ||
OpenCode Agents Documentation
Welcome to the OpenCode Agents documentation! This directory contains all documentation organized by topic.
📚 Documentation Index
Getting Started
- Installation Guide - Complete installation guide with collision handling
- Collision Handling - Quick reference for install script collision strategies
Features
- System Builder - Build complete AI systems tailored to your domain
- Quick Start - Get started with the system builder
- Complete Guide - Detailed documentation and examples
- Agent System Blueprint - Architecture patterns and how to extend the system
Contributing
- Contributing Guide - How to contribute to the project
- Code of Conduct - Community guidelines
GitHub
- GitHub Settings - Repository settings checklist
🚀 Quick Links
For New Users
- Start with the main README in the repository root
- Follow the Installation Guide
- Use
opencode --agent codebase-agentto start building
For Contributors
- Read the Contributing Guide
- Review the Code of Conduct
- Check out good first issues
For Advanced Users
- Study the Agent System Blueprint
- Try the System Builder
- Create custom agents and commands
📖 Documentation Structure
docs/
├── README.md # This file
├── getting-started/
│ ├── installation.md # Installation guide
│ └── collision-handling.md # Collision handling reference
├── features/
│ ├── system-builder/
│ │ ├── README.md # System builder quick start
│ │ └── guide.md # System builder complete guide
│ └── agent-system-blueprint.md # Architecture patterns
├── contributing/
│ ├── CODE_OF_CONDUCT.md # Community guidelines
│ └── CONTRIBUTING.md # Contribution guide
└── github/
└── GITHUB_SETTINGS.md # Repository settings
🔍 Finding What You Need
I want to...
...install OpenCode Agents → Installation Guide
...understand collision handling → Collision Handling
...build a custom AI system → System Builder
...understand the architecture → Agent System Blueprint
...contribute to the project → Contributing Guide
...report a bug or request a feature → GitHub Issues
💡 Additional Resources
- Main README: ../README.md
- GitHub Repository: https://github.com/darrenhinde/opencode-agents
- OpenCode CLI Docs: https://opencode.ai/docs
- Component Registry: ../registry.json
🤝 Community
- Issues: Report bugs or request features
- Discussions: Ask questions and share ideas
- Pull Requests: Contribute code
📝 License
This project is licensed under the MIT License. See LICENSE for details.
Need help? Check the Contributing Guide or open an issue.