How syedkazmi14/squeek works
Squeek is a cross-device scam-awareness companion. On Windows, the observer reads the selected foreground app; the desktop assesses content locally and optionally with Jev, then presents and speaks advisory warnings. On iPhone, app and extension entry points check shared text, links, calls, messages, and screens; local rules and the shared backend support warnings and synced incidents. The README documents broader account, block-list, and family-helper sync capabilities. Several implementation files were not sampled, so their internal call paths are left unasserted.
Main entry points: main.ts Desktop coordinator · RootView.swift Squeek app · CheckService.swift Check service · observer-client.ts Observer client
Components 29
Windows companion
- Observer helper
apps/windows-observer/Program.cs - Observer client
apps/desktop/src/main/observer-client.ts - Desktop coordinator
apps/desktop/src/main/main.ts - Review panel
apps/desktop/src/renderer/renderer.ts - Cursor companion
apps/desktop/src/main/companion.ts - Speech output
apps/desktop/src/main/tts.ts
Assessment engines
- Action review
packages/detection/src/action-review.ts - Desktop assessment
packages/detection/src/index.ts - Jev transport
packages/providers/src/jev.ts - Shared rules
packages/rules/src/engine.ts - On-device checks
apps/ios/SqueekCore/Sources/SqueekCore/LocalChecker.swift - Link analysis
apps/ios/SqueekCore/Sources/SqueekCore/LinkAnalyzer.swift
iPhone protection
- Squeek app
apps/ios/Squeek/Views/RootView.swift - Share checks
apps/ios/ShareExtension/ShareViewController.swift - Safari checks
apps/ios/SafariExtension/SafariWebExtensionHandler.swift - Screen guard
apps/ios/ScreenGuardExtension/SampleHandler.swift - Call screening
apps/ios/CallDirectoryExtension/CallDirectoryHandler.swift - SMS filtering
apps/ios/MessageFilterExtension/MessageFilterExtension.swift - Check service
apps/ios/Shared/CheckService.swift - Shared device store
apps/ios/SqueekCore/Sources/SqueekCore/SharedStore.swift - Backend client
apps/ios/Shared/Backend.swift
Shared services
- Supabase services
supabase/functions/_shared/context.ts - Text assessment
supabase/functions/assess-text/index.ts - Call webhook
supabase/functions/call-webhook/index.ts - Account and sync
supabase/functions
Shared contracts
- Observation schema
packages/contracts/src/observation.ts
Other components
- Older adult
- Windows apps
- iPhone user
Connections 31
- Older adult → Windows apps: uses
README.md - Windows apps → Observer helper: observed by
README.md - Desktop coordinator → Observer client: controls
apps/desktop/src/main/main.ts - Observer client → Observer helper: commands
apps/desktop/src/main/observer-client.ts - Observer helper → Observation schema: emits schema
apps/windows-observer/Program.cs - Observer client → Observation schema: parses
apps/desktop/src/main/observer-client.ts - Desktop coordinator → Desktop assessment: assesses
apps/desktop/src/main/main.ts - Desktop coordinator → Jev transport: configures
apps/desktop/src/main/main.ts - Desktop assessment → Jev transport: classifies
packages/detection/src/index.ts - Desktop coordinator → Action review: requests review
packages/detection/src/action-review.ts - Desktop coordinator → Review panel: shows warnings
README.md - Desktop coordinator → Cursor companion: updates
apps/desktop/src/main/main.ts - Desktop coordinator → Speech output: speaks warnings
apps/desktop/src/main/main.ts - Older adult → Squeek app: uses
README.md - iPhone user → Share checks: shares content
apps/ios/ShareExtension/ShareViewController.swift - Share checks → Check service: checks text or link
apps/ios/ShareExtension/ShareViewController.swift - Safari checks → Check service: checks links
apps/ios/SafariExtension/SafariWebExtensionHandler.swift - Screen guard → On-device checks: checks screen text
apps/ios/ScreenGuardExtension/SampleHandler.swift - Call screening → Shared device store: reads block list
apps/ios/CallDirectoryExtension/CallDirectoryHandler.swift - SMS filtering → Shared device store: filters unknown senders
README.md - Check service → On-device checks: checks locally
apps/ios/Shared/CheckService.swift - On-device checks → Link analysis: analyzes links
apps/ios/SqueekCore/Sources/SqueekCore/LocalChecker.swift - Check service → Backend client: requests checks
apps/ios/Shared/CheckService.swift - Backend client → Text assessment: calls assessment
README.md - Text assessment → Supabase services: uses auth and data
supabase/functions/assess-text/index.ts - Squeek app → Shared device store: uses shared store
README.md - Squeek app → Account and sync: syncs account data
README.md - Supabase services → Account and sync: supports sync
README.md - Call screening → Call webhook: reports calls
README.md - Call webhook → Supabase services: uses backend context
supabase/functions/call-webhook/index.ts - Squeek app → Shared rules: shares rule behavior
README.md