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
Related Documentation
- Architecture - System architecture
- Agent Implementation - Agent system
- Installation - Setup guide