---

🎯 Executive Overview & Profile

Career Agents is an open-source, local-first AI Career Operating System built for software engineers, tech candidates, and engineering managers.

Unifying 167 specialized AI agents across 19 domain divisions, a 20-language LeetCode Coding Studio with 240+ problems, local heuristic ATS Resume Grading, public GitHub Portfolio Auditing, search-visibility LinkedIn Profile Scanning, and interactive STAR Behavioral & System Design Mock Interviews — it replaces generic ChatGPT prompts and static resume templates with a context-aware career intelligence cockpit.

---

💻 Tech Stack & Integrations

Frontend & Architecture

AI Provider Gateways

---

⚡ Quickstart, NPM Installation & IDE Setup

1. 📦 NPM & NPX Execution Guide

# Global NPM Installation
npm install -g career-agents

# Zero-Install NPX Execution
npx career-agents list
npx career-agents score my_resume.pdf
npx career-agents mcp

2. 🚀 How to Run Web App Locally (Under 5 Minutes)

# 1. Clone the repository
git clone https://github.com/karthikrshet/Career-Agents.git
cd Career-Agents

# 2. Install web dependencies
cd apps/web
npm install

# 3. Setup environment configuration
cp .env.example .env

# 4. Start local development server
npm run dev

Open http://localhost:3000 or https://career-agents.vercel.app.

3. 🔌 How to Connect MCP Protocol Server to your IDE

Expose Career Agents tools directly to Cursor AI, Claude Desktop, VS Code, Windsurf, or Aider:

Command to register in IDE:

node /absolute/path/to/Career-Agents/mcp/server.js

📍 Claude Desktop Setup (claude_desktop_config.json):

{
  "mcpServers": {
    "career-agents": {
      "command": "node",
      "args": ["/absolute/path/to/Career-Agents/mcp/server.js"]
    }
  }
}

📍 Cursor AI Setup:

Go to Settings -> Features -> MCP -> Add new MCP Server:

• Name: career-agents
• Type: stdio
• Command: node /absolute/path/to/Career-Agents/mcp/server.js

4. 🖥️ Terminal CLI Utilities

Run terminal commands anywhere using scripts/cli.js:

Command	Arguments	Purpose	Example
list	None	Lists all registered divisions and agents	node scripts/cli.js list
doctor	None	Performs health checks	node scripts/cli.js doctor
score	<filepath>	Scans PDF/Word resumes and outputs ATS score	node scripts/cli.js score resume.pdf
review	<filepath>	Performs weak bullet checking and verb audits	node scripts/cli.js review resume.pdf
github	<username>	Runs portfolio wrapped check for target profile	node scripts/cli.js github torvalds
mock	<company> <mode>	Starts a terminal mock interview drill	node scripts/cli.js mock google behavioral
roadmap	<target>	Generates study roadmaps in markdown formats	node scripts/cli.js roadmap "staff engineer"

---

📸 Complete Product Visual Showcase

---

⚡ Complete Feature Matrix & Capabilities

Feature Module	CLI Utility	Web Dashboard	MCP Server
Agent Directory Search (167 Agents)	✅	✅	✅
20-Language Coding Studio Compiler	✅	✅	✅
240+ LeetCode Problem Catalog	✅	✅	✅
Step-by-Step Algorithm Visualizer	❌	✅	✅
Whiteboard Canvas & System Design	❌	✅	❌
20 ATS Resume Templates & Calibrator	✅	✅	✅
GitHub Profile Wrapped Audit	✅	✅	✅
LinkedIn Headline & Keyword Audit	✅	✅	✅
STAR Mock Interview Engine (10 Tracks)	✅	✅	✅
Job Opportunities Hub & ATS Match	❌	✅	✅
Kanban Application Tracker	❌	✅	✅
Multi-Provider AI Router (18 Backends)	✅	✅	✅
PDF / DOCX / XLSX Dossier Exporter	❌	✅	✅
Local SQLite & Offline Guest Mode	✅	✅	✅

---

🤖 167 Agent Ecosystem (19 Divisions)

Career Agents manages 167 specialized AI agents categorized across 19 divisions. When a user sends a query to the Copilot, the routing engine tokenizes the input and compares it against agent names, descriptions, tags, and required skills to construct a matching scorecard:

Score = (Exact Name Match * 15) + (Keyword Match * 3) + (Skill Match * 2) + (Domain Booster * 12)

The top matching agents with score >= 5 are loaded dynamically, reading their raw Markdown prompt instructions from disk and appending them to the LLM system context.

Division Summary Table

Career Division (career)

Placement strategy, resume engineering, interview coaching, and personal brand growth for students and job seekers.

Agent Name	Status	Purpose / Description
ATS Resume Reviewer	Live	A focused, line-by-line resume auditor who optimizes resume structure, language, and keyword signaling to survive ATS parsing and convert recruiter skim-time into interview invites.
Career Accountability Coach	Live	A structured, non-judgmental accountability partner who converts career goals into weekly commitments, tracks follow-through with honest data, diagnoses why execution is failing, and rebuilds momentum when it stalls — without letting candidates off the hook or crushing them with guilt.
Career Pivot to Tech Advisor	Live	A transition strategist for non-technical professionals entering the tech industry — covering entry point selection (software engineering, product, data, UX, technical sales, DevRel, and more), learning path design, portfolio development, narrative construction, and the tactical job search mechanics specific to tech industry hiring.
Career Roadmap Strategist	Live	A long-horizon career architect who builds milestone-based, decade-spanning career roadmaps — turning vague ambitions into sequenced, evidence-gated development plans that compound skill, reputation, and leverage over time.
Career Transition Coach	Live	A decisive, pattern-aware career transition coach who helps professionals move from one field, function, or industry into another — by mapping transferable assets, designing bridge strategies, and turning "I don't have the background for this" into a concrete, evidence-backed plan that works.
Diversity & Inclusion Career Coach	Live	A career strategist specializing in helping underrepresented professionals navigate systemic barriers, bias in hiring, and unequal advancement dynamics — providing concrete, evidence-informed strategies that turn awareness of barriers into actionable career architecture.
Executive Job Search Coach	Live	A senior-level career strategist who helps VP, Director, and C-suite professionals navigate the fundamentally different world of executive hiring — where most roles never appear on job boards, where personal brand and reputation are the primary search vehicles, and where the quality of your board and peer network determines your access more than your resume.
Freelance Career Advisor	Live	A pragmatic freelance business strategist who helps independent professionals build sustainable, client-diversified freelance careers — covering rate-setting, client acquisition, portfolio positioning, contract fundamentals, and the transition from feast-or-famine to predictable income.
Graduate Career Advisor	Live	A strategic first-job advisor for recent graduates who cuts through the noise of "apply everywhere" and "network more" to build targeted, evidence-backed launch strategies that get new graduates into the right first role — not just any role — within a realistic timeline.
HR Interview Coach	Live	A behavioural and offer-readiness coach who prepares candidates for HR and cultural interviews, designs story-driven answers to behavioural prompts, and leads offer evaluation and negotiation prep with professional rigor.
Internship Application Strategist	Live	An internship application strategist who helps students package their skills, target hiring windows, and win sought-after internship roles.
Internship Success Coach	Live	A hands-on internship performance coach who helps interns move from "showing up" to "standing out" — by building visibility, delivering meaningful work, converting internships into return offers, and treating every internship as a twelve-week audition with a clear performance plan.
Job Search Strategist	Live	A job search strategist who builds targeted application plans, opportunity funnels, and outreach systems for faster interview traction.
LinkedIn Growth Advisor	Live	A tactical growth advisor for LinkedIn who optimizes profiles for recruiter discovery, builds content strategies that surface domain credibility, and converts passive profile views into active opportunities.
Networking Coach	Live	A strategic, relationship-first networking coach who transforms transactional connection requests into genuine professional relationships — helping candidates build the kind of network that surfaces hidden job market opportunities, generates warm referrals, and compounds in value over an entire career.
Offer Evaluation Advisor	Live	An offer evaluation advisor who helps candidates compare multiple opportunities and choose the best role for their career goals.
Personal Branding Advisor	Live	A strategic personal brand architect who builds authentic, channel-consistent professional identities that attract the right opportunities — turning scattered professional presence into a coherent, searchable, memorable signal that does career work even when the candidate isn't actively job hunting.
Placement Coach	Live	An end-to-end placement strategist who audits your readiness, builds a prioritized action plan, and drives you from "applying blind" to "negotiating offers" with the discipline of someone who has watched a thousand placement cycles play out.
Product Manager Coach	Live	A rigorous PM career coach who helps aspiring and practicing product managers break into the discipline, ace PM interviews at any company tier, build product intuition through structured practice, and advance from APM to VP of Product — with frameworks grounded in how the best PMs actually think, not in what sounds good in a textbook.
Recruiter Outreach Specialist	Live	A recruiter outreach specialist who crafts message sequences and outreach plans to get recruiters to respond and move candidates into hiring conversations.
Remote Work Advisor	Live	A strategic remote-work specialist who helps professionals find, land, and thrive in remote roles — covering remote-specific job search tactics, distributed team visibility, async communication mastery, home office optimization, and the specific career risks that remote work creates if not managed deliberately.
Resume Strategist	Live	A narrative-focused resume strategist who crafts role-driven career stories, aligns achievements to hiring criteria, and builds resume ecosystems (resume, LinkedIn, portfolio) that consistently convert interest into interviews.
Returnship Coach	Live	A re-entry specialist who helps professionals return to the workforce after a career break — reframing gaps, rebuilding confidence, refreshing skills, and designing targeted re-entry strategies that land roles that respect the candidate's full experience, not just their most recent role.
Salary Benchmark Analyst	Live	A rigorous, data-literate compensation analyst who builds evidence-based salary benchmarks, deconstructs total compensation packages, and arms candidates with the market intelligence and framing to negotiate from facts rather than hope.
Salary Negotiation Coach	Live	A salary negotiation specialist who prepares candidates to evaluate offers, build leverage, and negotiate compensation confidently.
Performance Review Advisor	Live	A feedback strategy specialist who coaches professionals to design pre-review evidence campaigns, write compelling self-assessments, and conduct productive review conversations.
Career Risk Assessor	Live	A strategic career risk analyst who identifies threats to long-term professional growth, evaluates market vulnerability, and designs mitigation plans to improve career resilience.
Executive Presence Coach	Live	A leadership communication specialist who develops executive presence, stakeholder influence, decision-making confidence, and organizational visibility.
Graduate School vs Industry Advisor	Live	A career decision strategist who helps professionals evaluate graduate education versus direct industry experience using ROI, opportunity cost, and long-term career outcomes.
International Job Search Coach	Live	A global mobility specialist who guides professionals through international hiring markets, relocation planning, visa considerations, and cross-border career transitions.
Promotion Readiness Coach	Live	A career advancement advisor who evaluates promotion readiness, identifies competency gaps, and develops evidence-backed advancement strategies.
Relocation Strategy Advisor	Live	A relocation planning specialist who helps professionals evaluate geographic moves, compensation adjustments, lifestyle tradeoffs, and long-term career impact.
Technical Interview Coach	Live	A hands-on technical interview coach who prepares candidates for data structures & algorithms, system design, and role-specific coding rounds through targeted drills, rubric-based feedback, and measurable progression plans.

Company Interviews Division (company-interviews)

Target-company-specific interview coaches for FAANG, tier-1 product companies, and tech giants.

Agent Name	Status	Purpose / Description
Adobe Interview Coach	Live	A creativity-meets-engineering specialist who prepares candidates for Adobe's blend of technical rigor and genuine product-craft sensibility, where caring about the actual user experience of the tools you build is a real evaluation signal.
Amazon Interview Coach	Live	A Leadership Principles specialist who knows that Amazon interviews are won or lost on STAR-structured stories mapped precisely to specific principles, not generic behavioral answers with an Amazon logo pasted on top.
Atlassian Interview Coach	Live	A values-driven collaboration specialist who prepares candidates for Atlassian's structured, values-mapped interview loop, where "open company, no bullshit" is an actual evaluation criterion, not just a wall poster.
Google Interview Coach	Live	A structured-rigor specialist for Google's algorithm-heavy, googleyness-aware interview loop, who treats clean code communication and structured problem decomposition as non-negotiable, not optional polish.
Meta Interview Coach	Live	An execution-speed and impact-obsessed coach who prepares candidates for Meta's fast-paced technical bar and its distinct "move fast, focus on impact" behavioral evaluation.
Microsoft Interview Coach	Live	A growth-mindset and collaborative-problem-solving specialist who prepares candidates for Microsoft's blend of technical depth and "how do you work with others" evaluation, including the as-appropriate design/coding rounds.
Netflix Interview Coach	Live	A radical-candor and high-judgment specialist who prepares candidates for Netflix's uniquely direct culture interviews, where "would I fight to keep this person" is the real question behind every round.
Oracle Interview Coach	Live	A fundamentals-first specialist who prepares candidates for Oracle's traditionally rigorous CS-fundamentals and systems-depth interview style, where solid, unglamorous engineering knowledge is genuinely rewarded.
Salesforce Interview Coach	Live	A trust-and-customer-success specialist who prepares candidates for Salesforce's values-and-relationship-driven interview culture, where "trust is our #1 value" is treated as a real evaluation lens, not a slogan.
Uber Interview Coach	Live	A scale-and-ownership specialist who prepares candidates for Uber's operationally intense, ownership-driven interview culture, where "built for scale, obsessed with the details that break at scale" is the actual bar.
Apple Interview Coach	Live	A hardware-software craftsmanship and technical perfection coach who prepares candidates for Apple's deep systems loops, Swift/C++ architecture, and privacy-first product evaluation.
Anthropic Interview Coach	Live	An AI safety, Constitutional AI, and research-engineering coach who prepares candidates for Anthropic's deep model architecture, scaling, and alignment interview loops.
Databricks Interview Coach	Live	A distributed systems, database internals, and Spark engine specialist who prepares candidates for Databricks' deep concurrency, storage engine, and query optimization loops.
Nvidia Interview Coach	Live	A GPU architecture, CUDA kernel, and high-performance systems coach who prepares candidates for Nvidia's parallel computing, C++ performance, and AI hardware-software loops.
OpenAI Interview Coach	Live	A frontier model research and distributed infrastructure coach who prepares candidates for OpenAI's rigorous technical loops, PyTorch/Triton mechanics, and AI safety culture.
Stripe Interview Coach	Live	A practical engineering, API craft, and production refactoring coach who prepares candidates for Stripe's unique hands-on coding, bug-squashing, and integration interview loops.

Engineering Division (engineering)

Software architecture, database design, Next.js performance tuning, DevOps infrastructure, and senior-level code reviews.

Agent Name	Status	Purpose / Description
Backend Architect	Live	An API and service-design reviewer who evaluates backend architecture for the failure modes that don't show up until real load, real edge cases, and real time have all had a chance to find them.
Code Reviewer	Live	A senior-level code reviewer who triages real risk instead of nitpicking style, distinguishing "this will break in production" from "this is a preference" and never letting the two get confused.
Database Engineer	Live	A schema and query optimization specialist who reads execution plans instead of guessing, and treats indexing strategy as a precise discipline rather than a "just add an index" reflex.
DevOps Engineer	Live	A CI/CD and infrastructure reliability specialist who treats deployment pipelines as production systems in their own right, obsessed with reversibility, observability, and never being surprised by a failure.
MERN Architect	Live	A full-stack architecture reviewer for MongoDB/Express/React/Node applications who evaluates real scalability and maintainability tradeoffs instead of rubber-stamping whatever framework is trendy this year.
Next.js Performance Engineer	Live	A performance auditor obsessed with real Core Web Vitals and actual user-perceived speed, who diagnoses Next.js applications the way a profiler does — with numbers, not vibes.

Interview Division (interview)

Specialized interview coaching, system design, mock interviewing, behavioral strategies, and group discussions.

Agent Name	Status	Purpose / Description
Behavioral Interview Specialist	Live	A behavioral interview drilling coach who helps candidates structure stories using STAR/STAR+ structures, handles high-pressure situational queries, and maps achievements to organizational leadership principles.
Group Discussion Coach	Live	A facilitation and group communication coach who prepares candidates for group discussions, case studies, and collaborative rounds by teaching moderation, active listening, structured entry, and collaborative leadership.
Leadership Interview Coach	Live	A leadership coaching specialist who prepares senior candidates for executive, management, and leadership interviews — focusing on vision, organization building, decision-making, and organizational conflict.
Mock Interviewer	Live	A realistic, high-fidelity mock interviewer that conducts role-play simulations, dynamically probes candidate answers, handles follow-up queries, and provides rigorous feedback.
System Design Coach	Live	A technical interview coach specializing in distributed systems, scalability, and system design interviews — covering requirements gathering, API design, data modeling, high-level architecture, and deep-dive bottlenecks.
Voice Mock Interviewer	Live	A real-time voice-first mock interviewer supporting STT/TTS speech turn-taking, voice modulation diagnostics, semantic replies, and structured FAANG/MANGO 5-phase interview execution.

Networking Division (networking)

LinkedIn outreach, alumni networking, cold email strategies, recruiter communications, and referral acquisition.

Agent Name	Status	Purpose / Description
Alumni Networking Advisor	Live	A campus and school affinity networking strategist who helps candidates locate, re-engage, and leverage university and corporate alumni networks for career insights and referrals.
Cold Outreach Specialist	Live	A cold communication copywriter and strategist who helps candidates write highly optimized cold emails and messages to hiring managers, founders, and leaders.
LinkedIn Outreach Specialist	Live	A digital networking expert who helps candidates write highly customized, high-conversion LinkedIn messages for informational interviews, warm introductions, and job inquiries.
Recruiter Communication Coach	Live	A communication strategist who helps candidates manage recruiter channels, script outreach messages, prepare for screening calls, and negotiate communication touchpoints.
Referral Strategy Coach	Live	A relationship monetization strategist who helps candidates turn casual professional interactions, alumni links, and warm networks into formal job referrals and active internal advocates.

Projects Division (projects)

Final Year Project lifecycle support from topic selection and research planning to documentation and viva defense.

Agent Name	Status	Purpose / Description
Documentation Specialist	Live	A technical documentation agent that turns project outputs into clear reports, manuals, and presentation-ready artifacts.
Final Year Project Advisor	Live	A FYP coach who helps students select, scope, and defend academic projects with real-world structure and evaluation clarity.
Research Assistant	Live	A structured research partner for literature reviews, methodology planning, and academic sourcing.
Viva Coach	Live	A viva preparation coach that helps students structure defense responses, anticipate examiner questions, and present confidently.

Resume Division (resume)

Technical resume writing, achievement optimization, ATS formatting, design portfolios, and executive resumes.

Agent Name	Status	Purpose / Description
Executive Resume Advisor	Live	A senior-level resume strategist who helps VPs, Directors, and C-suite executives structure their resumes to emphasize executive presence, strategic scope, P&L ownership, and board visibility.
Portfolio Reviewer	Live	A design and technical portfolio critic who helps designers, engineers, and product managers structure, document, and present their work through compelling case studies that prove competency.
Resume Achievement Writer	Live	A metrics-focused resume achievement writer who helps candidates translate standard job duties into high-impact, outcome-oriented achievements using the STAR, Google X-Y-Z, and CAR frameworks.
Resume Formatting Specialist	Live	A design and layout expert who ensures resumes are visually polished, perfectly aligned, typographically balanced, and structured for maximum scannability and ATS compatibility.
Achievement Quantification Coach	Live	A resume impact specialist who transforms vague accomplishments into quantified, metric-driven achievements that demonstrate measurable business value.
Executive Resume Advisor	Live	A senior-level resume strategist specializing in leadership branding, executive storytelling, board-facing communication, and high-level career positioning.
Resume Bullet Generator	Live	A resume writing assistant that converts projects, responsibilities, and achievements into concise, ATS-friendly, action-oriented resume bullets.
Resume Gap Strategist	Live	A career narrative specialist who helps candidates address employment gaps, academic breaks, career transitions, and non-traditional experiences with confidence.
Technical Project Positioning Advisor	Live	A portfolio and resume strategist who helps engineers showcase technical projects, open-source contributions, and product impact for maximum recruiter appeal.
Resume Keyword Optimizer	Live	An ATS-oriented search optimization specialist who helps candidates align their resumes with target job descriptions using keyword mapping, context optimization, and phrase parsing strategies.
Resume Humanizer	Live	A specialized career writing agent that de-robotifies AI-generated resumes into authentic, high-impact human professional narratives while preserving ATS keyword signaling.
Document Exporter	Live	A specialized document layout and multi-format export engine that compiles resumes, cover letters, and portfolios into Word (.docx), PDF, HTML/CSS, and ATS plain-text templates.

Startup Division (startup)

Founder decision support, MVP definition, growth marketing strategy, and competitive market research.

Agent Name	Status	Purpose / Description
Founder Advisor	Live	A blunt, experienced-feeling co-founder substitute who stress-tests ideas and decisions the way a real early-stage advisor would — before money, time, or credibility get spent finding out the hard way.
Growth Strategist	Live	A growth specialist who designs acquisition, activation, retention, and monetization strategies for early-stage products.
Market Research Analyst	Live	A rigorous market research specialist who turns ambiguous business questions into defensible market insights, go-to-market priorities, and evidence-backed decisions — built for founders, product teams, and early-stage PMs who need market clarity fast.
Product Manager	Live	A product strategy advisor who turns fuzzy feature requests into prioritized roadmaps, stakeholder-aligned outcomes, and execution-ready release plans.

AI Engineering Division (ai-engineering)

Language models, prompt engineering, retrieval-augmented generation (RAG), cognitive agents, and machine learning operations (MLOps).

Agent Name	Status	Purpose / Description
AI Agent Architect	Live	Designs autonomous agent loops, tool bindings, planning algorithms, and multi-agent coordination layers.
AI Engineer Career Coach	Live	Coaches developers pivoting into artificial intelligence, structuring study plans, project portfolios, and technical interview prep.
AI Product Builder	Live	Helps founders and product managers scope AI features, evaluate API costs, and design user-centric AI feedback loops.
Computer Vision Engineer	Live	Advises on convolutional networks, object detection systems, segmentation pipelines, and edge device deployment.
Generative AI Consultant	Live	Guides organizations through generative AI strategy, risk mitigation, compliance, and ROI analysis.
LLM Engineer	Live	Advises on model selection, context window optimization, fine-tuning pipelines, and inference efficiency.
Machine Learning Engineer	Live	Designs classical ML systems, feature stores, model training pipelines, and dataset validations.
MLOps Engineer	Live	Sets up continuous training pipelines, model registries, monitoring systems, and containerized deployment infrastructure.
Prompt Engineer	Live	Designs systematic prompt templates, Few-Shot examples, Chain-of-Thought flows, and system instructions.
RAG Architect	Live	Designs semantic search architectures, vector databases, chunking strategies, and metadata indexing pipelines.
AI Infrastructure Architect	Live	An AI systems infrastructure specialist who architects distributed GPU training clusters, high-throughput vLLM/Triton serving pipelines, Ray cluster orchestration, and MLOps scaling.
AI Agent Workflow Builder	Live	An autonomous agent systems architect specializing in multi-agent orchestration, LangGraph, CrewAI, AutoGen, Model Context Protocol (MCP) tool integration, state machine control, and structured tool-call execution.
Multimodal AI Engineer	Live	A vision, speech, and cross-modal AI systems specialist who architects Vision-Language Models (VLMs), audio-speech processing pipelines (STT/TTS, Realtime Voice APIs), text-to-image/video generative pipelines, and multimodal vector embeddings.

Cloud & Infrastructure Division (cloud)

Public cloud systems, platform engineers, kubernetes clusters, infrastructure security, and site reliability.

Agent Name	Status	Purpose / Description
AWS Cloud Architect	Live	Designs highly available, secure, and well-architected systems on AWS.
Azure Cloud Engineer	Live	Configures and manages enterprise cloud deployments on Microsoft Azure.
Cloud Cost Optimizer	Live	Audits cloud invoices, identifying wastage, reserved instance coverages, and autoscaling opportunities.
Cloud Migration Advisor	Live	Plans datacenter migrations to public clouds using Rehost, Replatform, and Refactor pathways.
Cloud Security Advisor	Live	Reviews cloud security configurations, ensuring compliance with ISO 27001, SOC2, and CIS benchmarks.
GCP Cloud Engineer	Live	Designs scale-ready infrastructure on Google Cloud Platform using native services.
Kubernetes Specialist	Live	Configures production Kubernetes clusters, pod scheduling, network policies, and ingress controllers.
Platform Engineer	Live	Builds developer self-service tooling, landing zones, and continuous delivery systems.
Site Reliability Engineer	Live	Defines service level objectives, error budgets, incident response playbooks, and disaster recovery strategies.
Terraform Specialist	Live	Writes modular Terraform, structuring state files, workspace variables, and locks.

Cybersecurity Division (cybersecurity)

Secure coding principles, network operations, penetration testing, compliance advisors, and risk auditing.

Agent Name	Status	Purpose / Description
Application Security Specialist	Live	Audits application source code for OWASP Top 10 vulnerabilities, configuring SAST/DAST pipelines.
Cloud Security Engineer	Live	Implements IAM least privilege policies, cloud security posture monitoring, and secrets managers.
Ethical Hacking Advisor	Live	Conducts threat simulations and red-team operations across human, network, and application boundaries.
Governance Risk Compliance Advisor	Live	Audits processes and designs system configurations to satisfy compliance rules (SOC2, ISO 27001, GDPR).
Identity Access Management Specialist	Live	Designs directory service integrations, access management controls, and provisioning flows.
Incident Response Specialist	Live	Triages active security breaches, structures containment strategies, and performs digital forensics.
Penetration Testing Coach	Live	Runs network-level vulnerability assessments and simulated penetration testing.
Security Architect	Live	Designs global zero-trust security frameworks, IAM directories, and endpoint controls.
Security Engineer	Live	Designs secure infrastructure boundaries, perimeter defense networks, and encryption strategies.
Security Operations Analyst	Live	Analyzes security telemetry logs, configure SIEM dashboards, and responds to alerts.

Open Source Division (open-source)

Collaborative repository design, developer community building, open-source documentation, and maintainer guidance.

Agent Name	Status	Purpose / Description
Community Builder	Live	Designs community portals, discord guidelines, online events, and contributor recognition models.
Developer Advocate	Live	Bridges developer feedback with core product roadmaps, producing workshops and api demos.
DevRel Strategist	Live	Aligns developer programs with business metrics, tracking developer acquisitions and community ROI.
GitHub Growth Advisor	Live	Advises on repository metadata, README copywriting, issue curation, and community visibility.
Maintainer Coach	Live	Advises project leads on contributor onboarding, issue labeling, license compliance, and roadmap publishing.
Open Source Funding Advisor	Live	Guides projects on sponsor directories (GitHub Sponsors, Open Collective) and grant applications.
Open Source Mentor	Live	Coaches new contributors on git branches, repository issues, and pull request etiquette.
OSS Contributor Coach	Live	Helps developers scale contributions from single commits to regular maintainers of key libraries.
Project Maintenance Specialist	Live	Automates project builds, configuring lint rules, tests, and publishing workflows.
Technical Writing Advisor	Live	Guides developers in writing clean API guides, release notes, code reviews, and README docs.

Data Engineering Division (data-engineering)

Analytical warehouse construction, stream processors, pipeline schedulers, and database optimizations.

Agent Name	Status	Purpose / Description
Analytics Engineer	Live	Structures data transformation layers using dbt (data build tool), creating documentation and testing frameworks.
Business Intelligence Specialist	Live	Designs semantic datasets, dashboards, and analytical metrics using PowerBI or Tableau.
Data Architect	Live	Designs corporate data strategies, data mesh architectures, and warehouse schemas.
Data Engineer	Live	Designs robust analytical pipeline systems, feature databases, and ingestion engines.
Data Governance Advisor	Live	Defines access control policies, data cataloging rules, and column-level masking models.
Data Platform Engineer	Live	Deploys cloud-based data storage and analysis platforms using Snowflake, Databricks, or BigQuery.
Data Quality Engineer	Live	Designs automated validation routines, alerting systems, and data drift dashboards.
Database Performance Specialist	Live	Audits database resource consumption, index efficiency, and query logs to optimize latency.
ETL Specialist	Live	Designs high-throughput batch ETL/ELT pipelines using Airflow, Prefect, or Dagster.
Stream Processing Specialist	Live	Designs high-velocity real-time analytical event flows using Kafka or Flink.

Developer Relations Division (devrel)

Developer advocate strategies, technology education, community management, and developer experience.

Agent Name	Status	Purpose / Description
API Adoption Consultant	Live	Reviews developer APIs, SDK structures, and documentation onboarding to reduce activation barriers.
Community Growth Specialist	Live	Designs programmatic referral schemes, user acquisition initiatives, and event plans.
Conference Speaker Coach	Live	Guides developers in preparing technical talk submissions, slide structures, and slide delivery.
Content Strategy Advisor	Live	Plans technical content calendars, writing schedules, and publication distributions.
Developer Education Specialist	Live	Designs tutorials, structured learning paths, sample project repos, and technical documentation.
Developer Evangelist	Live	Presents product value at developer conferences, online meetups, and key technical forums.
Developer Experience Specialist	Live	Reviews local developer environments, CLI ease-of-use, config errors, and initial setup steps.
Developer Relations Manager	Live	Manages developer engagement programs, ambassador networks, and metric analysis.
Technical Community Builder	Live	Moderates developer forums, discord/slack servers, and handles user onboarding strategies.
Technical Marketing Advisor	Live	Aligns product positioning with developer interests, writing copy and analyzing competition.

Job Automation Division (job-automation)

Automated job discovery, listing filters, pipeline trackers, email outreach cadences, and funnel optimization engines.

Agent Name	Status	Purpose / Description
Job Hunter AI	Live	An automated job discovery and application tracking companion that manages target queues.
Job Application Optimizer	Live	An AI context tailoring engine that customizes applications, resume bullets, and cover letters for specific job descriptions at scale.

FAANG & Top Tech Division (faang)

Specialized technical and career coaches for FAANG and top-tier tech companies, focusing on rigorous coding loops, system design, and culture fit.

Agent Name	Status	Purpose / Description
OpenAI Career Coach	Live	A specialized coach for OpenAI interview loops, engineering culture, and AI research/engineering positions.
Google SWE Coach	Live	A specialized technical coach for Google Software Engineering (SWE) loops, focusing on DS & Algorithms, complex complexity analysis, clean code structure, and Googleyness & Leadership (G&L).
Meta SWE Coach	Live	A high-speed execution, performance-focused system design, and impact-driven engineering coach for Meta's software engineering loops.
Apple SWE Coach	Live	A specialized low-level systems, Swift/C++ architecture, and hardware-software integration coach for Apple Software Engineering loops.
Amazon SWE Coach	Live	A Leadership Principles, Bar Raiser standards, and high-scale distributed systems coach for Amazon SDE loops (SDE I, SDE II, Senior SDE).
Netflix SWE Coach	Live	A high-concurrency distributed systems, microservices resilience, and Freedom & Responsibility culture coach for Netflix Senior SWE loops.
Microsoft SWE Coach	Live	A Growth Mindset, cloud architecture, and enterprise CS fundamentals coach for Microsoft Software Engineer loops (SDE I, SDE II, Senior SDE, Principal SDE).
Anthropic AI Coach	Live	A Constitutional AI, model alignment infrastructure, and transformer scaling coach for Anthropic research and engineering loops.
Nvidia AI Coach	Live	A GPU systems, CUDA kernel optimization, TensorRT compiler, and deep learning hardware acceleration coach for Nvidia engineering loops.
FAANG Voice Mock Interviewer	Live	A voice-first FAANG & MANGO interview simulator tailored for Google, Meta, Amazon, Apple, Netflix, and OpenAI loops with company-specific pacing, voice modulation, and Bar Raiser evaluations.

AI Business Division (ai-business)

Strategic builders, technical PMs, and business architects focusing on launching and scaling AI-first startups, SaaS MVPs, and proprietary data loops.

Agent Name	Status	Purpose / Description
AI Founder	Live	A strategic AI builder focused on scaling AI-first products, MVPs, and business models.
AI Consultant	Live	An enterprise AI strategist mapping company problems to LLM/RAG solutions, scoping APIs, drafting security/privacy architectures, and showing ROI.
AI Product Growth Builder	Live	An AI product strategy and growth architecture coach who specializes in scoping AI SaaS MVPs, designing retention loops for LLM products, managing token API cost structures, and building defensible AI monetization models.

Modern GTM Division (gtm)

Outreach systems design, waterfall data enrichments, CRM synchronizations, webhooks, and programmatic pipeline automation.

Agent Name	Status	Purpose / Description
GTM Engineer	Live	An outreach systems architect who designs clay workflows, API enrichments, and automated cold inbound/outbound setup.
Clay Specialist	Live	A master of Clay workflows, waterfall search logic, AI enrichment prompting, data cleaning, and CSV normalization.

Freelancing Division (freelancing)

Productization, pricing advisory, retainer growth, client acquisition networks, and operation designs for independent consultants.

Agent Name	Status	Purpose / Description
Freelance Founder	Live	An independent consultant strategist driving retainer growth, pricing, and client acquisition channels.
Upwork Specialist	Live	A profile positioning and proposal writing advisor focused on converting Upwork feeds into closed contracts.

For the complete agent registry, see docs/AGENTS.md.

---

🗺️ Curated Career Paths (10 Paths)

AI Engineer

• Focus: Specialist in integrating machine learning, large language models, retrieval augmented generation, and cognitive agents into product architectures.
• Core Skills Required: LLMs & Prompt Engineering, RAG & Semantic Search, Python & PyTorch, Agentic Architectures, Model Orchestration
• Associated Coaches: ai-agent-architect, llm-engineer, rag-architect, ai-engineer-career-coach

Backend Engineer

• Focus: Specialized engineer focused on server-side logic, API design, database structures, security, caching, and scalability.
• Core Skills Required: API Design (REST/GraphQL), Database Architecture & Indexing, Distributed Systems, Server-Side Languages (Go, Python, Java, Node.js), Performance Engineering
• Associated Coaches: backend-architect, database-engineer, system-design-coach

Cloud Engineer

• Focus: Focused on provisioning public cloud infrastructure, maintaining high availability, designing scalable networks, and managing containerized systems.
• Core Skills Required: AWS / GCP / Azure, Terraform & IaC, Kubernetes & Containers, Networking & VPCs, Site Reliability (SRE)
• Associated Coaches: aws-cloud-architect, kubernetes-specialist, terraform-specialist, site-reliability-engineer

Cybersecurity Engineer

• Focus: Dedicated to securing software systems, identifying vulnerabilities, configuring access controls, and responding to security incidents.
• Core Skills Required: Application Security & OWASP, Identity & Access Management (IAM), Threat Modeling & Pen Testing, Incident Response & Forensics, Regulatory Compliance (SOC2/GDPR)
• Associated Coaches: application-security-specialist, cloud-security-engineer, incident-response-specialist, governance-risk-compliance-advisor

DevOps Engineer

• Focus: Bridging development and operations to automate software delivery pipelines, manage configuration state, and ensure infrastructure reliability.
• Core Skills Required: CI/CD Pipelines, Configuration Management, Infrastructure as Code, Monitoring & Logging, Build Tools & Packaging
• Associated Coaches: devops-engineer, platform-engineer, site-reliability-engineer

Frontend Engineer

• Focus: Specialized engineer focused on client-side applications, user interfaces, performance optimization, and modern web frameworks.
• Core Skills Required: JavaScript / TypeScript, React / Next.js, CSS & Styling, Web Vitals & Performance, API Integration
• Associated Coaches: nextjs-performance-engineer, portfolio-reviewer, ats-resume-reviewer

Full Stack Engineer

• Focus: Versatile engineer capable of building and maintaining both client-side and server-side components of modern web applications.
• Core Skills Required: Frontend Frameworks, Backend APIs, Database Design, Cloud Deployments, End-to-End Testing
• Associated Coaches: mern-architect, code-reviewer, placement-coach

Product Manager

• Focus: Connecting technology, business, and design to define product features, scope releases, prioritize roadmaps, and align cross-functional teams.
• Core Skills Required: Product Roadmap Planning, User Interviewing & Feedback, Prioritization Frameworks, Market & Competitor Analysis, Data-Driven Decisions
• Associated Coaches: product-manager, product-manager-coach, market-research-analyst

Software Engineer

• Focus: Generalist software engineer focused on building robust applications, CS fundamentals, algorithms, and collaborative team delivery.
• Core Skills Required: Data Structures & Algorithms, Object Oriented Design, System Design, Version Control (Git), Testing & Debugging
• Associated Coaches: google-interview-coach, technical-interview-coach, code-reviewer, mock-interviewer

Startup Founder

• Focus: Building a business from scratch, scoping MVPs, testing market fit, structuring go-to-market strategies, and managing early unit economics.
• Core Skills Required: MVP Scoping & Validation, Go-To-Market Execution, Unit Economics & Token Economics, Outreach Systems Design, Founder Pitching & Narrative
• Associated Coaches: founder-advisor, growth-strategist, ai-product-builder, market-research-analyst

---

🏢 Company Interview Tracks (16 Companies)

Adobe

• Interview Rounds: Recruiter screen, Technical phone screen: 1-2 coding and product-craft rounds (45-60 min), Onsite loop: 3 technical coding/systems design rounds, 1 cross-functional collaboration round, 1 product craft/manager round (45 min each)
• Key Competency Focus: Technical Depth & Product Framing, Product-Craft Story Development, Attention-to-Detail & UX Polish, Cross-Functional Collaboration
• Recommended Coaches: adobe-interview-coach, mock-interviewer, system-design-coach

Amazon

• Interview Rounds: Recruiter phone screen (30 min), Online Assessment (OA): 2 DSA coding challenges + Work Simulation + Work Style Assessment, Onsite loop (Full Loop): 4 rounds covering 16 Leadership Principles (STAR format), DSA Coding, Object-Oriented Design, and System Architecture with a Bar Raiser (45-60 min each)
• Key Competency Focus: 16 Leadership Principles (STAR method), Customer Obsession & Operational Excellence, Distributed System Design (AWS Primitives), Object-Oriented Design & DSA
• Recommended Coaches: amazon-interview-coach, amazon-swe-coach, behavioral-interview-specialist, system-design-coach, mock-interviewer

Anthropic

• Interview Rounds: Recruiter screen & research alignment call (30 min), Technical screen: PyTorch / Deep Learning Math & Systems Coding (60 min), Onsite loop: 4-5 rounds covering Neural Network Coding, High-Scale ML Systems Architecture, Alignment & Constitutional AI Frameworks, and Research Culture
• Key Competency Focus: AI Safety & Constitutional AI Frameworks, Transformer Scaling & Memory Bandwidth Profiling, PyTorch & Distributed Training Mechanics (FSDP), Empirical Research & Experiment Design
• Recommended Coaches: anthropic-interview-coach, anthropic-ai-coach, technical-interview-coach, system-design-coach, mock-interviewer

Apple

• Interview Rounds: Recruiter screening phone call (30 min), Technical phone screen / Domain deep-dive (45-60 min), Onsite loop: 4-6 rounds covering Systems Programming / DSA, Software Architecture, Domain Specialty, and Cross-functional Culture & Craft (45-60 min each)
• Key Competency Focus: Swift, SwiftUI & Objective-C / C++ Architecture, Systems Programming & Memory Management (RAII, ARC, Pointers), Hardware-Software Integration & OS Design Fundamentals, Product Craft, Privacy Principles & Attention to Detail
• Recommended Coaches: apple-interview-coach, apple-swe-coach, technical-interview-coach, system-design-coach, mock-interviewer

Atlassian

• Interview Rounds: Recruiter screen and interactive coding challenge, Onsite loop: 1 system design round, 1 coding round, 1 values fit round, 1 management/behavioral round
• Key Competency Focus: Atlassian core values (Open Company No Bullshit), Collaborative system design structures, Active listening and giving structured feedback, Frontend UI performance and layout
• Recommended Coaches: atlassian-interview-coach, behavioral-interview-specialist, group-discussion-coach, mock-interviewer

Databricks

• Interview Rounds: Recruiter screening phone call (30 min), Technical phone screen: Systems Coding / Database Algorithm round (60 min), Onsite loop: 4-5 rounds covering High-Concurrency Systems Coding, Storage Engine & Query Architecture, Distributed Infrastructure System Design, and Culture
• Key Competency Focus: Distributed Query Engines & Vectorized Execution, Database Internals (LSM-trees, MVCC, Concurrency), Apache Spark & Delta Lake Internals, Systems Programming & Memory Management
• Recommended Coaches: databricks-interview-coach, database-engineer, backend-architect, system-design-coach, mock-interviewer

Google

• Interview Rounds: Recruiter screening phone call (30 min), Technical phone screen: 1 DSA coding round (45 min), Onsite loop: 3 DSA coding rounds, 1 System Design round, 1 Googliness & Leadership round (45 min each)
• Key Competency Focus: Data Structures & Algorithms (graphs, dynamic programming, trees), System Design & Scalability, Googliness (cultural fit, collaboration, ambiguity navigation), Space & Time Complexity Analysis
• Recommended Coaches: google-interview-coach, google-swe-coach, technical-interview-coach, system-design-coach, mock-interviewer

Meta

• Interview Rounds: Recruiter screening phone call (30 min), Technical phone screen: 2 DSA coding problems in 45 min, Onsite loop: 2 DSA coding rounds (2 problems in 45 min each), 1 System Design round (Product or Systems Architecture), 1 Behavioral / Move Fast & Focus on Impact round
• Key Competency Focus: High-speed coding execution & accuracy, Meta-scale System Design (Feed, Messenger, TAO Caching), Move Fast & Focus on Impact behavioral alignment, Social Graph & Distributed Systems
• Recommended Coaches: meta-interview-coach, meta-swe-coach, technical-interview-coach, system-design-coach, mock-interviewer

Microsoft

• Interview Rounds: Recruiter screening phone call (30 min), First-round technical screen / OA: 1-2 coding problems (45-60 min), Onsite loop (As-One Loop): 4-5 rounds covering CS Fundamentals & Coding, System Design, and Growth Mindset / Behavioral Alignment
• Key Competency Focus: Computer Science Fundamentals (OS, Networking, Data Structures), Enterprise & Cloud System Architecture (Azure), Collaborative Problem Solving & Growth Mindset, Multi-tenant SaaS & Identity Management
• Recommended Coaches: microsoft-interview-coach, microsoft-swe-coach, technical-interview-coach, system-design-coach, mock-interviewer

Netflix

• Interview Rounds: Recruiter screening phone call (30 min), Technical phone screen: High-concurrency systems / Senior coding (60 min), Onsite loop: 4-5 rounds covering Senior Distributed System Design, Microservices Resilience & Chaos Engineering, Technical Deep-Dive, and Freedom & Responsibility Culture
• Key Competency Focus: Freedom & Responsibility Culture Alignment, High-Concurrency Distributed Microservices, Chaos Engineering & Fault Isolation, Global Streaming & Edge CDN Architectures
• Recommended Coaches: netflix-interview-coach, netflix-swe-coach, behavioral-interview-specialist, system-design-coach, mock-interviewer

Nvidia

• Interview Rounds: Recruiter screening phone call (30 min), Technical phone screen: C++ Systems Programming / Parallel Algorithms (60 min), Onsite loop: 4-5 rounds covering CUDA Kernel Optimization, Systems C++, GPU Architecture & Interconnects, and AI Hardware Acceleration
• Key Competency Focus: C++ Systems Programming & Memory Alignment, CUDA Parallel Computing & SIMT Execution Model, GPU Hardware Architecture & NVLink Topology, Deep Learning Acceleration & TensorRT Quantization
• Recommended Coaches: nvidia-interview-coach, nvidia-ai-coach, technical-interview-coach, system-design-coach, mock-interviewer

OpenAI

• Interview Rounds: Recruiter screen & domain alignment call (30 min), Technical phone screen: PyTorch / Distributed Coding or Systems Deep Dive (60 min), Onsite loop: 4-5 rounds covering Neural Network Coding / Autograd, Distributed ML Systems Architecture, Applied AI / Infrastructure, and Mission & Safety Alignment (60 min each)
• Key Competency Focus: PyTorch & Triton Distributed Training Mechanics, Transformer Architecture & KV Cache Optimizations, Frontier AI Infrastructure & LLM Serving, AI Safety, Alignment & Scaling Laws
• Recommended Coaches: openai-interview-coach, openai-career-coach, technical-interview-coach, system-design-coach, mock-interviewer

Oracle

• Interview Rounds: Recruiter phone screen, Technical screening: 1-2 CS fundamentals and database queries rounds (45-60 min), Onsite Loop: 3-4 rounds focused on CS fundamentals, database design, networking protocols, and systems design (45 min each)
• Key Competency Focus: CS Fundamentals (OS, Networking), Database Internals & SQL Design, Algorithmic Problem-Solving, Multi-Round Endurance
• Recommended Coaches: oracle-interview-coach, mock-interviewer, database-engineer, system-design-coach

Salesforce

• Interview Rounds: Recruiter screening phone call (30 min), Technical screening: 1 coding round / portfolio review (45-60 min), Onsite loop: 2 technical coding rounds, 1 system architecture round, 1 core values & trust-alignment round (45 min each)
• Key Competency Focus: Core Values & Trust Alignment, Customer Success Orientation, System Architecture & SaaS Scaling, Data Structures & Algorithms
• Recommended Coaches: salesforce-interview-coach, mock-interviewer, system-design-coach

Stripe

• Interview Rounds: Recruiter screening phone call (30 min), Technical screen: Practical API design / Coding round (60 min), Onsite loop: 4-5 rounds covering Practical Engineering (Bug Hunting / Extension), API Design, System Architecture (Financial Systems & Idempotency), and Culture/Integration
• Key Competency Focus: Practical API & SDK Ergonomics Design, Codebase Refactoring & Defensive Error Handling, Financial System Design & Idempotency, Backward Compatibility & Integration Testing
• Recommended Coaches: stripe-interview-coach, code-reviewer, backend-architect, technical-interview-coach, mock-interviewer

Uber

• Interview Rounds: Recruiter screen and online coding test, Technical phone interview: coding and systems baseline questions, Onsite loop: 2 coding rounds, 2 system architecture scaling rounds, 1 behavioral bar raiser round
• Key Competency Focus: Geohashing and spatial search coordinates index (H3, S2), Real-time stream message scheduling, High write concurrency structures, Fault-tolerance modeling
• Recommended Coaches: uber-interview-coach, system-design-coach, database-engineer, mock-interviewer

---

⚡ Workflow Automation Pipelines (10 Workflows)

• ATS Optimization: A repeatable resume operating system for candidates who apply through portals, campus systems, and enterprise hiring platforms. Optimizes resume structures, headings, and keyword mapping to survive ATS parsing.
  • Recommended Agents: ats-resume-reviewer, resume-strategist, job-search-strategist, linkedin-growth-advisor, placement-coach
• FAANG Preparation: Targeted preparation pipeline for high-tier tech companies (FAANG+), aligning algorithms, system design, and leadership principles prep.
  • Recommended Agents: google-interview-coach, amazon-interview-coach, meta-interview-coach, microsoft-interview-coach, system-design-coach, mock-interviewer
• Fresher Placement: Step-by-step guidance for college students and recent grads navigating their first job hunt and campus placement cycles.
  • Recommended Agents: placement-coach, graduate-career-advisor, ats-resume-reviewer, mock-interviewer, networking-coach
• HR Interview Week: Intense behavioral prep week covering common HR screening, culture fit, and soft-skill evaluation challenges.
  • Recommended Agents: hr-interview-coach, behavioral-interview-specialist, mock-interviewer, recruiter-communication-coach
• Internship Hunt: Tactical action plan for finding, applying to, and landing summer/semester internships.
  • Recommended Agents: internship-application-strategist, networking-coach, ats-resume-reviewer, cold-outreach-specialist, graduate-career-advisor
• LinkedIn Growth: Personal branding and network expansion strategy to attract recruiters, founders, and industry peers.
  • Recommended Agents: linkedin-growth-advisor, personal-branding-advisor, networking-coach, recruiter-outreach-specialist
• Offer Comparison: Analytical approach to evaluating multiple job offers across total compensation, equity, career growth, and work-life balance.
  • Recommended Agents: offer-evaluation-advisor, salary-benchmark-analyst, salary-negotiation-coach
• Remote Job Hunt: Navigating the specialized remote job market, optimizing for global companies, and establishing remote collaboration proof.
  • Recommended Agents: remote-work-advisor, job-search-strategist, cold-outreach-specialist, linkedin-outreach-specialist
• Salary Negotiation: Tactics and script preparation for maximizing base salary, equity, and benefits during the offer stage.
  • Recommended Agents: salary-negotiation-coach, salary-benchmark-analyst, offer-evaluation-advisor, recruiter-communication-coach
• Technical Interview Week: High-intensity technical prep covering DSA drills, system design practice, and clean code principles.
  • Recommended Agents: technical-interview-coach, system-design-coach, mock-interviewer, code-reviewer

---

🏗️ System Architecture & Data Flow

1. Web Application & AI Router Request Flow

sequenceDiagram
    participant User as User / Browser
    participant Client as Next.js 14 App Client
    participant Router as Multi-Provider AI Gateway
    participant LLM as AI Provider (Groq / Gemini / OpenAI / Claude)
    participant DB as Browser LocalStorage / SQLite / Postgres
    
    User->>Client: Send Copilot Query / Resume File
    Client->>Router: Forward Query + Active User Dossier
    Router->>Router: Match 167 Agent Registry & Compile System Prompt
    Router->>LLM: Dispatch Request with Fallback Chain
    LLM-->>Router: Stream Tokens via Server-Sent Events (SSE)
    Router-->>User: Render Real-Time Markdown & Code Output
    Client->>DB: Persist Session Metrics & Chat History

2. Model Context Protocol (MCP) Stdio Architecture

graph LR
    IDE[Developer Editor / Client] -->|JSON-RPC via stdio| MCPServer[mcp/server.js MCP Server]
    MCPServer -->|Read Registries| Registry[(agent-registry.json)]
    MCPServer -->|Execute Tools| CoreScripts[scripts/cli.js / Resume / GitHub Engine]
    CoreScripts -->|Structured Response Payload| IDE

---

🌐 AI Gateway & Supported Providers (18 Backends)

Career Agents features a multi-provider gateway supporting 18 AI backends with zero-key guest fallbacks:

Provider	Status	Default Model	Free Tier	Streaming	Vision
Groq	✅ Active	llama-3.3-70b-versatile	✅ Yes	✅ Yes	❌
Google Gemini	✅ Active	gemini-2.5-pro	✅ Yes	✅ Yes	✅ Yes
OpenAI	✅ Active	gpt-4o	❌ No	✅ Yes	✅ Yes
Anthropic Claude	✅ Active	claude-3-5-sonnet-20241022	❌ No	✅ Yes	✅ Yes
DeepSeek	✅ Active	deepseek-chat	❌ Cheap	✅ Yes	❌
OpenRouter	✅ Active	meta-llama/llama-3.1-405b	✅ Yes	✅ Yes	✅ Yes
Together AI	✅ Active	meta-llama/Llama-3-70b-chat	❌ No	✅ Yes	❌
Mistral	✅ Active	mistral-large-latest	❌ No	✅ Yes	❌
Cohere	✅ Active	command-r-plus	✅ Trial	✅ Yes	❌
xAI Grok	✅ Active	grok-2	❌ No	✅ Yes	❌
Azure OpenAI	✅ Active	Custom deployment	❌ Enterprise	✅ Yes	✅ Yes
Ollama	✅ Active (Local)	User pulled (llama3.3)	✅ Yes	✅ Yes	❌
LM Studio	✅ Active (Local)	Custom loaded GGUF	✅ Yes	✅ Yes	❌
Fireworks AI	✅ Active	llama-v3-70b-instruct	❌ No	✅ Yes	❌
Perplexity	✅ Active	llama-3.1-sonar-large	❌ No	✅ Yes	❌
AI21 Labs	✅ Active	jamba-1.5-large	❌ No	✅ Yes	❌
OpenAI Compatible	✅ Active	Custom loaded model	✅ Yes	✅ Yes	✅ Yes
Custom Endpoint	✅ Active	Custom loaded model	✅ Yes	✅ Yes	✅ Yes

---

🔌 Model Context Protocol (MCP) IDE Setup

Expose Career Agents tools directly to your AI code editors:

Supported Editors

• Cursor AI: Add stdio command node /absolute/path/to/Career-Agents/mcp/server.js under Settings -> Features -> MCP.
• Claude Desktop: Add configuration block to claude_desktop_config.json.
• VS Code (Continue Extension): Add to .continue/config.json.
• Windsurf / Aider / Roo Code / Bolt: Configure stdio parameters to point to the local server script.

Configuration Example (claude_desktop_config.json)

{
  "mcpServers": {
    "career-agents": {
      "command": "node",
      "args": ["/absolute/path/to/Career-Agents/mcp/server.js"]
    }
  }
}

---

📦 NPM Package Installation & Usage

You can install and execute Career Agents directly via NPM or NPX:

1. 🌐 Global NPM Installation

# Install globally via NPM
npm install -g career-agents

# Execute CLI utilities anywhere
career-agents list
career-agents score my_resume.pdf
career-agents github torvalds

2. ⚡ Zero-Install NPX Execution

# Run CLI directly without global installation
npx career-agents list

# Start local MCP Stdio Server for IDEs
npx career-agents mcp

# Audit resume against ATS standards
npx career-agents score resume.pdf

3. 📦 Programmatic SDK Integration (Node.js / TypeScript)

import { CareerAgents } from 'career-agents';

// Initialize SDK instance
const agents = new CareerAgents();

// Query 167 agent directory
const matches = agents.matchAgents("Senior Backend Engineer system design");
console.log(matches);

---

⚙️ Setup & Local Development

Prerequisites

• Node.js >= 18.0.0 (Node 20 LTS recommended)
• Git
• Python 3.9+ (required for data compilation scripts)

Quick Start (Under 5 Minutes)

# 1. Clone the repository
git clone https://github.com/karthikrshet/Career-Agents.git
cd Career-Agents

# 2. Install web application dependencies
cd apps/web
npm install

# 3. Setup environment variables
cp .env.example .env
# Edit .env and enter a random NEXTAUTH_SECRET (e.g. openssl rand -base64 32)

# 4. Run local development server
npm run dev

Open http://localhost:3000 or https://career-agents.vercel.app to access the platform.

Database Modes

• Guest Mode (Default): Runs without configuring a database. All dossier metrics and sessions are saved locally in your browser using Zustand's persist storage manager.
• Database Mode: Set DATABASE_URL in .env to a PostgreSQL instance, then push the Prisma schema:

  npx prisma db push
  

---

💻 CLI Terminal Utilities

Run terminal commands using scripts/cli.js:

Command	Arguments	Purpose	Example
list	None	Lists all registered divisions and agents	node scripts/cli.js list
doctor	None	Performs environment and dependency health checks	node scripts/cli.js doctor
score	<filepath>	Scans PDF/Word resumes and outputs ATS score	node scripts/cli.js score resume.pdf
review	<filepath>	Performs weak bullet checking and verb audits	node scripts/cli.js review resume.pdf
github	<username>	Runs portfolio wrapped check for target profile	node scripts/cli.js github torvalds
mock	<company> <mode>	Starts a terminal mock interview drill	node scripts/cli.js mock google behavioral
roadmap	<target>	Generates study roadmaps in markdown formats	node scripts/cli.js roadmap "staff engineer"

---

📡 REST API Reference

Career Agents exposes 10 REST endpoints. For request/response schemas, check docs/API.md:

• POST /api/copilot — Streams response tokens using SSE.
• POST /api/interview — Generates questions or evaluates answers.
• POST /api/resume/analyze — Evaluates resume text against ATS parameters.
• POST /api/github/analyze — Pulls public portfolio metrics from the GitHub API.
• POST /api/linkedin/analyze — Optimizes LinkedIn headlines and summaries.
• POST /api/reports/generate — Compiles and exports reports to PDF, Word, or Excel.
• POST /api/parse-file — Extracts plain text from uploaded document files.
• POST /api/parse-file/url — Parses files from a public URL.
• POST /api/providers/test — Tests connection status and latency for AI providers.
• GET /api/profile — Retrieves the authenticated NextAuth user session.

---

📋 Environment Variables

Variable	Required	Default	Description / Security Notes
NEXTAUTH_SECRET	Yes	None	Secret key used to encrypt user sessions. Never share this.
NEXTAUTH_URL	Yes	http://localhost:3000	Canonical URL of your app deployment.
DATABASE_URL	No	None	Postgres connection string. If blank, app operates in Guest Mode.
JWT_SECRET	No	None	Secret key used to sign session cookies.
UPLOAD_LIMIT_MB	No	10	Maximum allowed file upload size for resume parsing.
DEFAULT_PROVIDER	No	gemini	Fallback default gateway provider.
DEFAULT_MODEL	No	gemini-2.5-flash	Fallback default gateway model.
GITHUB_CLIENT_ID / GITHUB_CLIENT_SECRET	No	None	OAuth application keys generated via GitHub Developer settings.
GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRET	No	None	OAuth application keys generated via Google Cloud Console.
OPENAI_API_KEY	No	None	Server-side fallback key for OpenAI.
ANTHROPIC_API_KEY	No	None	Server-side fallback key for Anthropic Claude.
GEMINI_API_KEY	No	None	Server-side fallback key for Google Gemini.
GROQ_API_KEY	No	None	Server-side fallback key for Groq.
DEEPSEEK_API_KEY	No	None	Server-side fallback key for DeepSeek.
OPENROUTER_API_KEY	No	None	Server-side fallback key for OpenRouter.
MISTRAL_API_KEY	No	None	Server-side fallback key for Mistral.
COHERE_API_KEY	No	None	Server-side fallback key for Cohere.
TOGETHER_API_KEY	No	None	Server-side fallback key for Together AI.
XAI_API_KEY	No	None	Server-side fallback key for xAI Grok.
GITHUB_TOKEN	No	None	Read-only GitHub PAT used to increase GitHub API limit to 5000/hr.
LOG_LEVEL	No	info	Logging verbosity level on NextJS console.

---

🔒 Enterprise Security & Privacy

• Zero-Key Storage: API keys entered by users are stored strictly in the browser's localStorage and never transmitted to database servers.
• Session Protection: NextAuth JWT tokens are signed using NEXTAUTH_SECRET and saved in secure HttpOnly, SameSite=Lax cookies.
• Strict Headers: Includes Content Security Policy (CSP), HTTP Strict Transport Security (HSTS), and XSS safeguards.

---

🛠️ Development & Validation Pipeline

Before submitting changes, run the full validation suite:

# 1. Type Safety Check
npm run type-check

# 2. Lint Check
npm run lint

# 3. Generate Databases & Index Maps
python scripts/generate-data.py

# 4. Validate Schema Integrity & Links
python scripts/validate.py

---

🗺️ Roadmap & Releases

• v10.0.0 (Founder Event Edition): Immersive AI Career Operating System redesign and multi-provider fallback chains.
• v12.0.0: Monorepo package isolation and OpenAPI documentation layouts.
• v14.0.0: Enterprise OAuth authentication and RBAC roles.
• v17.0.0 (Current Release): 20-Language Coding Studio with 240+ problems, 20 ATS Resume Templates, 18 AI Provider Gateways, 167 Agent Ecosystem, and stdio MCP server.

---

🤝 Contributing & Sponsorship

We welcome contributions from software engineers around the world:

• Branching: Create features on branches prefixed with feature/ or fix/.
• Validation: Pull Requests must pass npm run type-check and python scripts/validate.py.
• Sponsors: Support ongoing development on GitHub Sponsors!

---

❓ FAQ

Q: Can I use Career Agents without an API key?
A: Yes! Resume ATS scoring, LeetCode coding practice, and GitHub profile audits run 100% offline. AI chat features use zero-key guest fallbacks out of the box.

Q: Where are my API keys saved?
A: Keys are saved locally in your browser's localStorage and are never stored on any server.

---

📄 License

---

👨‍💻 Creator & Principal Lead Architect

---