Arg0/Docs

Directory Structure

Complete directory structure of the Arg0 Desktop project.

Root Directory

text
synapse_desktop/
├── .env                          # Environment variables
├── .gitignore                    # Git ignore rules
├── CHANGELOG.md                  # Version history
├── CONTRIBUTING.md               # Contribution guidelines
├── README.md                     # Project overview
├── package.json                  # Dependencies and scripts
├── electron.vite.config.ts       # Electron + Vite configuration
├── tsconfig.json                 # TypeScript configuration
├── tsconfig.node.json            # TypeScript config for Node.js
├── tsconfig.web.json             # TypeScript config for web
├── vite.web.config.mjs           # Vite web configuration
├── cli/                          # CLI tool
├── docs/                         # Documentation
├── screenshots/                  # Application screenshots
├── src/                          # Source code
├── assets/                       # Static assets
├── build/                        # Build output
├── dist/                         # Distribution files
└── tests/                        # Test files

Source Directory

text
src/
├── main/                         # Electron main process
│   └── index.ts                 # IPC handlers, MCP servers, native APIs
├── preload/                      # Preload scripts
│   └── index.ts                 # contextBridge API exposure
├── renderer/                     # React frontend
│   ├── src/
│   │   ├── components/          # UI components
│   │   │   ├── Chat.tsx        # AI chat interface
│   │   │   ├── OpenClaw.tsx    # MCP tool management
│   │   │   └── ui/             # UI component library
│   │   ├── pages/              # Application pages
│   │   │   ├── AgentPage.tsx   # Agent execution interface
│   │   │   ├── AgentBoard.tsx  # Agent management board
│   │   │   ├── BridgeMDPage.tsx # BridgeMD editor
│   │   │   ├── DashboardPage.tsx # Main dashboard
│   │   │   ├── DesignPage.tsx  # Design canvas
│   │   │   ├── DocsPage.tsx    # Documentation editor
│   │   │   ├── LoginPage.tsx   # Authentication
│   │   │   ├── PlanPage.tsx    # Planning interface
│   │   │   ├── PromptsPage.tsx # Prompt management
│   │   │   ├── SettingsPage.tsx # Configuration
│   │   │   ├── TerminalsPage.tsx # Terminal management
│   │   │   ├── TriggersPage.tsx # Trigger automation
│   │   │   └── WorkflowsPage.tsx # Workflow management
│   │   ├── lib/                # Utilities
│   │   │   ├── supabase.ts     # Supabase client
│   │   │   └── utils.ts        # Helper functions
│   │   ├── App.tsx             # Root component
│   │   ├── main.tsx            # Entry point
│   │   ├── index.css           # Global styles
│   │   └── env.d.ts            # TypeScript declarations
│   └── index.html              # HTML template
└── assets/                      # Static assets
    ├── icons/                   # Application icons
    └── images/                  # Images and logos

CLI Directory

text
cli/
├── src/
│   ├── index.ts                 # CLI entry point
│   ├── commands/                # CLI commands
│   │   ├── agent.ts            # Agent commands
│   │   ├── workflow.ts         # Workflow commands
│   │   └── status.ts           # Status commands
│   └── utils/                   # CLI utilities
├── package.json                 # CLI dependencies
└── tsconfig.json                # CLI TypeScript config

Documentation Directory

text
docs/
├── agent-implementation-system-structure.md  # Agent system details
├── agent-react-structure.md                 # React agent structure
├── github-projects-setup.md                 # GitHub Projects setup
├── logo-guidelines.md                       # Logo usage guidelines
└── project-management.md                    # Project management guide

Tests Directory

text
tests/
├── e2e/                          # End-to-end tests
│   ├── test-agent.spec.ts       # Agent tests
│   ├── test-workflow.spec.ts    # Workflow tests
│   └── test-ui.spec.ts          # UI tests
├── unit/                         # Unit tests
│   ├── components/              # Component tests
│   └── utils/                   # Utility tests
└── playwright.config.ts          # Playwright configuration

Key Files

Configuration Files

  • electron.vite.config.ts: Electron + Vite build configuration
  • tsconfig.json: Base TypeScript configuration
  • tsconfig.node.json: TypeScript config for main process
  • tsconfig.web.json: TypeScript config for renderer process
  • vite.web.config.mjs: Vite configuration for web build
  • package.json: Project dependencies and scripts

Source Files

  • src/main/index.ts: Main process entry point

    • IPC handlers
    • MCP server management
    • Native API access
    • Daemon server
  • src/preload/index.ts: Preload script

    • contextBridge API exposure
    • Security layer
    • Event handling
  • src/renderer/src/main.tsx: Renderer entry point

    • React app initialization
    • Root component mounting
  • src/renderer/src/App.tsx: Root React component

    • Routing
    • Authentication
    • Layout

Page Components

  • AgentPage.tsx: Agent execution interface

    • Step management
    • Tool selection
    • Status tracking
  • AgentBoard.tsx: Agent management board

    • Per-agent MCP config
    • Agent status display
  • DashboardPage.tsx: Main dashboard

    • Overview of all features
    • Quick actions
  • SettingsPage.tsx: Configuration panel

    • API keys
    • MCP servers
    • Preferences
  • WorkflowsPage.tsx: Workflow management

    • Workflow list
    • Execution controls
    • Status tracking

File Purposes

Main Process Files

  • IPC Handlers: Secure communication bridge
  • MCP Servers: Tool integration
  • Native APIs: File system, shell, browser
  • Daemon Server: Background HTTP server

Renderer Files

  • Components: Reusable UI elements
  • Pages: Main application screens
  • Lib: Utilities and helpers
  • Styles: CSS and Tailwind

Build Files

  • electron.vite.config.ts: Build configuration
  • package.json: Scripts and dependencies
  • tsconfig files: TypeScript compilation