How kenkaiii/roamies works
Roamies is a desktop AI companion: the user speaks or types, the agent handles requests and scheduled work, and replies appear as speech and on-screen drawings or computer actions. The graph includes the documented memory, skills, connections, and setup capabilities. Some subsystem links are based on README descriptions; unsampled modules are represented only where their paths are present in the tree, and uncertain wiring is omitted.
Main entry points: sidekick.mjs Agent runtime · speaker.mjs Voice synthesis · main.rs Desktop shell · tools.mjs Agent tools
Components 20
Desktop experience
- Desktop shell
showcase/tauri/src-tauri/src/main.rs - Roamie UI
showcase/roamies - Settings panel
showcase/panel/panel.js - Onboarding
showcase/onboarding/onboarding.js
Agent and memory
- Agent runtime
showcase/tauri/sidecar/sidekick.mjs - Model routing
showcase/tauri/sidecar/route.mjs - Agent tools
showcase/tauri/sidecar/tools.mjs - Memory store
showcase/tauri/sidecar/store.mjs - Scheduled jobs
showcase/tauri/sidecar/jobs.mjs - Skills
showcase/tauri/sidecar/skills.mjs - MCP connections
showcase/tauri/sidecar/local.mjs
Voice and replies
- Speech capture
showcase/tauri/sidecar/speech.mjs - Voice synthesis
showcase/tauri/sidecar/speaker.mjs - Fish Audio
showcase/tauri/sidecar/fish.mjs - Gemini voice
showcase/tauri/sidecar/gemini.mjs
Screen actions
- Screen drawings
showcase/tauri/sidecar/draw.mjs - Computer control
showcase/tauri/src-tauri/hands-win/src/main.rs
Native platform
- Linux desktop
showcase/tauri/src-tauri/src/linux.rs - Input handling
showcase/tauri/src-tauri/src/tap.rs
Other components
- User
Connections 22
- User → Roamie UI: speaks or types
- User → Settings panel: opens settings
- User → Onboarding: sets up
- Roamie UI → Agent runtime: sends requests
- Agent runtime → Model routing: selects model
showcase/tauri/sidecar/route.mjs - Model routing → Agent runtime: routes turn
showcase/tauri/sidecar/route.mjs - Agent runtime → Memory store: loads and saves
showcase/tauri/sidecar/sidekick.mjs - Agent runtime → Scheduled jobs: runs scheduled work
- Agent runtime → Skills: uses skills
- Agent runtime → MCP connections: syncs servers
showcase/tauri/sidecar/sidekick.mjs - Agent runtime → Agent tools: invokes tools
showcase/tauri/sidecar/sidekick.mjs - User → Speech capture: holds talk chord
- Speech capture → Agent runtime: transcribes request
showcase/tauri/sidecar/sidekick.mjs - Agent runtime → Voice synthesis: speaks reply
showcase/tauri/sidecar/speaker.mjs - Voice synthesis → Fish Audio: uses provider
showcase/tauri/sidecar/speaker.mjs - Voice synthesis → Gemini voice: uses provider
showcase/tauri/sidecar/speaker.mjs - Voice synthesis → Speech capture: uses speech services
showcase/tauri/sidecar/speaker.mjs - Agent tools → Screen drawings: checks drawing actions
showcase/tauri/sidecar/tools.mjs - Agent tools → Computer control: controls other apps
- Agent runtime → Desktop shell: communicates with
- Desktop shell → Linux desktop: uses platform support
showcase/tauri/src-tauri/src/main.rs - Desktop shell → Input handling: uses input handling
showcase/tauri/src-tauri/src/main.rs