How vierisid/jarvis works
JARVIS is an always-on autonomous assistant daemon, with a dashboard and optional desktop sidecars. The main workflow is user request or ambient observation → daemon/API and agent reasoning → authority checks and LLM/tool execution → response or action. Distinct product branches include desktop awareness, sidecar control, voice, goal pursuit, proactive suggestions, and visual workflows. The graph combines README-documented capabilities with relationships visible in the supplied source index and excerpts; unsampled internals are represented at their known directory paths, and uncertain wiring is omitted.
Main entry points: task-manager.ts Agent task manager · services.ts Daemon services · engine-bootstrap.ts Workflow bootstrap · engine-runtime.ts Workflow engine
Components 19
Interaction and daemon
- Daemon services
src/daemon/services.ts - Dashboard API
src/daemon/api-routes.ts - Voice and channels
src/comms
Agents and governance
- Agent task manager
src/agents/task-manager.ts - Authority engine
src/authority/engine.ts - Action tools
src/actions/tools - LLM providers
src/llm/manager.ts
Desktop awareness
- Sidecar manager
src/sidecar/manager.ts - Desktop automation
sidecar - Proactive suggestions
src/awareness/suggestion-engine.ts
Memory and goals
- Memory and vault
src/vault - Goal pursuit
src/goals
Workflow automation
- Workflow API
src/workflows/api/routes.ts - Workflow bootstrap
src/workflows/runtime/engine-bootstrap.ts - Workflow engine
src/workflows/runner/engine-runtime/engine-runtime.ts - Sandbox API
src/workflows/sandbox-api/server.ts - Piece catalog
src/workflows/runtime/piece-catalog.ts - Workflow run records
src/workflows/db/repos/flow-run.ts
Other components
- User
Connections 21
- User → Dashboard API: sends requests
README.md - User → Voice and channels: speaks or messages
README.md - Dashboard API → Daemon services: routes requests
- Daemon services → Agent task manager: dispatches tasks
- Agent task manager → LLM providers: reasons with
src/agents/task-manager.ts - Agent task manager → Action tools: uses tools
README.md - Action tools → Authority engine: checks authority
- User → Authority engine: defines limits
README.md - Daemon services → Sidecar manager: manages connections
src/sidecar/manager.ts - Sidecar manager → Desktop automation: relays desktop actions
README.md - Desktop automation → Proactive suggestions: supplies screen context
README.md - Proactive suggestions → Memory and vault: persists suggestions
src/awareness/suggestion-engine.ts - User → Goal pursuit: defines goals
README.md - Agent task manager → Goal pursuit: pursues goals
- User → Workflow API: builds automations
README.md - Workflow API → Workflow bootstrap: starts workflow runtime
- Workflow bootstrap → Workflow engine: creates runtime
src/workflows/runtime/engine-bootstrap.ts - Workflow bootstrap → Piece catalog: builds catalog
src/workflows/runtime/engine-bootstrap.ts - Workflow engine → Sandbox API: connects to sandbox
src/workflows/runner/engine-runtime/engine-runtime.ts - Workflow engine → Workflow run records: reads run state
src/workflows/runner/engine-runtime/engine-runtime.ts - Voice and channels → User: delivers responses
README.md