Commit graph

119 commits

Author SHA1 Message Date
darrenhinde
8b75f128d3 docs: update to recommend OpenAgent as default with enhanced workflow diagrams
- Position OpenAgent as recommended default for new users
- Add detailed stage diagrams for all 6 workflow stages
- Replace bright purple colors with softer slate blue for better accessibility
- Update all documentation to show OpenAgent as universal coordinator
- Keep codebase-agent as specialized development alternative
2025-11-18 23:15:44 +00:00
darrenhinde
3249900d63 Update installation documentation with custom directory support and bash 5.x fix
- Rewrite installation.md as comprehensive installation guide
  - Add custom installation directory documentation (--install-dir, OPENCODE_INSTALL_DIR)
  - Document interactive location selection (Local/Global/Custom)
  - Add platform-specific installation examples
  - Include all installation methods and profiles
  - Add troubleshooting and advanced usage sections

- Update platform-compatibility.md with bash 5.x fix details
  - Add Ubuntu 24.04 (bash 5.2.21) to tested configurations
  - Document set -e compatibility fix
  - Add troubleshooting section for bash 5.x issues
  - Update cross-platform features list

Documentation now synced with installer v1.1.0 features
2025-11-18 23:13:00 +00:00
darrenhinde
3c972fb828 Fix critical bash 5.x compatibility and add custom install directory support
- Fix set -e bug: Change ((variable++)) to variable=$((variable + 1)) to prevent script exit on bash 5.2.21 (Ubuntu 24.04)
- Fix collision handling UX: Display menu options correctly by redirecting to stderr
- Add custom installation directory support with --install-dir flag and OPENCODE_INSTALL_DIR env var
- Add interactive location selection menu (Local/Global/Custom)
- Implement cross-platform path handling (Linux/macOS/Windows) with tilde expansion, backslash conversion, and validation
- Enhance help documentation with comprehensive examples and platform support information

Fixes installation failures on modern Linux systems and enables flexible installation to any directory including ~/.config/opencode
2025-11-18 23:08:30 +00:00
darrenhinde
ca323285b2 Rename to OpenAgents, remove model specs, and update documentation
Major Changes:
- Rename repository from opencode-agents to OpenAgents
- Remove all hardcoded model specifications (now model-agnostic)
- Fix documentation: profile names, component counts, add Business profile
- Add future plans note for other AI coding tools

Repository Rename:
- Update all URLs to github.com/darrenhinde/OpenAgents
- Update git remote, README, install scripts, documentation
- 15 files updated with new repository name

Model-Agnostic Framework:
- Remove model specifications from 6 agent files
- Framework now works with any AI provider (Claude, GPT, Gemini, local models)
- Users control model selection via OpenCode CLI settings

Documentation Fixes:
- Correct profile name: Core → Essential
- Add missing Business profile documentation
- Fix component counts: Developer (19), Advanced (32)
- Document all 5 profiles with accurate descriptions

Future Plans:
- Add note about support for other AI tools (Cursor, Claude Code, etc.)
- Clear focus on stabilizing OpenCode integration first

This makes OpenAgents a truly universal, model-agnostic framework
accessible to all users regardless of their AI provider preference.
2025-11-18 22:37:41 +00:00
darrenhinde
5f2cec1404 ✨ feat: introduce OpenAgent universal agent with session management
Major architectural refactoring:

- Add OpenAgent as universal primary agent for questions, tasks, and workflows
- Implement session-based context management with manifest tracking
- Reorganize subagents into logical categories (code/core/utils)
- Add dynamic context discovery and loading system
- Introduce cleanup script for stale sessions
- Update registry with new categorization (essential/standard/extended/specialized/meta)
- Rename 'core' profile to 'essential' and add 'business' profile
- Add comprehensive documentation with visual diagrams
- Update installation script with new profiles

Breaking changes:
- Subagent paths changed from analysis/core to code/core/utils
- Profile 'core' renamed to 'essential' (backward compatible)

New features:
- Session isolation for concurrent agent instances (.tmp/sessions/)
- Automatic stale session cleanup (>24 hours)
- Manifest-based context indexing and discovery
- Business profile for content-focused workflows
- OpenAgent with plan-approve-execute-validate-summarize workflow

Components: 32 total (3 agents, 13 subagents, 8 commands, 2 tools, 2 plugins, 2 contexts, 2 config)

Documentation:
- docs/agents/openagent.md - Comprehensive guide with Mermaid diagrams
- docs/guides/building-with-opencode.md - Power user formula
- scripts/README.md - Script documentation
- .opencode/context/core/context-management.md - Session management strategy
2025-11-18 18:45:42 +00:00
darrenhinde
dfea8199a9 fix: don't clear screen in non-interactive mode
Problem:
- When running 'curl ... | bash -s core' the screen would clear
- This made it appear like nothing was happening after preview
- Users couldn't see the installation progress

Solution:
- Only call 'clear' in interactive mode
- Skip clear when NON_INTERACTIVE=true
- Allows users to see full output when piped from curl

Now users can see:
- Dependency checks
- Registry fetch
- Installation preview
- 'Installing automatically' message
- Full installation progress
- Completion message

This makes the installation process transparent and debuggable.
2025-11-18 14:26:59 +00:00
darrenhinde
532e17ce01 fix: auto-install when profile specified via command line
Problem:
- Running 'curl ... | bash -s core' showed preview and waited for input
- User had to press Y to proceed even though profile was specified
- Defeats the purpose of one-command installation

Solution:
- Add NON_INTERACTIVE flag to track command-line profile usage
- Set NON_INTERACTIVE=true when profile argument provided
- Skip confirmation prompt when NON_INTERACTIVE=true
- Show 'Installing automatically (profile specified)...' message

Behavior:
Before:
  curl ... | bash -s core
  → Shows preview, waits for Y/n input

After:
  curl ... | bash -s core
  → Shows preview, installs automatically

Interactive mode still works:
  bash install.sh
  → Shows menu, asks for confirmation (as expected)

This makes profile-based installation truly one-command with no interaction needed.
2025-11-18 14:24:27 +00:00
darrenhinde
a9f119e83e refactor: streamline profiles and fix registry pluralization
Profile Changes:
- Reduce core profile from 15 to 9 components (true essentials only)
- Keep developer at 22 components (add back image-specialist + gemini)
- Remove unused subagents from core (reviewer, build-agent)
- Remove non-essential commands from core (test, context, prompt-enhancer)

Core Profile (9 components):
- Agents: task-manager, codebase-agent
- Subagents: tester, documentation, coder-agent
- Commands: commit
- Context: essential-patterns, project-context
- Config: env-example

Developer Profile (22 components):
- Everything in core plus quality tools and AI features
- Added: image-specialist, gemini tool
- Added: reviewer, build-agent, codebase-pattern-analyst
- Added: test, context, clean, optimize, prompt-enhancer commands

Bug Fixes:
- Fix jq error: 'Cannot iterate over null' for config components
- Add get_registry_key() helper to handle singular 'config' vs plural types
- Update all jq queries to use correct registry keys

Codebase Agent:
- Remove @image-specialist reference (not needed for core coding)
- Update subagent list to match actual usage
- Now lists: @task-manager, @tester, @documentation, @coder-agent

Documentation:
- Update README with correct component counts
- Update profile descriptions to be more accurate
- Clarify what each profile is best for

This makes 'core' truly minimal and 'developer' the recommended choice.
2025-11-18 14:18:59 +00:00
darrenhinde
515a83dce2 fix: detect piped execution and provide clear guidance
Problem:
- Running 'curl ... | bash' without arguments showed interactive menu
- But stdin was the curl stream, not terminal
- Script couldn't read user input and would exit silently
- Confusing user experience

Solution:
- Add check_interactive_mode() to detect if stdin is a terminal
- If running in pipe without arguments, show helpful error message
- Provide clear instructions for both interactive and profile-based install
- Update README to clarify installation methods

Changes:
- Add [ ! -t 0 ] check to detect non-terminal stdin
- Show helpful error with examples when piped without profile
- Update README to recommend profile-based install (fastest)
- Clarify that interactive mode requires downloading first

User Experience:
Before: Silent exit or confusing behavior
After: Clear error message with exact commands to run

Examples shown to user:
- Download first: curl ... -o install.sh && bash install.sh
- Or use profile: curl ... | bash -s core

This fixes the issue reported when running on another computer.
2025-11-18 14:04:15 +00:00
github-actions[bot]
aef73202a6 chore: auto-update component registry [skip ci] 2025-11-18 14:00:59 +00:00
darrenhinde
e524ba6ded feat: add system builder and reorganize project structure
New Features:
- Add system-builder agent for generating custom AI systems
- Add 5 new subagents for system building:
  - domain-analyzer: Analyzes domains and recommends architectures
  - agent-generator: Generates XML-optimized agent files
  - context-organizer: Organizes modular context files
  - workflow-designer: Designs workflow definitions
  - command-creator: Creates custom slash commands
- Add build-context-system command for interactive system generation
- Add system builder templates and guide

Project Reorganization:
- Move GITHUB_SETTINGS.md to docs/github/
- Move AGENT-SYSTEM-BLUEPRINT.md to docs/features/
- Move CODE_OF_CONDUCT.md to docs/contributing/
- Move CONTRIBUTING.md to docs/contributing/
- Consolidate documentation in docs/ directory

Registry Updates:
- Add system-builder agent to registry
- Add 5 new subagents to registry
- Add build-context-system command to registry
- Update advanced profile to include system builder components

This enables users to generate complete custom AI systems tailored to their domain through an interactive interview process.
2025-11-18 14:00:35 +00:00
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
darrenhinde
9d482c9fbf docs: center and improve README header layout 2025-11-17 23:46:42 +00:00
darrenhinde
30cc71e4e1 docs: add Buy Me a Coffee badge to README 2025-11-17 23:45:48 +00:00
darrenhinde
6d472c32c7 docs: remove comparison section from README 2025-11-17 23:45:20 +00:00
darrenhinde
7d75353d5a feat: add GitHub discovery optimizations
Community & Discovery Improvements:
- Add CODE_OF_CONDUCT.md (Contributor Covenant 2.0)
- Add badges to README (stars, license, last commit, PRs welcome)
- Add comparison section (vs Copilot, Cursor, Aider)
- Improve tagline with SEO keywords
- Add issue templates (bug report, feature request, good first issue)
- Add GitHub settings checklist for post-merge configuration

SEO & Discoverability:
- Keyword-rich description for search ranking
- Clear differentiation from alternatives
- Professional presentation with badges
- Community-friendly templates

Next Steps (After Merge):
- Update About section with new description
- Add 16 topics for search optimization
- Enable GitHub Discussions
- Create social preview image
- Add issue labels

Estimated Impact: 10x improvement in GitHub discoverability
2025-11-17 23:43:13 +00:00
darrenhinde
e382efaa22 refactor: update installation profiles based on user feedback
Changes to profiles:
- Core: Added prompt-enhancer, removed tools (truly minimal now)
- Developer: Removed plugins, kept AI tools (env, gemini) for image generation
- Full: Only profile with plugins (Telegram notifications)
- Advanced: Removed plugins, only adds planning/architecture docs

Other changes:
- Added note in README about differences from demo video
- Emphasized making repo easier for others to use
- Verified image-specialist dependencies are properly included

Profile sizes:
- Core: 15 components (minimal essentials)
- Developer: 22 components (recommended for daily use)
- Full: 25 components (everything including plugins)
- Advanced: 23 components + docs (for contributors)
2025-11-17 23:43:13 +00:00
darrenhinde
3ab70d24a9 fix: simplify registration script to preserve manual registry
- Replace complex auto-scanning with simple validation script
- Prevents registry from being emptied by buggy scan functions
- Auto-scanning feature can be added later after more testing
- Registry now stays intact and works correctly
2025-11-17 23:43:13 +00:00
darrenhinde
357dabcfec fix: restore registry.json content and add bash 3.2 compatibility
- Recreate registry.json with all component definitions
- Fix bash 3.2 compatibility (replace ${var^} with awk)
- Registry was accidentally emptied by registration script
2025-11-17 23:43:13 +00:00
darrenhinde
7a2d17ca3a feat: add OPENCODE_BRANCH env var for testing different branches 2025-11-17 23:43:13 +00:00
darrenhinde
777b3fc702 feat: add interactive installer with component registry system
- Add component registry (registry.json) with 4 installation profiles
- Create interactive installer (install.sh) with profile and custom selection
- Add auto-registration script for CI/CD integration
- Create validation script for component structure
- Add update script for keeping components current
- Include GitHub Actions workflow for auto-registry updates
- Update README with installation instructions
- Add CONTRIBUTING guide for new components

Features:
- Interactive CLI with colored output and menus
- Smart dependency resolution
- Backup existing installations
- Profile-based installation (core, developer, full, advanced)
- Custom component selection
- Component validation and testing tools
2025-11-17 23:43:13 +00:00
Darren Hinde
bd6aec49c6
Update README.md 2025-11-17 11:42:40 +00:00
darrenhinde
80e1a8d650 ✨ feat: make agent system language-agnostic with multi-language support
- Make codebase-agent work with TypeScript, Python, Go, Rust, and more
- Add clear runtime/type-check/lint command examples for each language
- Update build-agent to support all languages (tsc, mypy, go build, cargo check)
- Make essential-patterns universal by removing language-specific code examples
- Update README to mention multi-language support
- Remove auto-detection overhead - agents naturally adapt based on project files
2025-11-17 00:16:18 +00:00
darrenhinde
1e11d6b7a0 🐛 fix: correct typo in commit command instructions 2025-11-16 23:49:42 +00:00
darrenhinde
36a9ecff47 📝 docs: add clear explanation of what the Blueprint is at the top 2025-11-16 23:47:45 +00:00
darrenhinde
d7720fb7b4 📝 docs: simplify BLUEPRINT by removing code examples and recommending /prompt-enchancer 2025-11-16 23:46:52 +00:00
darrenhinde
88b3445f10 📝 docs: improve documentation for new users with video, TL;DR, and clearer guidance 2025-11-16 23:41:55 +00:00
Darren Hinde
93b9bbc1a6
Update README.md 2025-10-29 23:26:02 +00:00
Darren Hinde
48e1c1c486
Update README.md 2025-10-29 23:24:08 +00:00
Darren Hinde
b152f4a6a3
Update AGENT-SYSTEM-BLUEPRINT.md 2025-10-29 23:23:27 +00:00
Darren Hinde
7a1da6016f
Update README.md 2025-10-29 23:17:58 +00:00
Darren Hinde
1f024058af
Update README.md 2025-10-29 23:15:27 +00:00
darrenhinde
32cda54be3 enchance prompter 2025-10-14 14:44:52 +02:00
darrenhinde
1f9268506d 🗑️ chore: remove AGENTS.md and README.md files to streamline documentation and eliminate redundancy 2025-10-01 21:13:29 +02:00
Darren Hinde
834c3a83ee
Merge pull request #8 from darrenhinde/agent-prompts-update
Agent prompts update - Gemini Tool
2025-09-24 15:36:09 +01:00
darrenhinde
cac7ee6b03 📝 docs: update codebase-agent.md to include @image-specialist subagent and remove GEMINI_API_KEY requirement from image-specialist.md 2025-09-24 15:35:32 +01:00
darrenhinde
318cfab250 📝 docs: add instruction for requesting images from the image specialist in codebase-agent.md 2025-09-23 19:54:53 +01:00
Darren Hinde
ab44698fa0
Update README.md 2025-09-23 17:27:52 +01:00
darrenhinde
e073c5bb2e 🗑️ chore: remove deprecated Gemini tool files and update package configuration for improved structure 2025-09-23 13:31:36 +01:00
darrenhinde
25e6e919be ✨ feat: add Gemini API key configuration to env.example for integration 2025-09-21 17:34:31 +01:00
darrenhinde
dd204b5a2b update to agent,md 2025-09-18 19:40:36 +01:00
darrenhinde
b4927fc1b0 🔧 chore: update agent documentation and enhance prompt architecture with structured XML methodology 2025-09-18 16:02:28 +01:00
darrenhinde
2ca29f0e6f 📝 docs: clarify git push instruction in commit command 2025-08-29 17:58:57 +01:00
darrenhinde
7da13837e7 📝 docs: clarify automatic commit behavior in commit command 2025-08-29 17:58:04 +01:00
darrenhinde
9ba7d0239a 📝 docs: simplify commit command workflow and clean up worktrees metadata 2025-08-29 17:56:55 +01:00
darrenhinde
a585e72439 🔧 chore: update agent models and enhance command specifications 2025-08-29 17:51:53 +01:00
darrenhinde
885247baca 📝 docs: enhance command documentation with detailed guidelines 2025-08-29 13:55:42 +01:00
darrenhinde
6ed2c6ff9a Update subtask naming pattern in codebase-agent.md for consistency 2025-08-29 00:22:06 +01:00
darrenhinde
412d5141c3 Remove unused files and clean up project structure by deleting .gitignore, bun.lock, index.html, package.json, main.js, and style.css. Update .gitignore to include only necessary entries for environment variables and build outputs. 2025-08-26 01:03:18 +01:00
Darren Hinde
6b15d0a32e
Merge pull request #7 from darrenhinde/workflow-test
PR agent Owner
2025-08-26 01:02:02 +01:00