How amirwebd3v/agentic-os works
Agentic OS is a local-first personal knowledge and automation app, with career workflows as its primary implemented product. The main user journey runs from the web UI through authenticated API routes into career processing, producing editable, reviewable drafts and tracked applications. Separate branches cover master-CV management, email triage, approvals, and dashboard/provider status. The graph follows documented and indexed relationships; unsampled mail and route internals are represented conservatively, so some links are omitted.
Main entry points: app.ts HTTP application · career-steps.ts Career step jobs · client.ts LLM client and usage ledger · App.vue Vue application
Components 28
Web interface
- Vue application
web/src/App.vue - Career views
web/src/views/ApplicationView.vue - Email views
web/src/views/EmailView.vue - Web API client
web/src/api.ts
Career workflows
- Career API routes
server/src/http/routes/career.ts - Master CV routes
server/src/http/routes/career-master.ts - Career step jobs
server/src/jobs/career-steps.ts - Posting intake
server/src/career/intake.ts - CV tailoring
server/src/career/tailor.ts - Draft model
server/src/career/draft.ts - Fit and verification
server/src/career/ats.ts - Cover letter
server/src/career/letter.ts - Document rendering
server/src/jobs/career-render.ts
Email workflows
- Email API routes
server/src/http/routes/email.ts - Mail analysis and triage
server/src/mail/triage.ts - Gmail sync
server/src/mail/sync.ts - Gmail authorization
server/src/mail/oauth.ts - Gmail client
server/src/mail/gmail.ts
Local platform
- HTTP application
server/src/app.ts - Local SQLite database
server/src/db/index.ts - Configured LLM provider
- LLM client and usage ledger
server/src/llm/client.ts - Personal knowledge vault
server/src/vault/writer.ts - Dashboard and status
server/src/http/routes/dashboard.ts - Approval workflow
server/src/approvals/apply.ts - Local email decider
server/src/decider/client.ts
Other components
- Personal user
- Laya sidecar
Connections 32
- Personal user → Vue application: uses
README.md - Vue application → Career views: routes to
- Vue application → Email views: routes to
- Career views → Web API client: requests data
web/src/views/ApplicationView.vue - Email views → Web API client: requests data
- Web API client → HTTP application: calls API
README.md - HTTP application → Career API routes: registers routes
server/src/main.ts - HTTP application → Master CV routes: registers routes
server/src/main.ts - HTTP application → Email API routes: registers routes
server/src/main.ts - HTTP application → Dashboard and status: registers routes
server/src/main.ts - HTTP application → Approval workflow: registers routes
- Career API routes → Career step jobs: dispatches jobs
server/src/http/routes/career.ts - Career step jobs → Posting intake: extracts requirements
server/src/jobs/career-steps.ts - Career step jobs → CV tailoring: reads and saves drafts
server/src/jobs/career-steps.ts - Career step jobs → Fit and verification: checks fit
server/src/jobs/career-steps.ts - Career step jobs → Cover letter: writes letter
server/src/jobs/career-steps.ts - Career API routes → Document rendering: requests rendering
server/src/http/routes/career.ts - Document rendering → Personal knowledge vault: writes documents
server/src/jobs/career-render.ts - Posting intake → LLM client and usage ledger: extracts with
server/src/career/intake.ts - Fit and verification → LLM client and usage ledger: checks with
server/src/career/ats.ts - Cover letter → LLM client and usage ledger: generates with
server/src/career/letter.ts - LLM client and usage ledger → Configured LLM provider: sends prompts
server/src/llm/client.ts - LLM client and usage ledger → Local SQLite database: records usage
server/src/llm/client.ts - Master CV routes → Personal knowledge vault: manages CV files
- Email API routes → Mail analysis and triage: dispatches analysis
- Email API routes → Gmail sync: starts sync
- Gmail sync → Gmail client: uses client
- Gmail authorization → Gmail client: uses client
server/src/mail/oauth.ts - Mail analysis and triage → Local email decider: may consult
- Local email decider → Laya sidecar: requests decisions
- Dashboard and status → Local SQLite database: reads status
- Approval workflow → Local SQLite database: applies approvals