SynapseXcoder V6 - Multi-Agent OpenCode Plugin + TUI Integration

╔══════════════════════════════════════════════════════════════════════════════╗
║                    🦆 SynapseXcoder AI System — Synapse V6                  ║
║             Multi-Agent OpenCode Plugin + TUI Integration Edition          ║
╚══════════════════════════════════════════════════════════════════════════════╝

Overview

SynapseXcoder V6 transforms the monolithic single-agent architecture into a distributed multi-agent system powered by OpenCode CLI. A master orchestration agent leads 13+ specialized sub-agents, each responsible for a specific phase of the processing pipeline. The entire system is packaged as an OpenCode plugin with full TUI integration.

Key Features

• Multi-Agent Architecture: Master agent orchestrates specialized sub-agents
• OpenCode CLI Integration: Native tool calling for file operations, bash, web, and MCP
• Phase-Based Processing: Dedicated agents for Planning, Analysis, Review, Rewrite, UI Design
• CLI Command Suite: Unified command interface for all operations
• Inter-Agent Communication: Message bus for agent coordination
• Flexible Configuration: YAML-based config with per-agent settings
• Team Collaboration: Multi-user sessions, shared repositories, and activity tracking
• Plugin System: Extensible architecture for custom agents, commands, and tools
• Token Optimization: Intelligent context compression and MVI pattern learning
• CLI Distribution: Package and distribute agents/commands as standalone CLI tools

Architecture

┌─────────────────────────────────────────────────────────────────────────────┐
│                           SYNAPSEXCODER V6 SYSTEM                             │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                             │
│  ┌─────────────────────────────────────────────────────────────────────┐   │
│  │                      🦆 MASTER AGENT (Orchestrator)                  │   │
│  │   • Receives user input                                              │   │
│  │   • Creates execution plan                                           │   │
│  │   • Spawns/manages sub-agents                                        │   │
│  │   • Synthesizes final output                                         │   │
│  └──────────────────────────┬──────────────────────────────────────────┘   │
│                              │                                              │
│              ┌───────────────┼───────────────┐                             │
│              ▼               ▼               ▼                             │
│  ┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐         │
│  │  🗺️ PLANNER      │ │ 🔍 ANALYZER      │ │ 🔵 REVIEWER       │         │
│  │  - Task outline   │ │ - Syntax check   │ │ - Explain fixes   │         │
│  │  - Dependencies   │ │ - Logic scan     │ │ - Justify changes │         │
│  └──────────────────┘ └──────────────────┘ └──────────────────┘         │
│              │               │               │                             │
│              ▼               ▼               ▼                             │
│  ┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐         │
│  │ 🟣 REWRITER      │ │ 🎨 UI DESIGNER   │ │ 🌐 RESEARCHER    │         │
│  │  - Apply fixes   │ │  - Mockup gen    │ │  - Web search    │         │
│  │  - Optimize code │ │  - Design insp   │ │  - Fact verify   │         │
│  └──────────────────┘ └──────────────────┘ └──────────────────┘         │
│                                                                             │
│  ┌─────────────────────────────────────────────────────────────────────┐   │
│  │                    OPENCODE CLI INTEGRATION LAYER                   │   │
│  └─────────────────────────────────────────────────────────────────────┘   │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘

Installation

Automated Installation (Recommended)

Run the automated installer which handles everything:

# Clone the repository
git clone <repository-url>
cd SynapseXcoder/Synapse/v5

# Run the installer (handles Node.js, npm, OpenCode, build, and global CLI setup)
./install.sh

The installer will:

• Check for Node.js 20+ and npm
• Install OpenCode CLI if missing
• Install npm dependencies and build TypeScript
• Register synapse as a global CLI command
• Copy OpenCode agent configurations
• Create default configuration files

Manual Installation

If you prefer manual setup:

# Install dependencies
npm install

# Build the project
npm run build

# Register CLI globally
npm link

# Copy OpenCode agents (run from project root)
mkdir -p ~/.config/opencode/agents
cp opencode-agents/*.md ~/.config/opencode/agents/
cp opencode/opencode.json ~/.config/opencode/

# Create config directory
mkdir -p ~/.synapsexcoder
# (config.yaml will be created on first run)

CLI Registration

The package.json includes a bin field that registers the synapse command:

{
  "bin": {
    "synapse": "dist/cli/index.js"
  }
}

After installation, synapse will be available globally in your terminal.

Quick Start

# Process a file with full pipeline
synapse process ./src/main.py

# Analyze without modifications
synapse analyze ./src/main.py

# List available agents
synapse agent list

# Check OpenCode tools
synapse opencode tools

# Merge files
synapse merge file1.py file2.py

CLI Commands

Core Commands

| Command | Description | | ----------------------- | ----------------------------------- | | synapse process <input> | Process input with full pipeline | | synapse analyze <input> | Analyze input without modifications | | synapse merge <inputs> | Merge multiple inputs | | synapse rewrite <input> | Rewrite with fixes |

Agent Commands

| Command | Description | | -------------------------- | --------------------- | | synapse agent list | List available agents | | synapse agent spawn <type> | Spawn a new agent | | synapse agent status | Show agent status | | synapse agent kill <id> | Terminate an agent |

OpenCode Commands

| Command | Description | | ---------------------- | -------------------- | | synapse opencode run | Run OpenCode command | | synapse opencode serve | Start server mode | | synapse opencode tools | List available tools |

Context Commands

| Command | Description | | --------------------------- | -------------------- | | synapse context save <name> | Save current context | | synapse context load <name> | Load saved context | | synapse context show | Show current context |

Team Commands

| Command | Description | | --------------------------- | ---------------------------- | | synapse team session <name> | Create collaboration session | | synapse team join <id> | Join existing session | | synapse team list | List active sessions |

Plugin Commands

| Command | Description | | --------------------------- | ---------------------- | | synapse plugin list | List installed plugins | | synapse plugin enable <id> | Enable a plugin | | synapse plugin disable <id> | Disable a plugin |

Distribution Commands

| Command | Description | | ---------------------------- | --------------------------- | | synapse package create | Create distribution package | | synapse package publish | Publish package to registry | | synapse package install <id> | Install a package |

Processing Modes

| Mode | Description | | ----------------- | ------------------------------------------- | | full_pipeline | Complete merge → analyze → review → rewrite | | merge_only | Combine inputs without analysis | | analyze_only | Analysis without modifications | | security_scan | Focused security analysis | | debug_assistant | Debugging assistance | | ui_design | Mockup and design generation | | team_collab | Multi-user collaboration session | | plugin_dev | Plugin development and testing |

Project Structure

v6/
├── agents/              # Agent implementations
│   └── agent-core.ts  # Master and sub-agent classes
├── cli/                 # CLI implementation
│   └── index.ts        # Command definitions
├── messages/            # Inter-agent communication
│   └── message-bus.ts  # Message bus implementation
├── opencode/           # OpenCode integration
│   └── tool-bridge.ts  # Tool calling bridge
├── opencode-agents/    # OpenCode agent configs
│   ├── synapse-master.md
│   ├── synapse-planner.md
│   ├── synapse-analyzer.md
│   ├── synapse-reviewer.md
│   ├── synapse-rewriter.md
│   ├── synapse-ui-designer.md
│   └── synapse-researcher.md
├── src/
│   ├── types/          # TypeScript types
│   │   └── index.ts    # All shared types
│   ├── commands/       # Workflow commands
│   │   └── command-processor.ts
│   ├── context/        # Context system
│   │   └── context-system.ts
│   ├── distribution/  # CLI distribution
│   │   └── cli-distribution.ts
│   ├── optimization/  # Token optimization
│   │   └── token-optimizer.ts
│   ├── plugins/        # Plugin system
│   │   └── plugin-system.ts
│   ├── team/           # Team collaboration
│   │   └── team-collaboration.ts
│   ├── thoughts/      # Knowledge management
│   │   └── thoughts-manager.ts
│   └── cli/            # CLI source
├── package.json
├── tsconfig.json
└── README.md

Configuration

Configuration is stored in ~/.synapsexcoder/config.yaml:

version: "6.0.0"

opencode:
  mode: embedded
  serverUrl: "http://localhost:4096"

agents:
  master:
    model: anthropic/claude-opus-4-6
    temperature: 0.2

  planner:
    model: anthropic/claude-haiku-4-20250514

  analyzer:
    model: anthropic/claude-sonnet-4-20250514

plugins:
  enabled: true
  directory: "./plugins"

team:
  enabled: true
  defaultSession: "main"

tokenOptimization:
  enabled: true
  maxContextSize: 8000
  compressionThreshold: 1000

OpenCode Agent Configuration

Agents are defined as Markdown files in ~/.config/opencode/agents/:

---
description: Agent description
mode: subagent
temperature: 0.1
permission:
  edit: deny
  bash: deny
  webfetch: allow
color: "#FFA500"
---
Agent prompt goes here...

Note: Synapse agent files intentionally omit a hardcoded model field so each agent inherits the user-selected model from the active prompt/session.

Development

# Run tests
npm test

# Lint code
npm run lint

# Lint agent permissions/frontmatter
npm run lint:agents

# Format code
npm run format

# Type check
npx tsc --noEmit

Roadmap

• [x] Phase 1: Core Foundation ✓
• [x] Phase 2: Agent Framework ✓
• [x] Phase 3: CLI & Commands ✓
• [x] Phase 4: OpenCode Agent Configs ✓
• [ ] Phase 5: Testing & Polish
• [x] Phase 6: Team Collaboration & Plugins ✓
• [x] Phase 7: Token Optimization & CLI Distribution ✓

License

MIT

Built with 🦆 by DuckyOnQuack-999