OpenWriterControle/install.sh
Darren Hinde c8f7103cb6
refactor(evals): consolidate documentation and enhance test infrastructure (#56)
* feat(agents): implement category-based agent organization system

- Organize agents into domain categories (core, development, content, data, product, learning)
- Move 10 agents to category subdirectories with proper git rename tracking
- Update 13 subagents with category and type metadata in frontmatter
- Add category metadata files (0-category.json) documenting common patterns
- Implement local registry fallback in install script for offline development
- Add comprehensive validation suite with 15 automated tests (100% pass rate)
- Enhance registry validation with duplicate ID and consistency checks
- Update eval framework with intelligent path resolution (backward compatible)
- Archive legacy eval structure to _archive/ for reference
- Update all documentation to reflect category-based structure
- Bump version to 0.5.0 with accurate CHANGELOG

Technical Details:
- 23 agents organized (10 category agents, 13 subagents)
- 6 category directories created
- Path resolution supports both agent IDs and category paths
- Registry schema updated to v2.0.0
- 159 files changed, 872 insertions(+), 10738 deletions(-)

BREAKING CHANGE: Agent file paths now use category structure. Update references from .opencode/agent/openagent.md to .opencode/agent/core/openagent.md. Eval framework maintains backward compatibility via path resolution.

* refactor(evals): consolidate documentation and enhance test infrastructure

- Remove temporary project tracking files (PHASE_5_COMPLETE, PROJECT_COMPLETE, etc.)
- Consolidate evaluation framework docs into main README
- Enhance test execution with improved logging and multi-prompt support
- Move system-builder from core to meta category
- Add comprehensive test suites for openagent with organized structure
- Create evaluation test structure for all subagents
- Clean up archived workflows and redundant documentation
- Update registry to reflect new agent organization
- Add shared test templates and golden test patterns

* feat(ci): add manual trigger support for bot-created PRs in validate-registry workflow

- Add pr_number input to workflow_dispatch for manually triggering validation
- Fetch PR details dynamically when triggered manually
- Support both automatic (PR event) and manual (workflow_dispatch) triggers
- Enable validation of bot-created PRs like automated version bumps
- Update branch detection and push logic to handle both trigger types
- Add documentation explaining how to manually trigger for bot PRs

* feat(evals): add explicit context file validation to test framework

- Add expectedContextFiles field to test YAML schema for explicit context file specification
- Enhance context-loading-evaluator to support both auto-detect and explicit validation modes
- Update documentation with comprehensive guide and examples
- Clean up archived legacy test structure (90+ old test files)
- Add new example tests demonstrating explicit context validation
- Backward compatible with existing tests

* feat(evals): add multi-agent logging system and performance optimizations

Implement comprehensive multi-agent logging and performance improvements for the eval framework.

Task 01: Multi-Agent Logging System
- Add complete hierarchical logging module (evals/framework/src/logging/)
  - SessionTracker: tracks parent-child delegation hierarchies
  - MultiAgentLogger: pretty-prints logs with visual indentation
  - Formatters: box characters and emoji formatting
  - 37 passing unit tests (session-tracker, logger, integration)
- Integrate with SDK event stream handler
  - Hook into session.created, message.updated, message.part.updated events
  - Real-time child session detection via timestamp heuristics
  - Message deduplication for cleaner output
- Enable in debug mode only (<1% performance overhead)
- Add demo script and comprehensive documentation

Task 02: Performance Optimizations
- Reduce grace period from 5s to 2s (67% reduction, 10-20% faster tests)
- Add PerformanceMetricsEvaluator for bottleneck identification
  - Collects tool latencies, inference time, idle time
  - Provides full performance visibility
- Update smoke test to validate delegation (core feature)
  - Replace simple read test with multi-agent delegation test
  - Tests both parent and child agent functionality
  - Validates multi-agent logging system

Results:
- 37 unit tests passing
- Smoke test passing (95/100 score)
- Clean hierarchical logging output
- 10-20% faster test execution
- Full multi-agent visibility

Files changed: 16 files, +2678 lines
Time saved: ~6-8 days (completed in 6 hours vs 3-5 day estimate)

* feat(evals): show child agent execution in non-debug mode

- Enable MultiAgentLogger in both debug and non-debug modes
- Add verbose parameter to control output level
- Non-verbose mode shows concise child session lifecycle:
  - Child agent started message
  - Child agent completed with duration
- Verbose mode (--debug) shows full delegation hierarchy
- Update documentation to reflect new behavior

This provides visibility into delegation without overwhelming output,
giving confidence that child agents are actually running.

* feat(evals): improve delegation testing and behavior validation

Major improvements to eval framework:

Test Suite:
- Add 00-smoke-test.yaml (basic read operation)
- Rename 01-smoke-test.yaml → 02-delegation-test.yaml (delegation test)
- Add simple-responder test agent for delegation testing
- Add debug test: simple-subagent-call.yaml

Evaluators:
- Add agent-model-evaluator.ts for agent/model validation
- Enhance behavior-evaluator.ts with detailed task tool output
- Improve delegation-evaluator.ts with better evidence tracking

Schema & Execution:
- Add expectedAgent and expectedModel to test schema
- Improve test executor with better logging and error handling

Documentation:
- Update evals/README.md with new features and performance improvements
- Remove outdated MULTI_AGENT_LOGGING_COMPLETE.md

Registry:
- Add simple-responder test agent to registry

Fixes:
- Fix dashboard.sh path resolution

These changes provide better visibility into delegation, improved test
coverage, and clearer validation of agent behavior.

* chore: add GitHub Actions workflow and plugin documentation

- Add .github/workflows/evals/run-evaluations.yml for automated eval testing
- Add dev/ai-tools/opencode/plugins/Plugin-inspiration.md for plugin development reference
2025-12-18 09:52:11 +00:00

1236 lines
42 KiB
Bash
Executable file
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

#!/usr/bin/env bash
#############################################################################
# OpenAgents Installer
# Interactive installer for OpenCode agents, commands, tools, and plugins
#
# Compatible with:
# - macOS (bash 3.2+)
# - Linux (bash 3.2+)
# - Windows (Git Bash, WSL)
#############################################################################
set -e
# Detect platform
PLATFORM="$(uname -s)"
case "$PLATFORM" in
Linux*) PLATFORM="Linux";;
Darwin*) PLATFORM="macOS";;
CYGWIN*|MINGW*|MSYS*) PLATFORM="Windows";;
*) PLATFORM="Unknown";;
esac
# Colors for output (disable on Windows if not supported)
if [ "$PLATFORM" = "Windows" ] && [ -z "$WT_SESSION" ] && [ -z "$ConEmuPID" ]; then
# Basic Windows terminal without color support
RED=''
GREEN=''
YELLOW=''
BLUE=''
MAGENTA=''
CYAN=''
BOLD=''
NC=''
else
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
BLUE='\033[0;34m'
MAGENTA='\033[0;35m'
CYAN='\033[0;36m'
BOLD='\033[1m'
NC='\033[0m' # No Color
fi
# Configuration
REPO_URL="https://github.com/darrenhinde/OpenAgents"
BRANCH="${OPENCODE_BRANCH:-main}" # Allow override via environment variable
RAW_URL="https://raw.githubusercontent.com/darrenhinde/OpenAgents/${BRANCH}"
# Registry URL - supports local fallback for development
# Priority: 1) REGISTRY_URL env var, 2) Local registry.json, 3) Remote GitHub
if [ -n "$REGISTRY_URL" ]; then
# Use explicitly set REGISTRY_URL (for testing)
:
elif [ -f "./registry.json" ]; then
# Use local registry.json if it exists (for development)
REGISTRY_URL="file://$(pwd)/registry.json"
else
# Default to remote GitHub registry
REGISTRY_URL="${RAW_URL}/registry.json"
fi
INSTALL_DIR="${OPENCODE_INSTALL_DIR:-.opencode}" # Allow override via environment variable
TEMP_DIR="/tmp/opencode-installer-$$"
# Cleanup temp directory on exit (success or failure)
trap 'rm -rf "$TEMP_DIR" 2>/dev/null || true' EXIT INT TERM
# Global variables
SELECTED_COMPONENTS=()
INSTALL_MODE=""
PROFILE=""
NON_INTERACTIVE=false
CUSTOM_INSTALL_DIR="" # Set via --install-dir argument
#############################################################################
# Utility Functions
#############################################################################
jq_exec() {
local output
output=$(jq -r "$@")
local ret=$?
printf "%s\n" "$output" | tr -d '\r'
return $ret
}
print_header() {
echo -e "${CYAN}${BOLD}"
echo "╔════════════════════════════════════════════════════════════════╗"
echo "║ ║"
echo "║ OpenAgents Installer v1.0.0 ║"
echo "║ ║"
echo "╚════════════════════════════════════════════════════════════════╝"
echo -e "${NC}"
}
print_success() {
echo -e "${GREEN}✓${NC} $1"
}
print_error() {
echo -e "${RED}✗${NC} $1"
}
print_info() {
echo -e "${BLUE}ℹ${NC} $1"
}
print_warning() {
echo -e "${YELLOW}⚠${NC} $1"
}
print_step() {
echo -e "\n${MAGENTA}${BOLD}▶${NC} $1\n"
}
#############################################################################
# Path Handling (Cross-Platform)
#############################################################################
normalize_and_validate_path() {
local input_path="$1"
local normalized_path
# Handle empty path
if [ -z "$input_path" ]; then
echo ""
return 1
fi
# Expand tilde to $HOME (works on Linux, macOS, Windows Git Bash)
if [[ $input_path == ~* ]]; then
normalized_path="${HOME}${input_path:1}"
else
normalized_path="$input_path"
fi
# Convert backslashes to forward slashes (Windows compatibility)
normalized_path="${normalized_path//\\//}"
# Remove trailing slashes
normalized_path="${normalized_path%/}"
# If path is relative, make it absolute based on current directory
if [[ ! "$normalized_path" = /* ]] && [[ ! "$normalized_path" =~ ^[A-Za-z]: ]]; then
normalized_path="$(pwd)/${normalized_path}"
fi
echo "$normalized_path"
return 0
}
validate_install_path() {
local path="$1"
local parent_dir
# Get parent directory
parent_dir="$(dirname "$path")"
# Check if parent directory exists
if [ ! -d "$parent_dir" ]; then
print_error "Parent directory does not exist: $parent_dir"
return 1
fi
# Check if parent directory is writable
if [ ! -w "$parent_dir" ]; then
print_error "No write permission for directory: $parent_dir"
return 1
fi
# If target directory exists, check if it's writable
if [ -d "$path" ] && [ ! -w "$path" ]; then
print_error "No write permission for directory: $path"
return 1
fi
return 0
}
get_global_install_path() {
# Return platform-appropriate global installation path
case "$PLATFORM" in
macOS)
# macOS: Use XDG standard (consistent with Linux)
echo "${HOME}/.config/opencode"
;;
Linux)
echo "${HOME}/.config/opencode"
;;
Windows)
# Windows Git Bash/WSL: Use same as Linux
echo "${HOME}/.config/opencode"
;;
*)
echo "${HOME}/.config/opencode"
;;
esac
}
#############################################################################
# Dependency Checks
#############################################################################
check_bash_version() {
# Check bash version (need 3.2+)
local bash_version="${BASH_VERSION%%.*}"
if [ "$bash_version" -lt 3 ]; then
echo "Error: This script requires Bash 3.2 or higher"
echo "Current version: $BASH_VERSION"
echo ""
echo "Please upgrade bash or use a different shell:"
echo " macOS: brew install bash"
echo " Linux: Use your package manager to update bash"
echo " Windows: Use Git Bash or WSL"
exit 1
fi
}
check_dependencies() {
print_step "Checking dependencies..."
local missing_deps=()
if ! command -v curl &> /dev/null; then
missing_deps+=("curl")
fi
if ! command -v jq &> /dev/null; then
missing_deps+=("jq")
fi
if [ ${#missing_deps[@]} -ne 0 ]; then
print_error "Missing required dependencies: ${missing_deps[*]}"
echo ""
echo "Please install them:"
case "$PLATFORM" in
macOS)
echo " brew install ${missing_deps[*]}"
;;
Linux)
echo " Ubuntu/Debian: sudo apt-get install ${missing_deps[*]}"
echo " Fedora/RHEL: sudo dnf install ${missing_deps[*]}"
echo " Arch: sudo pacman -S ${missing_deps[*]}"
;;
Windows)
echo " Git Bash: Install via https://git-scm.com/"
echo " WSL: sudo apt-get install ${missing_deps[*]}"
echo " Scoop: scoop install ${missing_deps[*]}"
;;
*)
echo " Use your package manager to install: ${missing_deps[*]}"
;;
esac
exit 1
fi
print_success "All dependencies found"
}
#############################################################################
# Registry Functions
#############################################################################
fetch_registry() {
print_step "Fetching component registry..."
mkdir -p "$TEMP_DIR"
# Handle local file:// URLs
if [[ "$REGISTRY_URL" == file://* ]]; then
local local_path="${REGISTRY_URL#file://}"
if [ -f "$local_path" ]; then
cp "$local_path" "$TEMP_DIR/registry.json"
print_success "Using local registry: $local_path"
else
print_error "Local registry not found: $local_path"
exit 1
fi
else
# Fetch from remote URL
if ! curl -fsSL "$REGISTRY_URL" -o "$TEMP_DIR/registry.json"; then
print_error "Failed to fetch registry from $REGISTRY_URL"
exit 1
fi
print_success "Registry fetched successfully"
fi
}
get_profile_components() {
local profile=$1
jq_exec ".profiles.${profile}.components[]" "$TEMP_DIR/registry.json"
}
get_component_info() {
local component_id=$1
local component_type=$2
jq_exec ".components.${component_type}[] | select(.id == \"${component_id}\")" "$TEMP_DIR/registry.json"
}
# Helper function to get the correct registry key for a component type
get_registry_key() {
local type=$1
# Most types are pluralized, but 'config' stays singular
case "$type" in
config) echo "config" ;;
*) echo "${type}s" ;;
esac
}
# Helper function to convert registry path to installation path
# Registry paths are like ".opencode/agent/foo.md"
# We need to replace ".opencode" with the actual INSTALL_DIR
get_install_path() {
local registry_path=$1
# Strip leading .opencode/ if present
local relative_path="${registry_path#.opencode/}"
# Return INSTALL_DIR + relative path
echo "${INSTALL_DIR}/${relative_path}"
}
resolve_dependencies() {
local component=$1
local type="${component%%:*}"
local id="${component##*:}"
# Get the correct registry key (handles singular/plural)
local registry_key=$(get_registry_key "$type")
# Get dependencies for this component
local deps=$(jq_exec ".components.${registry_key}[] | select(.id == \"${id}\") | .dependencies[]?" "$TEMP_DIR/registry.json" 2>/dev/null || echo "")
if [ -n "$deps" ]; then
for dep in $deps; do
# Add dependency if not already in list
if [[ ! " ${SELECTED_COMPONENTS[@]} " =~ " ${dep} " ]]; then
SELECTED_COMPONENTS+=("$dep")
# Recursively resolve dependencies
resolve_dependencies "$dep"
fi
done
fi
}
#############################################################################
# Installation Mode Selection
#############################################################################
check_interactive_mode() {
# Check if stdin is a terminal (not piped from curl)
if [ ! -t 0 ]; then
print_header
print_error "Interactive mode requires a terminal"
echo ""
echo "You're running this script in a pipe (e.g., curl | bash)"
echo "For interactive mode, download the script first:"
echo ""
echo -e "${CYAN}# Download the script${NC}"
echo "curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh -o install.sh"
echo ""
echo -e "${CYAN}# Run interactively${NC}"
echo "bash install.sh"
echo ""
echo "Or use a profile directly:"
echo ""
echo -e "${CYAN}# Quick install with profile${NC}"
echo "curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash -s essential"
echo ""
echo "Available profiles: essential, developer, business, full, advanced"
echo ""
cleanup_and_exit 1
fi
}
show_install_location_menu() {
check_interactive_mode
clear
print_header
local global_path=$(get_global_install_path)
echo -e "${BOLD}Choose installation location:${NC}\n"
echo -e " ${GREEN}1) Local${NC} - Install to ${CYAN}.opencode/${NC} in current directory"
echo " (Best for project-specific agents)"
echo ""
echo -e " ${BLUE}2) Global${NC} - Install to ${CYAN}${global_path}${NC}"
echo " (Best for user-wide agents available everywhere)"
echo ""
echo -e " ${MAGENTA}3) Custom${NC} - Enter exact path"
echo " Examples:"
case "$PLATFORM" in
Windows)
echo " ${CYAN}C:/Users/username/my-agents${NC} or ${CYAN}~/my-agents${NC}"
;;
*)
echo " ${CYAN}/home/username/my-agents${NC} or ${CYAN}~/my-agents${NC}"
;;
esac
echo ""
echo " 4) Back / Exit"
echo ""
read -p "Enter your choice [1-4]: " location_choice
case $location_choice in
1)
INSTALL_DIR=".opencode"
print_success "Installing to local directory: .opencode/"
sleep 1
;;
2)
INSTALL_DIR="$global_path"
print_success "Installing to global directory: $global_path"
sleep 1
;;
3)
echo ""
read -p "Enter installation path: " custom_path
if [ -z "$custom_path" ]; then
print_error "No path entered"
sleep 2
show_install_location_menu
return
fi
local normalized_path=$(normalize_and_validate_path "$custom_path")
if [ $? -ne 0 ]; then
print_error "Invalid path"
sleep 2
show_install_location_menu
return
fi
if ! validate_install_path "$normalized_path"; then
echo ""
read -p "Continue anyway? [y/N]: " continue_choice
if [[ ! $continue_choice =~ ^[Yy] ]]; then
show_install_location_menu
return
fi
fi
INSTALL_DIR="$normalized_path"
print_success "Installing to custom directory: $INSTALL_DIR"
sleep 1
;;
4)
cleanup_and_exit 0
;;
*)
print_error "Invalid choice"
sleep 2
show_install_location_menu
return
;;
esac
}
show_main_menu() {
check_interactive_mode
clear
print_header
echo -e "${BOLD}Choose installation mode:${NC}\n"
echo " 1) Quick Install (Choose a profile)"
echo " 2) Custom Install (Pick individual components)"
echo " 3) List Available Components"
echo " 4) Exit"
echo ""
read -p "Enter your choice [1-4]: " choice
case $choice in
1) INSTALL_MODE="profile" ;;
2) INSTALL_MODE="custom" ;;
3) list_components; show_main_menu ;;
4) cleanup_and_exit 0 ;;
*) print_error "Invalid choice"; sleep 2; show_main_menu ;;
esac
}
#############################################################################
# Profile Installation
#############################################################################
show_profile_menu() {
clear
print_header
echo -e "${BOLD}Available Installation Profiles:${NC}\n"
# Essential profile
local essential_name=$(jq_exec '.profiles.essential.name' "$TEMP_DIR/registry.json")
local essential_desc=$(jq_exec '.profiles.essential.description' "$TEMP_DIR/registry.json")
local essential_count=$(jq_exec '.profiles.essential.components | length' "$TEMP_DIR/registry.json")
echo -e " ${GREEN}1) ${essential_name}${NC}"
echo -e " ${essential_desc}"
echo -e " Components: ${essential_count}\n"
# Developer profile
local dev_desc=$(jq_exec '.profiles.developer.description' "$TEMP_DIR/registry.json")
local dev_count=$(jq_exec '.profiles.developer.components | length' "$TEMP_DIR/registry.json")
local dev_badge=$(jq_exec '.profiles.developer.badge // ""' "$TEMP_DIR/registry.json")
if [ -n "$dev_badge" ]; then
echo -e " ${BLUE}2) Developer ${GREEN}[${dev_badge}]${NC}"
else
echo -e " ${BLUE}2) Developer${NC}"
fi
echo -e " ${dev_desc}"
echo -e " Components: ${dev_count}\n"
# Business profile
local business_name=$(jq_exec '.profiles.business.name' "$TEMP_DIR/registry.json")
local business_desc=$(jq_exec '.profiles.business.description' "$TEMP_DIR/registry.json")
local business_count=$(jq_exec '.profiles.business.components | length' "$TEMP_DIR/registry.json")
echo -e " ${CYAN}3) ${business_name}${NC}"
echo -e " ${business_desc}"
echo -e " Components: ${business_count}\n"
# Full profile
local full_name=$(jq_exec '.profiles.full.name' "$TEMP_DIR/registry.json")
local full_desc=$(jq_exec '.profiles.full.description' "$TEMP_DIR/registry.json")
local full_count=$(jq_exec '.profiles.full.components | length' "$TEMP_DIR/registry.json")
echo -e " ${MAGENTA}4) ${full_name}${NC}"
echo -e " ${full_desc}"
echo -e " Components: ${full_count}\n"
# Advanced profile
local adv_name=$(jq_exec '.profiles.advanced.name' "$TEMP_DIR/registry.json")
local adv_desc=$(jq_exec '.profiles.advanced.description' "$TEMP_DIR/registry.json")
local adv_count=$(jq_exec '.profiles.advanced.components | length' "$TEMP_DIR/registry.json")
echo -e " ${YELLOW}5) ${adv_name}${NC}"
echo -e " ${adv_desc}"
echo -e " Components: ${adv_count}\n"
echo " 6) Back to main menu"
echo ""
read -p "Enter your choice [1-6]: " choice
case $choice in
1) PROFILE="essential" ;;
2) PROFILE="developer" ;;
3) PROFILE="business" ;;
4) PROFILE="full" ;;
5) PROFILE="advanced" ;;
6) show_main_menu; return ;;
*) print_error "Invalid choice"; sleep 2; show_profile_menu; return ;;
esac
# Load profile components (compatible with bash 3.2+)
SELECTED_COMPONENTS=()
local temp_file="$TEMP_DIR/components.tmp"
get_profile_components "$PROFILE" > "$temp_file"
while IFS= read -r component; do
[ -n "$component" ] && SELECTED_COMPONENTS+=("$component")
done < "$temp_file"
show_installation_preview
}
#############################################################################
# Custom Component Selection
#############################################################################
show_custom_menu() {
clear
print_header
echo -e "${BOLD}Select component categories to install:${NC}\n"
echo "Use space to toggle, Enter to continue"
echo ""
local categories=("agents" "subagents" "commands" "tools" "plugins" "contexts" "config")
local selected_categories=()
# Simple selection (for now, we'll make it interactive later)
echo "Available categories:"
for i in "${!categories[@]}"; do
local cat="${categories[$i]}"
local count=$(jq_exec ".components.${cat} | length" "$TEMP_DIR/registry.json")
local cat_display=$(echo "$cat" | awk '{print toupper(substr($0,1,1)) tolower(substr($0,2))}')
echo " $((i+1))) ${cat_display} (${count} available)"
done
echo " $((${#categories[@]}+1))) Select All"
echo " $((${#categories[@]}+2))) Continue to component selection"
echo " $((${#categories[@]}+3))) Back to main menu"
echo ""
read -p "Enter category numbers (space-separated) or option: " -a selections
for sel in "${selections[@]}"; do
if [ "$sel" -eq $((${#categories[@]}+1)) ]; then
selected_categories=("${categories[@]}")
break
elif [ "$sel" -eq $((${#categories[@]}+2)) ]; then
break
elif [ "$sel" -eq $((${#categories[@]}+3)) ]; then
show_main_menu
return
elif [ "$sel" -ge 1 ] && [ "$sel" -le ${#categories[@]} ]; then
selected_categories+=("${categories[$((sel-1))]}")
fi
done
if [ ${#selected_categories[@]} -eq 0 ]; then
print_warning "No categories selected"
sleep 2
show_custom_menu
return
fi
show_component_selection "${selected_categories[@]}"
}
show_component_selection() {
local categories=("$@")
clear
print_header
echo -e "${BOLD}Select components to install:${NC}\n"
local all_components=()
local component_details=()
for category in "${categories[@]}"; do
local cat_display=$(echo "$category" | awk '{print toupper(substr($0,1,1)) tolower(substr($0,2))}')
echo -e "${CYAN}${BOLD}${cat_display}:${NC}"
local components=$(jq_exec ".components.${category}[] | .id" "$TEMP_DIR/registry.json")
local idx=1
while IFS= read -r comp_id; do
local comp_name=$(jq_exec ".components.${category}[] | select(.id == \"${comp_id}\") | .name" "$TEMP_DIR/registry.json")
local comp_desc=$(jq_exec ".components.${category}[] | select(.id == \"${comp_id}\") | .description" "$TEMP_DIR/registry.json")
echo " ${idx}) ${comp_name}"
echo " ${comp_desc}"
all_components+=("${category}:${comp_id}")
component_details+=("${comp_name}|${comp_desc}")
idx=$((idx+1))
done <<< "$components"
echo ""
done
echo "Enter component numbers (space-separated), 'all' for all, or 'done' to continue:"
read -a selections
for sel in "${selections[@]}"; do
if [ "$sel" = "all" ]; then
SELECTED_COMPONENTS=("${all_components[@]}")
break
elif [ "$sel" = "done" ]; then
break
elif [ "$sel" -ge 1 ] && [ "$sel" -le ${#all_components[@]} ]; then
SELECTED_COMPONENTS+=("${all_components[$((sel-1))]}")
fi
done
if [ ${#SELECTED_COMPONENTS[@]} -eq 0 ]; then
print_warning "No components selected"
sleep 2
show_custom_menu
return
fi
# Resolve dependencies
print_step "Resolving dependencies..."
local original_count=${#SELECTED_COMPONENTS[@]}
for comp in "${SELECTED_COMPONENTS[@]}"; do
resolve_dependencies "$comp"
done
if [ ${#SELECTED_COMPONENTS[@]} -gt $original_count ]; then
print_info "Added $((${#SELECTED_COMPONENTS[@]} - original_count)) dependencies"
fi
show_installation_preview
}
#############################################################################
# Installation Preview & Confirmation
#############################################################################
show_installation_preview() {
# Only clear screen in interactive mode
if [ "$NON_INTERACTIVE" != true ]; then
clear
fi
print_header
echo -e "${BOLD}Installation Preview${NC}\n"
if [ -n "$PROFILE" ]; then
echo -e "Profile: ${GREEN}${PROFILE}${NC}"
else
echo -e "Mode: ${GREEN}Custom${NC}"
fi
echo -e "Installation directory: ${CYAN}${INSTALL_DIR}${NC}"
echo -e "\nComponents to install (${#SELECTED_COMPONENTS[@]} total):\n"
# Group by type
local agents=()
local subagents=()
local commands=()
local tools=()
local plugins=()
local contexts=()
local configs=()
for comp in "${SELECTED_COMPONENTS[@]}"; do
local type="${comp%%:*}"
case $type in
agent) agents+=("$comp") ;;
subagent) subagents+=("$comp") ;;
command) commands+=("$comp") ;;
tool) tools+=("$comp") ;;
plugin) plugins+=("$comp") ;;
context) contexts+=("$comp") ;;
config) configs+=("$comp") ;;
esac
done
[ ${#agents[@]} -gt 0 ] && echo -e "${CYAN}Agents (${#agents[@]}):${NC} ${agents[*]##*:}"
[ ${#subagents[@]} -gt 0 ] && echo -e "${CYAN}Subagents (${#subagents[@]}):${NC} ${subagents[*]##*:}"
[ ${#commands[@]} -gt 0 ] && echo -e "${CYAN}Commands (${#commands[@]}):${NC} ${commands[*]##*:}"
[ ${#tools[@]} -gt 0 ] && echo -e "${CYAN}Tools (${#tools[@]}):${NC} ${tools[*]##*:}"
[ ${#plugins[@]} -gt 0 ] && echo -e "${CYAN}Plugins (${#plugins[@]}):${NC} ${plugins[*]##*:}"
[ ${#contexts[@]} -gt 0 ] && echo -e "${CYAN}Contexts (${#contexts[@]}):${NC} ${contexts[*]##*:}"
[ ${#configs[@]} -gt 0 ] && echo -e "${CYAN}Config (${#configs[@]}):${NC} ${configs[*]##*:}"
echo ""
# Skip confirmation if profile was provided via command line
if [ "$NON_INTERACTIVE" = true ]; then
print_info "Installing automatically (profile specified)..."
perform_installation
else
read -p "Proceed with installation? [Y/n]: " confirm
if [[ $confirm =~ ^[Nn] ]]; then
print_info "Installation cancelled"
cleanup_and_exit 0
fi
perform_installation
fi
}
#############################################################################
# Collision Detection
#############################################################################
show_collision_report() {
local collision_count=$1
shift
local collisions=("$@")
echo ""
print_warning "Found ${collision_count} file collision(s):"
echo ""
# Group by type
local agents=()
local subagents=()
local commands=()
local tools=()
local plugins=()
local contexts=()
local configs=()
for file in "${collisions[@]}"; do
# Skip empty entries
[ -z "$file" ] && continue
if [[ $file == *"/agent/subagents/"* ]]; then
subagents+=("$file")
elif [[ $file == *"/agent/"* ]]; then
agents+=("$file")
elif [[ $file == *"/command/"* ]]; then
commands+=("$file")
elif [[ $file == *"/tool/"* ]]; then
tools+=("$file")
elif [[ $file == *"/plugin/"* ]]; then
plugins+=("$file")
elif [[ $file == *"/context/"* ]]; then
contexts+=("$file")
else
configs+=("$file")
fi
done
# Display grouped collisions
[ ${#agents[@]} -gt 0 ] && echo -e "${YELLOW} Agents (${#agents[@]}):${NC}" && printf ' %s\n' "${agents[@]}"
[ ${#subagents[@]} -gt 0 ] && echo -e "${YELLOW} Subagents (${#subagents[@]}):${NC}" && printf ' %s\n' "${subagents[@]}"
[ ${#commands[@]} -gt 0 ] && echo -e "${YELLOW} Commands (${#commands[@]}):${NC}" && printf ' %s\n' "${commands[@]}"
[ ${#tools[@]} -gt 0 ] && echo -e "${YELLOW} Tools (${#tools[@]}):${NC}" && printf ' %s\n' "${tools[@]}"
[ ${#plugins[@]} -gt 0 ] && echo -e "${YELLOW} Plugins (${#plugins[@]}):${NC}" && printf ' %s\n' "${plugins[@]}"
[ ${#contexts[@]} -gt 0 ] && echo -e "${YELLOW} Context (${#contexts[@]}):${NC}" && printf ' %s\n' "${contexts[@]}"
[ ${#configs[@]} -gt 0 ] && echo -e "${YELLOW} Config (${#configs[@]}):${NC}" && printf ' %s\n' "${configs[@]}"
echo ""
}
get_install_strategy() {
echo -e "${BOLD}How would you like to proceed?${NC}\n" >&2
echo " 1) ${GREEN}Skip existing${NC} - Only install new files, keep all existing files unchanged" >&2
echo " 2) ${YELLOW}Overwrite all${NC} - Replace existing files with new versions (your changes will be lost)" >&2
echo " 3) ${CYAN}Backup & overwrite${NC} - Backup existing files, then install new versions" >&2
echo " 4) ${RED}Cancel${NC} - Exit without making changes" >&2
echo "" >&2
read -p "Enter your choice [1-4]: " strategy_choice
case $strategy_choice in
1) echo "skip" ;;
2)
echo "" >&2
print_warning "This will overwrite existing files. Your changes will be lost!"
read -p "Are you sure? Type 'yes' to confirm: " confirm
if [ "$confirm" = "yes" ]; then
echo "overwrite"
else
echo "cancel"
fi
;;
3) echo "backup" ;;
4) echo "cancel" ;;
*) echo "cancel" ;;
esac
}
#############################################################################
# Installation
#############################################################################
perform_installation() {
print_step "Preparing installation..."
# Create base directory only - subdirectories created on-demand when files are installed
mkdir -p "$INSTALL_DIR"
# Check for collisions
local collisions=()
for comp in "${SELECTED_COMPONENTS[@]}"; do
local type="${comp%%:*}"
local id="${comp##*:}"
local registry_key=$(get_registry_key "$type")
local path=$(jq_exec ".components.${registry_key}[] | select(.id == \"${id}\") | .path" "$TEMP_DIR/registry.json")
if [ -n "$path" ] && [ "$path" != "null" ]; then
local install_path=$(get_install_path "$path")
if [ -f "$install_path" ]; then
collisions+=("$install_path")
fi
fi
done
# Determine installation strategy
local install_strategy="fresh"
if [ ${#collisions[@]} -gt 0 ]; then
show_collision_report ${#collisions[@]} "${collisions[@]}"
install_strategy=$(get_install_strategy)
if [ "$install_strategy" = "cancel" ]; then
print_info "Installation cancelled by user"
cleanup_and_exit 0
fi
# Handle backup strategy
if [ "$install_strategy" = "backup" ]; then
local backup_dir="${INSTALL_DIR}.backup.$(date +%Y%m%d-%H%M%S)"
print_step "Creating backup..."
# Only backup files that will be overwritten
local backup_count=0
for file in "${collisions[@]}"; do
if [ -f "$file" ]; then
local backup_file="${backup_dir}/${file}"
mkdir -p "$(dirname "$backup_file")"
if cp "$file" "$backup_file" 2>/dev/null; then
backup_count=$((backup_count + 1))
else
print_warning "Failed to backup: $file"
fi
fi
done
if [ $backup_count -gt 0 ]; then
print_success "Backed up ${backup_count} file(s) to $backup_dir"
install_strategy="overwrite" # Now we can overwrite
else
print_error "Backup failed. Installation cancelled."
cleanup_and_exit 1
fi
fi
fi
# Perform installation
print_step "Installing components..."
local installed=0
local skipped=0
local failed=0
for comp in "${SELECTED_COMPONENTS[@]}"; do
local type="${comp%%:*}"
local id="${comp##*:}"
# Get the correct registry key (handles singular/plural)
local registry_key=$(get_registry_key "$type")
# Get component path
local path=$(jq_exec ".components.${registry_key}[] | select(.id == \"${id}\") | .path" "$TEMP_DIR/registry.json")
if [ -z "$path" ] || [ "$path" = "null" ]; then
print_warning "Could not find path for ${comp}"
failed=$((failed + 1))
continue
fi
# Convert registry path to installation path
local dest=$(get_install_path "$path")
# Check if file exists before we install (for proper messaging)
local file_existed=false
if [ -f "$dest" ]; then
file_existed=true
fi
# Check if file exists and we're in skip mode
if [ "$file_existed" = true ] && [ "$install_strategy" = "skip" ]; then
print_info "Skipped existing: ${type}:${id}"
skipped=$((skipped + 1))
continue
fi
# Download component
local url="${RAW_URL}/${path}"
# Create parent directory if needed
mkdir -p "$(dirname "$dest")"
if curl -fsSL "$url" -o "$dest"; then
# Transform paths for global installation (any non-local path)
# Local paths: .opencode or */.opencode
if [[ "$INSTALL_DIR" != ".opencode" ]] && [[ "$INSTALL_DIR" != *"/.opencode" ]]; then
# Expand tilde and get absolute path for transformation
local expanded_path="${INSTALL_DIR/#\~/$HOME}"
# Transform @.opencode/context/ references to actual install path
sed -i.bak -e "s|@\.opencode/context/|@${expanded_path}/context/|g" \
-e "s|\.opencode/context|${expanded_path}/context|g" "$dest" 2>/dev/null || true
rm -f "${dest}.bak" 2>/dev/null || true
fi
# Show appropriate message based on whether file existed before
if [ "$file_existed" = true ]; then
print_success "Updated ${type}: ${id}"
else
print_success "Installed ${type}: ${id}"
fi
installed=$((installed + 1))
else
print_error "Failed to install ${type}: ${id}"
failed=$((failed + 1))
fi
done
# Handle additional paths for advanced profile
if [ "$PROFILE" = "advanced" ]; then
local additional_paths=$(jq_exec '.profiles.advanced.additionalPaths[]?' "$TEMP_DIR/registry.json")
if [ -n "$additional_paths" ]; then
print_step "Installing additional paths..."
while IFS= read -r path; do
# For directories, we'd need to recursively download
# For now, just note them
print_info "Additional path: $path (manual download required)"
done <<< "$additional_paths"
fi
fi
echo ""
print_success "Installation complete!"
echo -e " Installed: ${GREEN}${installed}${NC}"
[ $skipped -gt 0 ] && echo -e " Skipped: ${CYAN}${skipped}${NC}"
[ $failed -gt 0 ] && echo -e " Failed: ${RED}${failed}${NC}"
show_post_install
}
#############################################################################
# Post-Installation
#############################################################################
show_post_install() {
echo ""
print_step "Next Steps"
echo "1. Review the installed components in ${CYAN}${INSTALL_DIR}/${NC}"
# Check if env.example was installed
if [ -f "${INSTALL_DIR}/env.example" ] || [ -f "env.example" ]; then
echo "2. Copy env.example to .env and configure:"
echo " ${CYAN}cp env.example .env${NC}"
echo "3. Start using OpenCode agents:"
else
echo "2. Start using OpenCode agents:"
fi
echo " ${CYAN}opencode${NC}"
echo ""
# Show installation location info
print_info "Installation directory: ${CYAN}${INSTALL_DIR}${NC}"
if [ -d "${INSTALL_DIR}.backup."* ] 2>/dev/null; then
print_info "Backup created - you can restore files from ${INSTALL_DIR}.backup.* if needed"
fi
print_info "Documentation: ${REPO_URL}"
echo ""
cleanup_and_exit 0
}
#############################################################################
# Component Listing
#############################################################################
list_components() {
clear
print_header
echo -e "${BOLD}Available Components${NC}\n"
local categories=("agents" "subagents" "commands" "tools" "plugins" "contexts")
for category in "${categories[@]}"; do
local cat_display=$(echo "$category" | awk '{print toupper(substr($0,1,1)) tolower(substr($0,2))}')
echo -e "${CYAN}${BOLD}${cat_display}:${NC}"
local components=$(jq_exec ".components.${category}[] | \"\(.id)|\(.name)|\(.description)\"" "$TEMP_DIR/registry.json")
while IFS='|' read -r id name desc; do
echo -e " ${GREEN}${name}${NC} (${id})"
echo -e " ${desc}"
done <<< "$components"
echo ""
done
read -p "Press Enter to continue..."
}
#############################################################################
# Cleanup
#############################################################################
cleanup_and_exit() {
rm -rf "$TEMP_DIR"
exit "$1"
}
trap 'cleanup_and_exit 1' INT TERM
#############################################################################
# Main
#############################################################################
main() {
# Parse command line arguments
while [ $# -gt 0 ]; do
case "$1" in
--install-dir=*)
CUSTOM_INSTALL_DIR="${1#*=}"
# Basic validation - check not empty
if [ -z "$CUSTOM_INSTALL_DIR" ]; then
echo "Error: --install-dir requires a non-empty path"
exit 1
fi
shift
;;
--install-dir)
if [ -n "$2" ] && [ "${2:0:1}" != "-" ]; then
CUSTOM_INSTALL_DIR="$2"
shift 2
else
echo "Error: --install-dir requires a path argument"
exit 1
fi
;;
essential|--essential)
INSTALL_MODE="profile"
PROFILE="essential"
NON_INTERACTIVE=true
shift
;;
developer|--developer)
INSTALL_MODE="profile"
PROFILE="developer"
NON_INTERACTIVE=true
shift
;;
business|--business)
INSTALL_MODE="profile"
PROFILE="business"
NON_INTERACTIVE=true
shift
;;
full|--full)
INSTALL_MODE="profile"
PROFILE="full"
NON_INTERACTIVE=true
shift
;;
advanced|--advanced)
INSTALL_MODE="profile"
PROFILE="advanced"
NON_INTERACTIVE=true
shift
;;
list|--list)
check_dependencies
fetch_registry
list_components
cleanup_and_exit 0
;;
--help|-h|help)
print_header
echo "Usage: $0 [PROFILE] [OPTIONS]"
echo ""
echo -e "${BOLD}Profiles:${NC}"
echo " essential, --essential Minimal setup with core agents"
echo " developer, --developer Code-focused development tools"
echo " business, --business Content and business-focused tools"
echo " full, --full Everything except system-builder"
echo " advanced, --advanced Complete system with all components"
echo ""
echo -e "${BOLD}Options:${NC}"
echo " --install-dir PATH Custom installation directory"
echo " (default: .opencode)"
echo " list, --list List all available components"
echo " help, --help, -h Show this help message"
echo ""
echo -e "${BOLD}Environment Variables:${NC}"
echo " OPENCODE_INSTALL_DIR Installation directory"
echo " OPENCODE_BRANCH Git branch to install from (default: main)"
echo ""
echo -e "${BOLD}Examples:${NC}"
echo ""
echo " ${CYAN}# Interactive mode (choose location and components)${NC}"
echo " $0"
echo ""
echo " ${CYAN}# Quick install with default location (.opencode/)${NC}"
echo " $0 developer"
echo ""
echo " ${CYAN}# Install to global location (Linux/macOS)${NC}"
echo " $0 developer --install-dir ~/.config/opencode"
echo ""
echo " ${CYAN}# Install to global location (Windows Git Bash)${NC}"
echo " $0 developer --install-dir ~/.config/opencode"
echo ""
echo " ${CYAN}# Install to custom location${NC}"
echo " $0 essential --install-dir ~/my-agents"
echo ""
echo " ${CYAN}# Using environment variable${NC}"
echo " export OPENCODE_INSTALL_DIR=~/.config/opencode"
echo " $0 developer"
echo ""
echo " ${CYAN}# Install from URL (non-interactive)${NC}"
echo " curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash -s developer"
echo ""
echo -e "${BOLD}Platform Support:${NC}"
echo " ✓ Linux (bash 3.2+)"
echo " ✓ macOS (bash 3.2+)"
echo " ✓ Windows (Git Bash, WSL)"
echo ""
exit 0
;;
*)
echo "Unknown option: $1"
echo "Run '$0 --help' for usage information"
exit 1
;;
esac
done
# Apply custom install directory if specified (CLI arg overrides env var)
if [ -n "$CUSTOM_INSTALL_DIR" ]; then
local normalized_path=$(normalize_and_validate_path "$CUSTOM_INSTALL_DIR")
if [ $? -eq 0 ]; then
INSTALL_DIR="$normalized_path"
if ! validate_install_path "$INSTALL_DIR"; then
print_warning "Installation path may have issues, but continuing..."
fi
else
print_error "Invalid installation directory: $CUSTOM_INSTALL_DIR"
exit 1
fi
fi
check_bash_version
check_dependencies
fetch_registry
if [ -n "$PROFILE" ]; then
# Non-interactive mode (compatible with bash 3.2+)
SELECTED_COMPONENTS=()
local temp_file="$TEMP_DIR/components.tmp"
get_profile_components "$PROFILE" > "$temp_file"
while IFS= read -r component; do
[ -n "$component" ] && SELECTED_COMPONENTS+=("$component")
done < "$temp_file"
show_installation_preview
else
# Interactive mode - show location menu first
show_install_location_menu
show_main_menu
if [ "$INSTALL_MODE" = "profile" ]; then
show_profile_menu
elif [ "$INSTALL_MODE" = "custom" ]; then
show_custom_menu
fi
fi
}
main "$@"