How the-hieusss/misa works
M.I.S.A. is a local macOS floating assistant: users ask in its chat or drop files, Swift interprets requests and dispatches actions, and replies return to the web UI. The graph also captures the documented file workflows and the customizable animated assistant. The action-dispatch links are supported by Brain’s indexed references; some action internals and the full native/web message handling were not sampled, so those details are not inferred.
Main entry points: Brain.swift Request Router · App.tsx Chat Interface · MisaController.swift Window Controller · mecha-halo.tsx Animated Halo
Components 30
macOS Shell
- Window Controller
app/Sources/MISA/MisaController.swift - App Lifecycle
app/Sources/MISA/AppDelegate.swift - Web UI Host
app/Sources/MISA/DropWebView.swift - Bundle UI Server
app/Sources/MISA/BundleSchemeHandler.swift
Assistant Actions
- Request Router
app/Sources/MISA/Brain.swift - Reply and Confirm
app/Sources/MISA/Actions/Reply.swift
Chat and Appearance
- Chat Interface
web/src/App.tsx - Native Bridge
web/src/bridge.ts - Animated Halo
web/src/misa/mecha-halo.tsx - Eye Renderer
web/src/misa/eye-parts.tsx - Shell Geometry
web/src/misa/shell-parts.tsx - Appearance Catalog
web/src/misa/skin.ts - Wardrobe Editor
web/src/misa/wardrobe.tsx - Timer Ring
web/src/misa/timer-ring.tsx
File and Utility Features
- File Moves
app/Sources/MISA/Actions/MoveFiles.swift - File Conversion
app/Sources/MISA/Actions/Convert.swift - AI Text Copy
app/Sources/MISA/Actions/CopyForAI.swift - Canvas Prep
app/Sources/MISA/Actions/CanvasPrep.swift - File Utilities
app/Sources/MISA/Actions/Files.swift - Calculator
app/Sources/MISA/Actions/Calculator.swift - Unit Conversion
app/Sources/MISA/Actions/UnitConverter.swift - Focus Timer
app/Sources/MISA/Actions/FocusTimer.swift - Screenshot Tidy
app/Sources/MISA/Actions/Screenshots.swift - Downloads Tidy
app/Sources/MISA/Actions/DownloadsTidy.swift - App Launcher
app/Sources/MISA/Actions/AppLauncher.swift - Web Opener
app/Sources/MISA/Actions/WebOpener.swift - Trash Actions
app/Sources/MISA/Actions/TrashBin.swift - Disposable Files
app/Sources/MISA/Actions/DisposableActions.swift - Disk Report
app/Sources/MISA/Actions/DiskReport.swift
Other components
- User
Connections 31
- User → Chat Interface: asks or drops
- Chat Interface → Native Bridge: sends requests
web/src/App.tsx - Native Bridge → Window Controller: messages native
- Window Controller → Request Router: routes requests
app/Sources/MISA/MisaController.swift - Window Controller → Web UI Host: hosts UI
app/Sources/MISA/MisaController.swift - Window Controller → Bundle UI Server: serves bundled UI
app/Sources/MISA/MisaController.swift - App Lifecycle → Window Controller: creates controller
app/Sources/MISA/AppDelegate.swift - Request Router → File Moves: dispatches moves
app/Sources/MISA/Brain.swift - Request Router → File Conversion: dispatches conversion
app/Sources/MISA/Brain.swift - Request Router → AI Text Copy: dispatches text copy
app/Sources/MISA/Brain.swift - Request Router → Canvas Prep: dispatches prep
app/Sources/MISA/Brain.swift - Request Router → Calculator: dispatches math
app/Sources/MISA/Brain.swift - Request Router → Unit Conversion: dispatches conversion
app/Sources/MISA/Brain.swift - Request Router → Focus Timer: dispatches timer
app/Sources/MISA/Brain.swift - Request Router → Screenshot Tidy: dispatches tidy
app/Sources/MISA/Brain.swift - Request Router → Downloads Tidy: dispatches tidy
app/Sources/MISA/Brain.swift - Request Router → App Launcher: dispatches app control
app/Sources/MISA/Brain.swift - Request Router → Web Opener: dispatches web opening
app/Sources/MISA/Brain.swift - Request Router → Trash Actions: dispatches trash
app/Sources/MISA/Brain.swift - Request Router → Disposable Files: dispatches file marking
app/Sources/MISA/Brain.swift - Request Router → Disk Report: dispatches report
app/Sources/MISA/Brain.swift - Request Router → Reply and Confirm: returns response
app/Sources/MISA/Brain.swift - Chat Interface → Animated Halo: renders assistant
web/src/App.tsx - Chat Interface → Timer Ring: renders countdown
web/src/App.tsx - Chat Interface → Wardrobe Editor: opens editor
web/src/App.tsx - Animated Halo → Shell Geometry: uses geometry
web/src/misa/mecha-halo.tsx - Animated Halo → Appearance Catalog: reads appearance
web/src/misa/mecha-halo.tsx - Animated Halo → Eye Renderer: renders eye
- Wardrobe Editor → Shell Geometry: previews parts
web/src/misa/wardrobe.tsx - Wardrobe Editor → Eye Renderer: previews eye parts
web/src/misa/wardrobe.tsx - Wardrobe Editor → Appearance Catalog: reads options
web/src/misa/wardrobe.tsx