How proma-ai/proma works
Proma is a local-first desktop Agent for professional work. Users organize work into projects and sessions, provide project memory and tools as context, then interact with Chat or Agent workflows and review results in files, previews, or related sessions. The README also documents planning, parallel exploration, scheduling, embedded browser/terminal, Skills/MCP/CLI, and remote messaging integrations. The graph combines those documented capabilities with source-indexed implementation modules; unsampled subsystems are not treated as inspected, and uncertain internal wiring is omitted.
Main entry points: agent-orchestrator.ts Agent orchestration · agent-session-manager.ts Agent sessions · App.tsx Desktop UI · conversation-manager.ts Chat conversations
Components 19
Desktop experience
- Desktop UI
apps/electron/src/renderer/App.tsx - Renderer entry
apps/electron/src/renderer/main.tsx - Agent UI state
apps/electron/src/renderer/atoms/agent-atoms.ts
Agent and sessions
- Agent orchestration
apps/electron/src/main/lib/agent-orchestrator.ts - Agent sessions
apps/electron/src/main/lib/agent-session-manager.ts - Chat conversations
apps/electron/src/main/lib/conversation-manager.ts - Transcript processing
packages/session-core/src/transcript.ts
Project context
- Project workspaces
apps/electron/src/main/lib/agent-workspace-manager.ts - Local configuration
apps/electron/src/main/lib/config-paths.ts
Work tools
- Plans and tasks
apps/electron/src/main/lib/planning-manager.ts - Scheduled tasks
apps/electron/src/main/lib/automation-scheduler.ts - Embedded browser
apps/electron/src/main/lib/browser-controller.ts - Embedded terminal
apps/electron/src/main/lib/terminal-service.ts - File preview
apps/electron/src/main/lib/file-preview-service.ts
Extensions and channels
- Skills and MCP
apps/electron/src/main/lib/agent-workspace-manager.ts - Remote messaging
apps/electron/src/main/lib/feishu-bridge.ts - Session CLI
apps/cli/src/commands/search.ts - Model providers
packages/core/src/providers/anthropic-adapter.ts
Other components
- Professional user
Connections 19
- Professional user → Desktop UI: uses
README.md - Renderer entry → Desktop UI: mounts
apps/electron/src/renderer/main.tsx - Desktop UI → Agent UI state: manages UI state
- Desktop UI → Agent orchestration: starts Agent work
- Agent orchestration → Agent sessions: coordinates sessions
- Agent sessions → Project workspaces: uses workspace
apps/electron/src/main/lib/agent-session-manager.ts - Agent sessions → Chat conversations: uses conversation data
apps/electron/src/main/lib/agent-session-manager.ts - Agent sessions → Local configuration: uses paths
apps/electron/src/main/lib/agent-session-manager.ts - Chat conversations → Transcript processing: processes transcripts
- Agent orchestration → Model providers: requests model output
- Agent orchestration → Plans and tasks: works with plans
- Agent orchestration → Scheduled tasks: supports schedules
- Agent orchestration → Embedded browser: uses browser
- Agent orchestration → Embedded terminal: uses terminal
- Agent orchestration → File preview: reviews files
- Agent orchestration → Skills and MCP: uses project tools
- Agent orchestration → Remote messaging: receives remote work
- Session CLI → Transcript processing: searches transcripts
apps/cli/src/commands/search.ts - File preview → Local configuration: resolves local files