How brijr/gui works
Gui is a desktop app for directing local AI coding agents against a live project preview. The main workflow is selecting an element or area, sending that context through chat to an agent, and reviewing the updated preview; checkpoints support undo. The graph also preserves canvases, project setup, terminals, recordings, GitHub/account features, and settings. README statements support the product flow; source-index references and excerpts support selected internal links, while unsampled runtime details are not inferred.
Main entry points: index.ts App orchestration · app.tsx App chrome · settings-app.tsx Settings UI · worker.ts Account service
Components 29
App experience
- App chrome
src/renderer/src/app/app.tsx - Design picking
src/renderer/src/pick/overlay.tsx - Chat panel
src/renderer/src/chat/chat-panel.tsx - IPC contracts
src/shared/ipc.ts - Secure preload
src/preload/index.ts - IPC requests
src/shared/ipc-requests.ts - Shortcut definitions
src/shared/shortcuts.ts
Main runtime
- App orchestration
src/main/index.ts - Project and server
src/main/project.ts - Live preview
src/main/tab.ts - Source mapping
src/main/source-resolver.ts - Terminal and logs
src/main/terminal.ts - Screen recordings
src/main/recordings.ts
Agent editing
- Agent sessions
src/main/agent.ts - Chat orchestration
src/main/chat.ts - Undo history
src/main/history.ts - File checkpoints
src/main/checkpoints.ts
Canvas design
- Canvas workflow
src/renderer/src/app/canvas.tsx - Board model
src/shared/board.ts
Accounts and state
- Settings UI
src/renderer/src/settings/settings-app.tsx - Preferences
src/main/prefs.ts - Account handling
src/main/account.ts - Account IPC
src/main/account-ipc.ts - GitHub operations
src/main/github.ts - Account types
src/shared/account.ts - GitHub types
src/shared/github.ts - Account service
accounts/src/worker.ts - Repository access
accounts/src/github-repositories.ts
Other components
- Designer
Connections 32
- Designer → Design picking: selects area
README.md - Design picking → Chat panel: sends context
README.md - Designer → Chat panel: requests changes
README.md - Chat panel → Secure preload: sends requests
- Secure preload → IPC contracts: uses contracts
src/preload/index.ts - App orchestration → IPC contracts: handles requests
src/main/index.ts - App orchestration → Secure preload: configures bridge
- App orchestration → Project and server: opens project
src/main/index.ts - Project and server → Live preview: runs preview
- App orchestration → Chat orchestration: starts chat
src/main/index.ts - Chat orchestration → Agent sessions: drives agent
- Agent sessions → Designer: edits project
README.md - Chat orchestration → Undo history: records turns
- Undo history → File checkpoints: uses snapshots
src/main/history.ts - Agent sessions → Live preview: checks work
README.md - Design picking → Source mapping: identifies source
README.md - App chrome → Canvas workflow: shows canvas
src/renderer/src/app/app.tsx - Canvas workflow → Board model: uses board data
- App orchestration → GitHub operations: clones repository
src/main/index.ts - Settings UI → Account IPC: manages account
- Account IPC → Account handling: dispatches account calls
src/main/account-ipc.ts - Account IPC → GitHub operations: dispatches GitHub calls
src/main/account-ipc.ts - Account handling → Account types: uses account types
src/main/account.ts - GitHub operations → GitHub types: uses GitHub types
- Account service → Repository access: looks up repositories
accounts/src/worker.ts - Account service → Account types: uses account types
accounts/src/worker.ts - Account service → GitHub types: uses GitHub types
accounts/src/worker.ts - App chrome → Shortcut definitions: presents shortcuts
src/shared/shortcuts.ts - Settings UI → Preferences: updates preferences
- App chrome → Terminal and logs: opens terminal
README.md - App orchestration → Screen recordings: captures sessions
src/main/index.ts - Settings UI → IPC requests: uses request types