System Architecture

Quick Reference

CodyMaster is a Node.js CLI tool backed by a local SQLite database for memory and an Express/WebSocket server for MCP tools and browser automation.

Core Components

1. CLI Layer

The entry point for all interactions. Built with commander.

2. Context Database

A better-sqlite3 database storing agent memories, task logs, and continuity states.

3. Browse Hybrid Bridge

An Express server running Playwright to provide agents with visual QA capabilities and DOM interaction.

4. MCP Context Server

Exposes custom tools (e.g., file reading, semantic search) to external LLMs using the Model Context Protocol.

Data Flow

graph TD
    A[User CLI] --> B[Agent Dispatch]
    B --> C[(SQLite DB)]
    B --> D[MCP Server]
    D --> E[External LLM]
    E --> D
    D --> F[Playwright Browser]

Diagram Description

The user interacts with the CLI, which triggers the Agent Dispatch. The Dispatch reads/writes to the SQLite DB. The MCP Server acts as a bridge between the External LLM and local tools, including the Playwright Browser.

TIP

Always refer to the Context DB for any stateful operations to ensure continuity between sessions.