How shaswata09/jojo works
jojo is a local-first job-search tracker with optional agentic assistance. The main workflow is to record and organise opportunities, track applications and deadlines, then use the assistant or job-board pipelines to answer questions or propose work for approval. The graph covers the web and mobile clients, domain model, agent/tool layers, local persistence, and documented optional integrations. Relationships involving unsampled modules are included only where the README or source index supports them; several integrations are documented capabilities rather than inspected call paths.
Main entry points: loop.ts Assistant conversation · src/App.tsx Web app · mobile/App.tsx Mobile app · use-pipelines.ts Job pipelines
Components 22
User clients
- Web app
web/src/App.tsx - Mobile app
mobile/App.tsx
Job-search domain
- Applications
service/kg/core/board.ts - Domain records
service/kg/core/model.ts - Posting capture
service/kg/core/capture.ts - Dates and deadlines
service/kg/core/dates.ts
Assistant and agents
- Assistant conversation
service/kg/agent/loop.ts - Agent read queries
service/kg/agent/queries.ts - Agent tool catalog
service/kg/agent/catalog.ts - Tool execution
service/kg/agent/execute.ts - Domain tools
service/kg/tools/index.ts - Job pipelines
service/kg/react/use-pipelines.ts - Human-approved proposals
service/kg/tools/pipeline.ts
Local records
- Graph repository
service/kg/repo/repository.ts - Graph snapshot
service/kg/core/snapshot.ts - Storage drivers
service/kg/storage
Optional capabilities
- Browser extension
web/extension/worker/routing.js
Other components
- Job seeker
- Configured model
- Document reader
- Device calendar
- Other device
Connections 28
- Job seeker → Web app: uses
- Job seeker → Mobile app: uses
- Web app → Applications: tracks applications
- Mobile app → Applications: tracks applications
- Applications → Domain records: uses records
service/kg/core/board.ts - Posting capture → Domain records: creates records
service/kg/core/capture.ts - Dates and deadlines → Domain records: uses dates
service/kg/core/dates.ts - Web app → Assistant conversation: offers assistant
- Mobile app → Assistant conversation: offers assistant
- Assistant conversation → Configured model: sends prompts
- Assistant conversation → Agent read queries: queries records
service/kg/agent/loop.ts - Assistant conversation → Agent tool catalog: requests tools
service/kg/agent/execute.ts - Agent tool catalog → Domain tools: lists tools
service/kg/agent/catalog.ts - Tool execution → Domain tools: dispatches tools
service/kg/agent/execute.ts - Web app → Job pipelines: offers pipelines
- Mobile app → Job pipelines: offers pipelines
- Job pipelines → Assistant conversation: runs agent loop
service/kg/react/use-pipelines.ts - Job pipelines → Human-approved proposals: raises suggestions
- Human-approved proposals → Job seeker: awaits approval
service/kg/tools/pipeline.ts - Graph repository → Graph snapshot: maintains graph
service/kg/repo/repository.ts - Graph repository → Storage drivers: uses drivers
service/kg/repo/repository.ts - Web app → Graph repository: stores records locally
- Mobile app → Graph repository: stores records locally
- Job seeker → Browser extension: captures postings
- Browser extension → Posting capture: saves postings
- Job seeker → Document reader: configures reader
- Dates and deadlines → Device calendar: exports calendar
- Job seeker → Other device: transfers records