How nerdywhiskers/catabull works
CataBull is a local-first job-search dashboard and CLI. The main user journey is to configure a profile and target companies, discover and evaluate postings, manage promising roles in a pipeline, then generate tailored application materials and track applications. The graph also shows the dashboard/API boundary, local workspace persistence, agent-backed workflows, and documented health monitoring and terminal capabilities. Some route and scan wiring is supported by the SOURCE INDEX or README rather than full excerpts; those evidence limits are reflected in the citations.
Main entry points: scan-deep.mjs Deep scan workflow · applications.mjs Application actions · onboarding.mjs Company onboarding · writers.mjs Workspace data writers
Components 21
Dashboard
- Dashboard UI
dashboard-web/public/js/app.mjs - Search and pipeline views
dashboard-web/public/js/views - Dashboard API client
dashboard-web/public/js/api.mjs
Discovery
- Company onboarding
dashboard-web/routes/onboarding.mjs - Deep scan workflow
dashboard-web/routes/scan-deep.mjs - Deep discovery
scan/level3.mjs - Web search providers
scan/websearch.mjs - ATS providers
scan/providers/index.mjs - Role relevance scoring
lib/relevance.mjs - Portal health monitoring
dashboard-web/routes/health.mjs
Application workflow
- Role identity matching
lib/role-identity.mjs - Application actions
dashboard-web/routes/applications.mjs - Tailored materials
lib/tailor.mjs
Local workspace
- Pipeline and application data
dashboard-web/lib/parsers.mjs - Workspace data writers
dashboard-web/lib/writers.mjs - Local workspace files
lib/workspace.mjs
Runtime services
- Fastify server
dashboard-web/server.mjs - Dashboard routes
dashboard-web/routes - CLI agent sessions
dashboard-web/lib/agents.mjs - Integrated agent terminal
dashboard-web/routes/terminal.mjs
Other components
- Job seeker
Connections 25
- Job seeker → Dashboard UI: uses
README.md - Dashboard UI → Search and pipeline views: renders views
dashboard-web/public/js/app.mjs - Search and pipeline views → Dashboard API client: requests data
dashboard-web/public/js/views/pipeline.mjs - Dashboard API client → Dashboard routes: calls endpoints
- Fastify server → Dashboard routes: registers routes
dashboard-web/server.mjs - Dashboard routes → Company onboarding: handles setup
dashboard-web/server.mjs - Company onboarding → CLI agent sessions: tests selected agent
dashboard-web/routes/onboarding.mjs - Company onboarding → Workspace data writers: saves targets
dashboard-web/routes/onboarding.mjs - Job seeker → Company onboarding: configures targets
README.md - Deep scan workflow → Deep discovery: runs deep scan
dashboard-web/routes/scan-deep.mjs - Deep scan workflow → Web search providers: searches postings
dashboard-web/routes/scan-deep.mjs - Deep discovery → Web search providers: queries web search
scan/level3.mjs - Deep scan workflow → ATS providers: uses ATS discovery
dashboard-web/routes/scan-deep.mjs - Job seeker → Deep scan workflow: starts discovery
README.md - Deep scan workflow → Role relevance scoring: scores roles
dashboard-web/routes/scan-deep.mjs - Application actions → Pipeline and application data: reads pipeline
dashboard-web/routes/applications.mjs - Application actions → Role identity matching: deduplicates roles
dashboard-web/routes/applications.mjs - Application actions → CLI agent sessions: runs tailoring agent
dashboard-web/routes/applications.mjs - Application actions → Workspace data writers: updates application data
dashboard-web/routes/applications.mjs - Tailored materials → Local workspace files: reads profile and CV
lib/tailor.mjs - Pipeline and application data → Local workspace files: reads workspace files
dashboard-web/lib/parsers.mjs - Workspace data writers → Local workspace files: writes workspace files
dashboard-web/lib/writers.mjs - Job seeker → Portal health monitoring: checks portal health
README.md - Job seeker → Integrated agent terminal: opens agent terminal
README.md - Fastify server → Portal health monitoring: registers health routes
dashboard-web/server.mjs