⚡ StringRay AI

Enterprise AI Orchestration Framework for OpenCode/Claude Code

Intelligent Multi-Agent Coordination with 99.6% Systematic Error Prevention

StringRay extends OpenCode/Claude Code with intelligent multi-agent orchestration, Codex compliance validation, and enterprise-grade security. It automatically routes tasks to specialized agents based on complexity and provides systematic error prevention.

What is StringRay?

StringRay is a one-command level-up for OpenCode. Instead of installing OpenCode first, then adding StringRay, just run:

npx strray-ai install

This single command:

1. Detects if OpenCode is installed
2. Auto-installs OpenCode if missing
3. Layers on the full StringRay kernel (Codex, orchestrator, enforcer, processors, MCP, reflections)
4. Installs 30 framework skills
5. Sets up the skills registry with 10 curated community sources
6. Adds CLI commands for agent publishing, skills management, and status

Goal: Any developer can run one command and instantly get a production-grade, governed agent runtime.

Who is it for?

• Developers using OpenCode or Claude Code who want AI-assisted development
• Teams needing consistent code quality and error prevention
• Enterprises requiring security, compliance, and audit capabilities

🚀 Quick Start

# Install StringRay (auto-configures OpenCode on install)
npm install strray-ai

# That's it! StringRay is now active.
# Restart OpenCode/Claude Code to load the plugin.

What happens during install?

• Copies OpenCode configuration files to your project
• Configures 13 agents with proper capabilities
• Sets up Codex enforcement rules
• Enables webhook triggers for CI/CD integration
• Ready to use with Claude Code immediately

✨ Features

• 🤖 13 Specialized Agents - Autonomous agents that read/write code, run commands, and enforce compliance
• 📏 99.6% Error Prevention - Universal Development Codex (60 terms)
• ⚡ 43 Framework Skills + 10 curated community sources (170+ additional skills available)
• 🛡️ Enterprise Security - Comprehensive validation and scanning
• 📦 Skills Registry - Browse and install community skills from GitHub repos
• 🔄 Complexity-Based Routing - Intelligent task delegation
• 🔌 Webhook Integration - GitHub, GitLab, Bitbucket, Stripe
• ✅ 2368 Tests - Production-ready with comprehensive test coverage

🤖 Available Agents

Note: StringRay auto-configures all agents during installation. To customize agent settings, see the Agent Configuration Guide.

View all 13 agents →

📦 OpenClaw Integration

StringRay integrates with OpenClaw - a self-hosted AI gateway that connects messaging platforms (WhatsApp, Telegram, Discord, Slack) to AI coding agents.

What It Does

• WebSocket Connection: Connect to OpenClaw Gateway at ws://127.0.0.1:18789
• Skill Invocation: OpenClaw skills invoke StringRay agents via HTTP API (port 18431)
• Tool Events: Forward tool.before/tool.after events to OpenClaw for real-time tracking
• Offline Buffering: Events queued when disconnected, sent on reconnect

Quick Setup

# Configure in .opencode/openclaw/config.json
{
  "gatewayUrl": "ws://127.0.0.1:18789",
  "authToken": "your-device-token",
  "deviceId": "your-device-id",
  "apiServer": { "enabled": true, "port": 18431 },
  "hooks": { "enabled": true, "toolBefore": true, "toolAfter": true }
}

# Initialize in code
import { initializeOpenClawIntegration } from 'strray-ai';
const integration = await initializeOpenClawIntegration();

See OpenClaw Integration Guide for details.

📖 Documentation

🔧 CLI Tools

StringRay provides CLI utilities for managing and monitoring your installation:

# Core commands
npx strray-ai status              # Check configuration and plugin status
npx strray-ai validate            # Validate installation and dependencies
npx strray-ai capabilities       # Show all available features
npx strray-ai health             # Run health check on framework components
npx strray-ai report             # Generate usage and performance reports

# Agent management
npx strray-ai publish-agent --agent orchestrator  # Package agent for AgentStore

# Skills management
npx strray-ai skill:install              # Show starter packs + available sources
npx strray-ai skill:install agency-agents  # Install from registry (auto-detects format)
npx strray-ai skill:install <github-url>  # Install from any repo
npx strray-ai skill:registry list      # Show all registry sources
npx strray-ai antigravity status       # Show installed skills with licenses

Note: Installation is automatic via npm install strray-ai. The postinstall hook configures everything automatically.

⚙️ Configuration

Default Configuration

StringRay works out of the box with sensible defaults. The npm postinstall hook automatically sets up:

.opencode/
├── agents/         # 24+ agent configurations
├── skills/         # Framework skills
├── strray/
│   ├── codex.json      # Codex rules
│   ├── features.json   # Feature flags
│   └── config.json    # Token/memory management
└── hooks/          # Pre/post processing hooks

Customizing Agents

Edit .opencode/agents/ to customize agent behavior:

# Example: Customize enforcer agent
name: enforcer
maxComplexity: 40  # Only handle simple tasks
temperature: 0.2   # More precise responses
enabled: true

Feature Flags

Edit .opencode/strray/features.json to enable/disable features:

{
  "codexEnforcement": true,
  "agentGovernance": true,
  "analytics": true,
  "webhooks": true
}

Token Management

Edit .opencode/strray/config.json to adjust token limits:

{
  "token_management": {
    "maxPromptTokens": 20000,
    "warningThreshold": 15000
  }
}

See Configuration Reference for full options.

Version Pinning

StringRay supports pinning versions for reproducible installations:

{
  "version_pinning": {
    "strray_ai": "^1.15.0",
    "opencode": "^2.14.0",
    "skills": {
      "antigravity": "latest",
      "impeccable": "latest",
      "openviking": "latest",
      "claude_seo": "latest"
    }
  }
}

Add to .opencode/strray/features.json to pin specific versions.

📁 Project Structure

stringray/
├── src/
│   ├── __tests__/              # Test suites (unit, integration, performance)
│   ├── agents/                 # Agent implementations
│   ├── analytics/              # Pattern analysis & learning
│   ├── cli/                    # CLI commands
│   ├── circuit-breaker/        # Resilience patterns
│   ├── core/                   # Core framework
│   ├── delegation/             # Task routing & delegation
│   ├── enforcement/            # Codex enforcement
│   ├── infrastructure/         # IaC validation
│   ├── integrations/           # External integrations
│   │   ├── base/              # BaseIntegration framework
│   │   └── openclaw/          # OpenClaw integration
│   ├── mcps/                  # MCP server implementations
│   ├── monitoring/            # System monitoring
│   ├── orchestrator/          # Multi-agent orchestration
│   ├── performance/           # Performance optimization
│   ├── plugins/              # Plugin system
│   ├── postprocessor/         # Post-processing pipeline
│   ├── reporting/             # Report generation
│   ├── security/              # Security systems
│   ├── session/               # Session management
│   ├── test-utils/            # Test utilities and helpers
│   ├── validation/            # Agent config & estimation validators
│   └── jobs/                  # Background job management
├── .opencode/                 # OpenCode configuration
│   ├── agents/               # Agent configs (13 agents)
│   ├── strray/               # StringRay config
│   │   ├── codex.json        # 60-term development codex
│   │   ├── features.json     # Feature flags
│   │   └── config.json       # Token management
│   └── hooks/                # Git hooks
├── skills/                    # StringRay skills
├── docs/                      # Documentation
│   ├── reflections/          # Deep technical reflections
│   └── research/             # Research documents
└── scripts/                   # Build & utility scripts

💬 Usage

# Code quality enforcement
@enforcer analyze this code for issues

# Complex task orchestration  
@orchestrator implement user authentication system

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

# Security audit
@security-auditor scan for vulnerabilities

🔌 Framework Integration

StringRay integrates with your existing infrastructure via webhooks and APIs:

# CLI tool for integration
npx strray-integration --help

// Programmatic integration
import { StringRayIntegration } from 'strray-ai/integration';

const postProcessor = new PostProcessor(stateManager);
const integration = new StringRayIntegration(postProcessor);

// Express
app.use('/webhooks', integration.getWebhookApp());
app.use('/api/post-process', integration.getAPIApp());

// Fastify
fastify.register(integration.getWebhookRouter(), { prefix: '/webhooks' });
fastify.register(integration.getAPIRouter(), { prefix: '/api/post-process' });

Supported Webhooks:

• GitHub (push, PR, issues)
• GitLab (push, merge requests)
• Bitbucket (push, pull requests)
• Stripe (subscriptions, payments)

🎯 Skills

StringRay ships with 30 framework skills and provides a registry of 10 curated community sources with 170+ additional skills.

Skills Registry

Browse and install skills from verified GitHub repositories:

# Show starter packs and available sources
npx strray-ai skill:install

# Install a specific source
npx strray-ai skill:install agency-agents
npx strray-ai skill:install superpowers
npx strray-ai skill:install anthropic-skills

# Install from any GitHub repo (auto-detects format)
npx strray-ai skill:install https://github.com/user/skills-repo

# Manage the registry
npx strray-ai skill:registry list              # Show all sources
npx strray-ai skill:registry add --name X --url Y --desc "..." --license MIT
npx strray-ai skill:registry remove --name X

Starter Packs

Registry Sources

Impeccable - AI Frontend Design

Impeccable is a design language skill that teaches AI coding assistants professional frontend design:

/audit           # Find issues
/critique       # UX design review
/polish          # Pre-ship refinement
/typeset         # Fix typography
/arrange         # Fix layout & spacing

Framework Skills (30 Built-in)

StringRay includes 30 core skills for orchestration, compliance, architecture, and more — installed to .opencode/skills/ automatically.

License Information

All community skill sources are properly licensed. License files are in licenses/skills/:

🙏 Support & Star

If StringRay helps you build better software, please consider:

• ⭐ Starring the repo on GitHub
• 📢 Sharing with your team
• 🐛 Reporting issues at github.com/htafolla/stringray/issues

📄 License

MIT License - see LICENSE for details.

Built with precision for enterprise-grade AI orchestration