How momoshub/j.a.r.v.i.s. works
J.A.R.V.I.S. is a Slack-facing assistant harness: messages and commands enter through Slack, run through role-aware conversations and Claude Code or the Anthropic API, and produce replies while sessions, memory, and work are managed. Its broader product includes scheduled/background workers, GitHub review and self-update workflows, and a local admin dashboard. The graph uses README claims and the shown import/call references; unsampled subsystems are represented only where the README documents them or the source index names them.
Main entry points: app.ts Slack app · respond.ts Message response · server.ts Dashboard API · autoReview.ts GitHub reviews
Components 16
Interaction
- Slack app
src/infrastructure/slack/app.ts - Command dispatch
src/application/commands.ts
Assistant runtime
- Message response
src/application/respond.ts - Roles and tool policy
src/domain/permissions.ts - Claude / Anthropic
src/infrastructure/llm - Sessions and memory
src/domain/threadSession.ts
Workflows and integrations
- Background workers
src/application/workerTickets.ts - Scheduled work
src/application/commands/schedule.ts - GitHub reviews
src/application/autoReview.ts - Self-update
src/domain/selfUpdate.ts
Persistence
- SQLite state
src/infrastructure/db/client.ts
Administration
- Dashboard API
src/infrastructure/dashboard/server.ts - Dashboard UI
web/src/routes/router.tsx
Other components
- Slack user
- Slack service
- GitHub service
Connections 18
- Slack user → Slack app: sends messages
README.md - Slack app → Command dispatch: dispatches commands
src/infrastructure/slack/app.ts - Slack app → Message response: routes messages
src/infrastructure/slack/app.ts - Command dispatch → Message response: starts turns
- Message response → Roles and tool policy: checks access
- Message response → Claude / Anthropic: runs model
- Message response → Sessions and memory: resumes sessions
- Sessions and memory → SQLite state: persists state
- Background workers → Claude / Anthropic: runs agents
- Scheduled work → Background workers: schedules work
- GitHub reviews → GitHub service: reviews pull requests
README.md - GitHub reviews → Slack app: posts review approvals
- Self-update → GitHub service: opens own PRs
README.md - Dashboard API → Dashboard UI: serves application
src/infrastructure/dashboard/server.ts - Dashboard UI → Dashboard API: loads and mutates
web/src/routes/router.tsx - Dashboard API → SQLite state: reads state
- Dashboard API → Slack service: manages presence
src/infrastructure/dashboard/server.ts - Slack app → Slack service: uses Slack API
README.md