# vierisid/jarvis architecture

> Architecture diagram of the GitHub repository vierisid/jarvis, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vierisid/jarvis
- Repository: https://github.com/vierisid/jarvis

## Overview

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: [`src/agents/task-manager.ts`](https://github.com/vierisid/jarvis/blob/main/src/agents/task-manager.ts) (Agent task manager), [`src/daemon/services.ts`](https://github.com/vierisid/jarvis/blob/main/src/daemon/services.ts) (Daemon services), [`src/workflows/runtime/engine-bootstrap.ts`](https://github.com/vierisid/jarvis/blob/main/src/workflows/runtime/engine-bootstrap.ts) (Workflow bootstrap), [`src/workflows/runner/engine-runtime/engine-runtime.ts`](https://github.com/vierisid/jarvis/blob/main/src/workflows/runner/engine-runtime/engine-runtime.ts) (Workflow engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Interaction and daemon"]
  node_daemon["Daemon services<br/>[services.ts]"]
  node_api["Dashboard API<br/>[api-routes.ts]"]
  node_comms["Voice and channels"]
end

subgraph group_reasoning["Agents and governance"]
  node_agents["Agent task manager<br/>[task-manager.ts]"]
  node_authority["Authority engine<br/>[engine.ts]"]
  node_tools["Action tools"]
  node_llm["LLM providers<br/>[manager.ts]"]
end

subgraph group_desktop["Desktop awareness"]
  node_sidecar["Sidecar manager<br/>[manager.ts]"]
  node_native["Desktop automation"]
  node_awareness["Proactive suggestions"]
end

subgraph group_memory["Memory and goals"]
  node_vault[("Memory and vault")]
  node_goals["Goal pursuit"]
end

subgraph group_automation["Workflow automation"]
  node_workflow_api["Workflow API<br/>[routes.ts]"]
  node_workflow_boot["Workflow bootstrap"]
  node_engine["Workflow engine<br/>[engine-runtime.ts]"]
  node_sandbox["Sandbox API<br/>[server.ts]"]
  node_catalog["Piece catalog<br/>[piece-catalog.ts]"]
  node_runs[("Workflow run records<br/>[flow-run.ts]")]
end

node_user(("User"))

node_user -->|"sends requests"| node_api
node_user -->|"speaks or messages"| node_comms
node_api -.->|"routes requests"| node_daemon
node_daemon -.->|"dispatches tasks"| node_agents
node_agents -->|"reasons with"| node_llm
node_agents -->|"uses tools"| node_tools
node_tools -.->|"checks authority"| node_authority
node_user -->|"defines limits"| node_authority
node_daemon -->|"manages connections"| node_sidecar
node_sidecar -->|"relays desktop actions"| node_native
node_native -->|"supplies screen context"| node_awareness
node_awareness -->|"persists suggestions"| node_vault
node_user -->|"defines goals"| node_goals
node_agents -.->|"pursues goals"| node_goals
node_user -->|"builds automations"| node_workflow_api
node_workflow_api -.->|"starts workflow runtime"| node_workflow_boot
node_workflow_boot -->|"creates runtime"| node_engine
node_workflow_boot -->|"builds catalog"| node_catalog
node_engine -->|"connects to sandbox"| node_sandbox
node_engine -->|"reads run state"| node_runs
node_comms -->|"delivers responses"| node_user

click node_daemon "https://github.com/vierisid/jarvis/blob/main/src/daemon/services.ts"
click node_api "https://github.com/vierisid/jarvis/blob/main/src/daemon/api-routes.ts"
click node_comms "https://github.com/vierisid/jarvis/tree/main/src/comms"
click node_agents "https://github.com/vierisid/jarvis/blob/main/src/agents/task-manager.ts"
click node_authority "https://github.com/vierisid/jarvis/blob/main/src/authority/engine.ts"
click node_tools "https://github.com/vierisid/jarvis/tree/main/src/actions/tools"
click node_llm "https://github.com/vierisid/jarvis/blob/main/src/llm/manager.ts"
click node_sidecar "https://github.com/vierisid/jarvis/blob/main/src/sidecar/manager.ts"
click node_native "https://github.com/vierisid/jarvis/tree/main/sidecar"
click node_awareness "https://github.com/vierisid/jarvis/blob/main/src/awareness/suggestion-engine.ts"
click node_vault "https://github.com/vierisid/jarvis/tree/main/src/vault"
click node_goals "https://github.com/vierisid/jarvis/tree/main/src/goals"
click node_workflow_api "https://github.com/vierisid/jarvis/blob/main/src/workflows/api/routes.ts"
click node_workflow_boot "https://github.com/vierisid/jarvis/blob/main/src/workflows/runtime/engine-bootstrap.ts"
click node_engine "https://github.com/vierisid/jarvis/blob/main/src/workflows/runner/engine-runtime/engine-runtime.ts"
click node_sandbox "https://github.com/vierisid/jarvis/blob/main/src/workflows/sandbox-api/server.ts"
click node_catalog "https://github.com/vierisid/jarvis/blob/main/src/workflows/runtime/piece-catalog.ts"
click node_runs "https://github.com/vierisid/jarvis/blob/main/src/workflows/db/repos/flow-run.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_daemon,node_api,node_comms,node_user toneBlue
class node_agents,node_authority,node_tools,node_llm toneAmber
class node_sidecar,node_native,node_awareness toneMint
class node_vault,node_goals toneRose
class node_workflow_api,node_workflow_boot,node_engine,node_sandbox,node_catalog,node_runs toneIndigo
```

## Components

### Interaction and daemon

- [Daemon services](https://github.com/vierisid/jarvis/blob/main/src/daemon/services.ts): `src/daemon/services.ts`
- [Dashboard API](https://github.com/vierisid/jarvis/blob/main/src/daemon/api-routes.ts): `src/daemon/api-routes.ts`
- [Voice and channels](https://github.com/vierisid/jarvis/tree/main/src/comms): `src/comms`

### Agents and governance

- [Agent task manager](https://github.com/vierisid/jarvis/blob/main/src/agents/task-manager.ts): `src/agents/task-manager.ts`
- [Authority engine](https://github.com/vierisid/jarvis/blob/main/src/authority/engine.ts): `src/authority/engine.ts`
- [Action tools](https://github.com/vierisid/jarvis/tree/main/src/actions/tools): `src/actions/tools`
- [LLM providers](https://github.com/vierisid/jarvis/blob/main/src/llm/manager.ts): `src/llm/manager.ts`

### Desktop awareness

- [Sidecar manager](https://github.com/vierisid/jarvis/blob/main/src/sidecar/manager.ts): `src/sidecar/manager.ts`
- [Desktop automation](https://github.com/vierisid/jarvis/tree/main/sidecar): `sidecar`
- [Proactive suggestions](https://github.com/vierisid/jarvis/blob/main/src/awareness/suggestion-engine.ts): `src/awareness/suggestion-engine.ts`

### Memory and goals

- [Memory and vault](https://github.com/vierisid/jarvis/tree/main/src/vault): `src/vault`
- [Goal pursuit](https://github.com/vierisid/jarvis/tree/main/src/goals): `src/goals`

### Workflow automation

- [Workflow API](https://github.com/vierisid/jarvis/blob/main/src/workflows/api/routes.ts): `src/workflows/api/routes.ts`
- [Workflow bootstrap](https://github.com/vierisid/jarvis/blob/main/src/workflows/runtime/engine-bootstrap.ts): `src/workflows/runtime/engine-bootstrap.ts`
- [Workflow engine](https://github.com/vierisid/jarvis/blob/main/src/workflows/runner/engine-runtime/engine-runtime.ts): `src/workflows/runner/engine-runtime/engine-runtime.ts`
- [Sandbox API](https://github.com/vierisid/jarvis/blob/main/src/workflows/sandbox-api/server.ts): `src/workflows/sandbox-api/server.ts`
- [Piece catalog](https://github.com/vierisid/jarvis/blob/main/src/workflows/runtime/piece-catalog.ts): `src/workflows/runtime/piece-catalog.ts`
- [Workflow run records](https://github.com/vierisid/jarvis/blob/main/src/workflows/db/repos/flow-run.ts): `src/workflows/db/repos/flow-run.ts`

### Other components

- **User**

## Connections

- User → Dashboard API: sends requests (evidence: `README.md`)
- User → Voice and channels: speaks or messages (evidence: `README.md`)
- Dashboard API → Daemon services: routes requests
- Daemon services → Agent task manager: dispatches tasks
- Agent task manager → LLM providers: reasons with (evidence: `src/agents/task-manager.ts`)
- Agent task manager → Action tools: uses tools (evidence: `README.md`)
- Action tools → Authority engine: checks authority
- User → Authority engine: defines limits (evidence: `README.md`)
- Daemon services → Sidecar manager: manages connections (evidence: `src/sidecar/manager.ts`)
- Sidecar manager → Desktop automation: relays desktop actions (evidence: `README.md`)
- Desktop automation → Proactive suggestions: supplies screen context (evidence: `README.md`)
- Proactive suggestions → Memory and vault: persists suggestions (evidence: `src/awareness/suggestion-engine.ts`)
- User → Goal pursuit: defines goals (evidence: `README.md`)
- Agent task manager → Goal pursuit: pursues goals
- User → Workflow API: builds automations (evidence: `README.md`)
- Workflow API → Workflow bootstrap: starts workflow runtime
- Workflow bootstrap → Workflow engine: creates runtime (evidence: `src/workflows/runtime/engine-bootstrap.ts`)
- Workflow bootstrap → Piece catalog: builds catalog (evidence: `src/workflows/runtime/engine-bootstrap.ts`)
- Workflow engine → Sandbox API: connects to sandbox (evidence: `src/workflows/runner/engine-runtime/engine-runtime.ts`)
- Workflow engine → Workflow run records: reads run state (evidence: `src/workflows/runner/engine-runtime/engine-runtime.ts`)
- Voice and channels → User: delivers responses (evidence: `README.md`)
