How maazi-ahmed/vorqen works
VORQEN is an Electron desktop workspace whose documented workflow selects and inspects a folder, runs a script against it, streams execution results, and refreshes the folder index. It also includes system discovery and AI file analysis. The tree and source index expose a second, substantial frontend workspace with file, project, migration, backup, storage, activity, and assistant routes; its behavior is not described in the README, so those capabilities are shown without speculative connections. Some subsystem links rely on source-index references rather than inspected implementation excerpts.
Main entry points: App.tsx Desktop app · scanCoordinator.ts Scan coordinator · handlers.ts IPC handlers · analysisCoordinator.ts Analysis coordinator
Components 29
Desktop renderer
- Desktop app
src/renderer/src/App.tsx - Folder picker
src/renderer/src/components/FolderPicker.tsx - Folder inspection
src/renderer/src/components/FolderItemsView.tsx - Script library
src/renderer/src/components/ScriptCatalog.tsx - Live console
src/renderer/src/components/ConsoleOutput.tsx - System discovery UI
src/renderer/src/components/SystemScannerView.tsx - Application reports
src/renderer/src/components/ApplicationReportModal.tsx - AI analysis UI
src/renderer/src/components/AIAnalysisView.tsx - Analysis details
src/renderer/src/components/AIDetailsModal.tsx
Main process services
- IPC bridge
src/preload/index.ts - IPC handlers
src/main/ipc/handlers.ts - Folder inspection service
src/main/services/fileSystem.ts - Script execution
src/main/services/scriptRunner.ts - Scan coordinator
src/main/services/scanner/scanCoordinator.ts - Root discovery
src/main/services/scanner/systemDiscovery.ts - Application discovery
src/main/services/scanner/applicationDiscovery.ts - File association
src/main/services/scanner/applicationAssociation.ts - File inventory
src/main/services/scanner/fileInventory.ts - Report builder
src/main/services/scanner/reportBuilder.ts - Analysis coordinator
src/main/services/ai/analysisCoordinator.ts - Content extraction
src/main/services/ai/contentExtractor.ts - AI provider
src/main/services/ai/aiProvider.ts - Analysis cache
src/main/services/ai/analysisStorage.ts
Frontend workspace
- Workspace routes
frontend/src/routes - Assistant interface
frontend/src/routes/assistant.tsx - Assistant client
frontend/src/lib/assistant.ts - Workspace primitives
frontend/src/components/vq/primitives.tsx
Other components
- Desktop user
- AI service
Connections 28
- Desktop user → Desktop app: uses
README.md - Desktop app → Folder picker: renders
src/renderer/src/App.tsx - Desktop app → Folder inspection: renders
src/renderer/src/App.tsx - Desktop app → Script library: renders
src/renderer/src/App.tsx - Desktop app → Live console: renders
src/renderer/src/App.tsx - Desktop app → System discovery UI: renders
src/renderer/src/App.tsx - Desktop app → AI analysis UI: renders
src/renderer/src/App.tsx - System discovery UI → Application reports: opens report
src/renderer/src/components/SystemScannerView.tsx - AI analysis UI → Analysis details: opens details
src/renderer/src/components/AIAnalysisView.tsx - Desktop app → IPC bridge: calls bridge
README.md - IPC bridge → IPC handlers: dispatches IPC
README.md - IPC handlers → Folder inspection service: inspects folder
src/main/ipc/handlers.ts - IPC handlers → Script execution: runs scripts
src/main/ipc/handlers.ts - IPC handlers → Root discovery: discovers roots
src/main/ipc/handlers.ts - IPC handlers → Scan coordinator: starts scans
src/main/ipc/handlers.ts - IPC handlers → Analysis coordinator: starts analysis
src/main/ipc/handlers.ts - Scan coordinator → Root discovery: discovers roots
src/main/services/scanner/scanCoordinator.ts - Scan coordinator → Application discovery: discovers apps
src/main/services/scanner/scanCoordinator.ts - Scan coordinator → File inventory: scans files
src/main/services/scanner/scanCoordinator.ts - Scan coordinator → File association: associates files
src/main/services/scanner/scanCoordinator.ts - Scan coordinator → Report builder: builds reports
src/main/services/scanner/scanCoordinator.ts - Analysis coordinator → Scan coordinator: uses scan data
src/main/services/ai/analysisCoordinator.ts - Analysis coordinator → Content extraction: extracts content
src/main/services/ai/analysisCoordinator.ts - Analysis coordinator → AI provider: requests analysis
src/main/services/ai/analysisCoordinator.ts - Analysis coordinator → Analysis cache: reads and writes
src/main/services/ai/analysisCoordinator.ts - AI provider → AI service: connects optionally
- Assistant interface → Assistant client: uses client
- Workspace routes → Workspace primitives: uses UI