How akilanpl/notyourregularcompanian-nyrc- works
NYRC is a local-first desktop companion with an expressive character and optional assistant tools. Its main workflow runs from the user through the desktop interface and local request routing to host-side command handling, where permission checks gate sensitive actions and local storage or integrations perform the work. Separate branches cover character simulation, timers and reminders, optional AI and Calendar, and the shared body protocol. Some subsystem links are documented in the README; unsampled implementation details are not inferred.
Main entry points: Pet.svelte Companion interface · services.rs Host commands · router.ts Local request router · runtime.ts Assistant runtime
Components 24
Desktop interface
- App routing
src/App.svelte - Companion interface
src/lib/components/Pet.svelte - Assistant input
src/lib/components/AssistantInput.svelte
Companion experience
- Personality settings
src-tauri/src/personality.rs - Character simulation
src/lib/sim/state.ts - Expressions and reactions
src/lib/character/expression.ts
Assistant tools
- Local request router
src/lib/assistant/router.ts - Assistant runtime
src/lib/assistant/runtime.ts - Task manager
src/lib/tasks/taskManager.ts - Timers and reminders
src-tauri/src/commands/scheduled.rs - Pocket and memory
src-tauri/src/commands/memory.rs
Host services
- Desktop bridge
src/lib/bridge/api.ts - Host commands
src-tauri/src/commands/services.rs - Permission checks
src-tauri/src/authority.rs - Local database
src-tauri/src/db.rs - Restricted file access
src-tauri/src/sandbox.rs - AI providers
src-tauri/src/llm/cloud.rs - Google Calendar
src-tauri/src/commands/calendar.rs
Body integration
- Semantic body API
src/lib/body/protocol.ts - Loopback transport
src-tauri/src/body.rs - Desktop body
src/lib/body/core.ts
Other components
- User
- AI service
- Google Calendar service
Connections 25
- User → App routing: opens
README.md - App routing → Companion interface: shows
src/App.svelte - User → Assistant input: requests help
README.md - Assistant input → Local request router: routes locally
- Local request router → Assistant runtime: resolves requests
- Assistant runtime → Task manager: dispatches tasks
- Local request router → Timers and reminders: handles reminders
README.md - Assistant runtime → Desktop bridge: calls host tools
- Companion interface → Desktop bridge: uses desktop API
src/lib/components/Pet.svelte - Desktop bridge → Host commands: invokes commands
src/lib/bridge/api.ts - Host commands → Permission checks: checks approval
src-tauri/src/commands/services.rs - Host commands → Google Calendar: dispatches Calendar
src-tauri/src/commands/services.rs - Host commands → Local database: reads and writes
src-tauri/src/commands/services.rs - Host commands → Restricted file access: reads Pocket files
src-tauri/src/commands/services.rs - Host commands → AI providers: uses configured provider
src-tauri/src/commands/services.rs - Google Calendar → Google Calendar service: requests events
src-tauri/src/commands/calendar.rs - AI providers → AI service: sends AI requests
README.md - Companion interface → Character simulation: updates companion state
src/lib/components/Pet.svelte - Character simulation → Expressions and reactions: drives reactions
- Companion interface → Semantic body API: uses body protocol
src/lib/components/Pet.svelte - Semantic body API → Loopback transport: uses transport
README.md - Semantic body API → Desktop body: renders on desktop
README.md - Companion interface → Personality settings: presents personality
- Companion interface → Timers and reminders: shows scheduled alerts
- Companion interface → Pocket and memory: offers saved items