Overview • Features • Tech Stack • Architecture • Quick Start • MYND Ecosystem • Deployment
MYND Synchron is the cross-application context synchronizer for autonomous AI agents, serving as Layer 6 of the MYND Enterprise Platform. It enables AI agents to maintain consistent, real-time synchronized state across multiple applications, browser tabs, IDE instances, and tool environments — eliminating context fragmentation that plagues current AI agent deployments.
Using WebSocket-based real-time communication, Fastify's high-performance backend, and cryptographic state integrity verification, MYND Synchron ensures that every agent has a coherent, unified view of its operational context regardless of how many tools or applications it interacts with simultaneously.
- Real-Time Context Sync - WebSocket-based bidirectional synchronization across all connected agent instances
- Cross-Application State Management - Unified context shared across browsers, terminals, IDEs, and APIs
- Cryptographic Integrity - crypto-js verification ensures state hasn't been tampered with in transit
- Multi-Agent Coordination - Zustand-powered client state for complex multi-agent session management
- OAuth2 Authentication - Fastify OAuth2 plugin for secure third-party identity integration
- JWT Security - Token-based session management with bcrypt password hashing
- Redis-Backed Pub/Sub - ioredis for horizontal scaling of real-time events
- Static File Serving - @fastify/static for serving the frontend directly from the API
- Docker Orchestration - Multi-container docker-compose with separate frontend/backend networks
- Vitest Testing - Full test suite for both frontend and backend
- Lucide Icons - Consistent, beautiful icon system across the UI
- Tailwind Design - clsx + tailwind-merge for composable, type-safe styling
| Layer | Technology | Purpose |
|---|---|---|
| Frontend | React 18, TypeScript, Vite | Reactive dashboard UI |
| Styling | Tailwind CSS, clsx, tailwind-merge | Composable utility styling |
| State Management | Zustand | Lightweight client-side state |
| Real-Time | Socket.IO Client | WebSocket communication |
| Routing | React Router DOM | Client-side navigation |
| HTTP Client | Axios | REST API calls |
| Icons | Lucide React | Consistent icon set |
| Date Handling | date-fns | Date formatting and relative time |
| Backend | Node.js, Fastify 4, TypeScript | High-performance API server |
| Real-Time | @fastify/websocket | WebSocket support |
| Auth | @fastify/jwt, @fastify/oauth2 | JWT + OAuth2 authentication |
| Security | bcryptjs, crypto-js | Password hashing, state integrity |
| CORS | @fastify/cors | Cross-origin resource sharing |
| ORM | Prisma | Database access layer |
| Cache | Redis (ioredis) | Pub/sub and session storage |
| Testing | Vitest | Unit and integration testing |
| Validation | Zod | Runtime type validation |
MYND Synchron operates as a real-time context mesh:
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ Agent App A │ │ Agent App B │ │ Browser Ext │
│ (IDE/Term) │ │ (Web/App) │ │ (MV3) │
└──────┬───────┘ └──────┬───────┘ └──────┬───────┘
│ WebSocket │ WebSocket │ WebSocket
└─────────────────┼─────────────────┘
│
┌────────────────────────▼───────────────────────────────┐
│ Fastify Backend (Synchron Core) │
│ WebSocket Hub │ Context Router │ State CRDT Engine │
│ Auth (JWT/OAuth2) │ Crypto Verification │ Rate Limit │
└────────────────────────┬───────────────────────────────┘
│ Prisma
┌──────────────┼──────────────┐
┌─────────▼──────┐ ┌────▼─────┐ ┌─────▼──────┐
│ PostgreSQL │ │ Redis │ │ OAuth │
│ (Context DB) │ │ (Pub/Sub)│ │ Providers │
└────────────────┘ └──────────┘ └────────────┘
# Clone the repository
git clone https://github.com/yethikrishna/mynd-synchron.git
cd mynd-synchron
# Install dependencies
npm install
# Configure environment
cp .env.example .env
# Edit .env with your database, Redis, and OAuth credentials
# Start development servers
npm run dev
# Frontend: http://localhost:3000
# Backend: http://localhost:8080
# Run tests
npm test# Start all services
npm run docker:up
# Stop services
npm run docker:downmynd-synchron/
├── frontend/ # React + Vite frontend
│ ├── src/
│ │ ├── components/ # Sync status, agent panels, context views
│ │ ├── hooks/ # WebSocket hooks, auth hooks
│ │ ├── stores/ # Zustand state stores
│ │ └── App.tsx
│ └── package.json
├── backend/ # Fastify API server
│ ├── src/
│ │ ├── routes/ # REST API routes
│ │ ├── ws/ # WebSocket handlers for sync
│ │ ├── services/ # Context sync engine, CRDT operations
│ │ └── index.ts
│ └── package.json
├── docker-compose.yml
├── ARCHITECTURE.md # Detailed architecture documentation
├── DEPLOYMENT.md # Deployment guide
└── package.json
# Server
NODE_ENV=development
PORT=8080
FRONTEND_URL=http://localhost:3000
# Security
JWT_SECRET=your-super-secret-jwt-key-here-change-in-prod
BCRYPT_ROUNDS=12
# Database
DATABASE_URL=postgresql://user:pass@localhost:5432/mynd_synchron
# Redis
REDIS_URL=redis://localhost:6379
# OAuth2 (optional)
OAUTH_CLIENT_ID=your-client-id
OAUTH_CLIENT_SECRET=your-client-secret
OAUTH_CALLBACK_URL=http://localhost:8080/auth/callbackMYND Synchron is part of the MYND AI Agent Platform — an integrated suite of tools for building, deploying, monitoring, and evolving autonomous AI agents:
| Project | Purpose |
|---|---|
| mynd-platform | Core MYND platform: GUI automation, persistent memory, multi-agent orchestration |
| mynd-synchron | Cross-app context synchronizer (this repo) |
| mynd-agent-replay | Black box flight recorder for AI agent debugging |
| mynd-model-arena | LLM evolutionary benchmarking platform |
| mynd-plan | AI product-navigator agent |
| mynd-skill-forge | AI skill creation and management |
See DEPLOYMENT.md for production deployment instructions including Docker Swarm, Kubernetes manifests, and cloud provider configurations.
Contributions welcome. Please read ARCHITECTURE.md before submitting PRs.
MIT License.
MYND Layer 6 — Unified context for every agent, across every application.