agent-ecosystem/src/main/CLAUDE.md

Main Process

Node.js runtime handling file system, IPC, and app lifecycle.

Structure

• index.ts - App entry point, lifecycle management
• ipc/ - IPC handlers organized by domain
• services/ - Business logic by domain
• types/ - Type definitions
• utils/ - Utility functions
• constants/ - Shared constants (messageTags, worktreePatterns)

IPC Organization

Handlers in ipc/ by domain:

• projects.ts - Project listing
• sessions.ts - Session operations
• search.ts - Search functionality
• subagents.ts - Subagent details
• validation.ts - Path validation
• utility.ts - Shell & file operations
• config.ts - Configuration
• notifications.ts - Notifications

Adding IPC Handler

1. Add to domain file in ipc/
2. If new domain, create file and register in handlers.ts
3. Add type in preload/index.ts
4. Implement in appropriate service

File Watching

FileWatcher service monitors session files with 100ms debounce. Notifies renderer of changes via IPC events.