⚡ StringRay AI

Enterprise AI Orchestration Framework

Limitless Intelligence. Zero Compromises. Enterprise Scale Since Day One.

StringRay AI provides intelligent multi-agent coordination with 99.6% systematic error prevention. Eliminate spaghetti code, hallucinations, and code rot through systematic validation and intelligent agent delegation.

🚀 Quick Start

# Install
npm install strray-ai

# Run postinstall setup
npx strray-ai install

# Validate installation
npx strray-ai validate

# Check status
npx strray-ai status

✨ Features

• 🤖 14 Specialized Agents: Intelligent task orchestration with automatic delegation
• 📏 99.6% Error Prevention: Systematic validation through Universal Development Codex (59 terms)
• ⚡ 26 Lazy-Loading Skills: On-demand MCP server activation (14 MCP servers)
• 🛡️ Enterprise Security: Comprehensive validation and security scanning
• 📊 Real-time Monitoring: Performance tracking and health monitoring
• 🔄 Complexity-Based Routing: Tasks routed based on file count, dependencies, and risk level

CLI Commands

npx strray-ai install     # Install and configure StringRay
npx strray-ai status       # Check framework configuration
npx strray-ai validate    # Validate installation
npx strray-ai capabilities # Show all available capabilities
npx strray-ai health      # Health check

🤖 Available Agents

Agent Pipeline Flow

Routing Logic: Tasks are routed based on complexity analysis (file count, change volume, dependencies, risk level). Score ≤25 = Single-agent; 96+ = Orchestrator-led multi-agent.

📦 Installation & Setup

Prerequisites

• Node.js 18+ / Bun (recommended)
• OpenCode installed & running

Setup

# Install package
npm install strray-ai

# Run postinstall setup (required)
npx strray-ai install

# Validate
npx strray-ai validate

Usage

Once installed, StringRay agents are available via @ commands:

# Intelligent task orchestration
@orchestrator implement user authentication system

# Code quality enforcement
@enforcer analyze this code for issues

# System design assistance
@architect design database schema for e-commerce

# Testing strategy
@test-architect create test plan for payment module

📚 Documentation

For comprehensive documentation including architecture details, API references, and troubleshooting guides, visit the docs directory.

Key Documentation

• Plugin Deployment Guide - Complete setup guide
• API Reference - Developer API documentation
• Agent Documentation - Detailed agent specifications
• Architecture - Framework design

⚙️ Configuration

Create .opencode/strray/features.json in your project root:

{
  "version": "1.4.16",
  "description": "StringRay Framework Configuration",

  "token_optimization": {
    "enabled": true,
    "max_context_tokens": 50000,
    "prune_after_task": true,
    "summarize_tool_outputs": true,
    "context_compression": {
      "enabled": true,
      "threshold_tokens": 40000,
      "compression_ratio": 0.5
    }
  },

  "model_routing": {
    "enabled": true,
    "default_model": "claude-sonnet-4",
    "fallback_model": "claude-haiku-4"
  },

  "multi_agent_orchestration": {
    "enabled": true,
    "max_concurrent_agents": 3,
    "coordination_model": "async-multi-agent",
    "task_distribution_strategy": "capability-based",
    "conflict_resolution": "expert-priority",
    "progress_tracking": true,
    "session_persistence": true
  },

  "agent_management": {
    "disabled_agents": [],
    "performance_limits": {
      "max_task_duration_ms": 30000,
      "max_memory_usage_mb": 512,
      "max_tokens_per_request": 16000
    }
  },

  "activity_logging": {
    "enabled": true,
    "level": "info",
    "include_performance_metrics": true,
    "include_agent_states": true,
    "include_token_usage": true,
    "retention_days": 7,
    "log_to_file": true,
    "log_path": ".opencode/logs"
  },

  "security": {
    "enabled": true,
    "prompt_sanitization": true,
    "vulnerability_scanning": true,
    "code_review_enforcement": true,
    "security_score_threshold": 70
  },

  "performance_monitoring": {
    "enabled": true,
    "real_time_metrics": true,
    "benchmark_tracking": true,
    "token_tracking": true,
    "cost_tracking": true,
    "alerting": {
      "enabled": true,
      "performance_degradation_threshold": 20,
      "error_rate_threshold": 5,
      "cost_threshold_daily": 10.0
    }
  },

  "caching": {
    "enabled": true,
    "file_content_cache": true,
    "search_result_cache": true,
    "cache_ttl_seconds": 300,
    "max_cache_size_mb": 50
  }
}

Configuration Parameters

Core Settings

Token Optimization

Model Routing

Multi-Agent Orchestration

Agent Management

Activity Logging

Security

Performance Monitoring

Caching

Environment Variables

# Logging & Debugging
export STRRAY_LOGGING_ENABLED=false        # Disable all logging
export STRRAY_LOG_LEVEL=debug              # Log level: debug/info/warn/error
export STRRAY_PERFORMANCE_MODE=true        # Enable performance mode logging
export STRRAY_DEBUG_LOGGING=true           # Debug logging for components

# Path Overrides (Advanced)
export STRRAY_AGENTS_PATH="../custom/agents"
export STRRAY_MCP_PATH="../custom/mcp"
export STRRAY_STATE_PATH="../custom/state"

# Enterprise & Clustering
export STRRAY_INSTANCE_ID="production-1"   # Instance identification
export STRRAY_CLUSTER_NAME="prod-cluster"  # Cluster name
export STRRAY_TEST_MODE=true               # Enable test mode

📊 Performance Metrics

• Error Prevention: 99.6% systematic validation
• Test Pass Rate: 100% (989/989 tests)
• Resource Reduction: 90%+ with lazy-loading architecture
• Response Time: Sub-millisecond task delegation

👤 Creator

StringRay AI was created by @blaze0x1

💬 Support

• Telegram: StringRay AI Support
• GitHub Issues: Report bugs or request features
• Documentation: Full docs

📄 License

MIT License - see LICENSE file for details.

⚡ StringRay: Enterprise AI orchestration for systematic error prevention ⚡

Built on the Universal Development Codex with Skills-Based Lazy Loading Architecture