# can4hou6joeng4/boss-agent-cli architecture

> Architecture diagram of the GitHub repository can4hou6joeng4/boss-agent-cli, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/can4hou6joeng4/boss-agent-cli
- Repository: https://github.com/can4hou6joeng4/boss-agent-cli

## Overview

boss-agent-cli is a dual-role BOSS直聘 job-search and recruiting CLI, also exposed to agents through JSON, schema, Python, and MCP interfaces. A user enters through the CLI or terminal wizard, authenticates, searches and filters jobs, then reviews or organizes results locally and can continue into outreach and chat. Separate branches cover resumable crawling, AI/resume assistance, and recruiter workflows. The README documents these capabilities; source excerpts and the index establish selected internal calls, while unsampled links are omitted.

Main entry points: [`src/boss_agent_cli/commands/search.py`](https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/commands/search.py) (Job Search), [`src/boss_agent_cli/main.py`](https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/main.py) (CLI Router), [`src/boss_agent_cli/api/client.py`](https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/api/client.py) (Candidate API Client), [`src/boss_agent_cli/wizard/runner.py`](https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/wizard/runner.py) (Terminal Wizard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and Workflow"]
  node_cli["CLI Router<br/>[main.py]"]
  node_wizard["Terminal Wizard<br/>[runner.py]"]
  node_output["JSON and Terminal Output<br/>[display.py]"]
end

subgraph group_candidate["Candidate Experience"]
  node_search["Job Search<br/>[search.py]"]
  node_filters["Welfare Filters<br/>[search_filters.py]"]
  node_cache[("Local Job Cache<br/>[store.py]")]
  node_shortlist["Shortlist and Stats<br/>[shortlist.py]"]
  node_crawler["Resumable Crawler<br/>[service.py]"]
  node_candidate_actions["Outreach and Pipeline<br/>[pipeline.py]"]
  node_pipeline_state["Pipeline Stages<br/>[pipeline_state.py]"]
end

subgraph group_platform["Platform Access"]
  node_platforms["Platform Registry<br/>[__init__.py]"]
  node_zhipin["Candidate Platform<br/>[zhipin.py]"]
  node_api["Candidate API Client<br/>[client.py]"]
  node_browser["Browser Session<br/>[browser_client.py]"]
  node_auth["Authentication<br/>[manager.py]"]
end

subgraph group_recruiter["Recruiter Experience"]
  node_recruiter_cmd["Recruiter Commands<br/>[candidates.py]"]
  node_recruiter_platform["Recruiter Platform"]
  node_recruiter_api["Recruiter API Client"]
end

subgraph group_agent["Agent and AI"]
  node_schema["Capability Schema<br/>[data.py]"]
  node_mcp["MCP Tools<br/>[mcp_tools.py]"]
  node_ai["AI Assistance<br/>[service.py]"]
  node_resume[("Resume Management<br/>[store.py]")]
end

node_user(("User or Agent"))
node_boss_service{{"BOSS直聘"}}
node_local_model{{"OpenAI-Compatible Model"}}

node_user -->|"invokes"| node_cli
node_cli -->|"starts default"| node_wizard
node_cli -->|"exposes capabilities"| node_schema
node_cli -.->|"formats results"| node_output
node_wizard -.->|"can start search"| node_search
node_user -->|"invokes tools"| node_mcp
node_mcp -.->|"uses capabilities"| node_schema
node_search -->|"loads credentials"| node_auth
node_search -->|"selects platform"| node_platforms
node_search -->|"applies filters"| node_filters
node_search -->|"stores results"| node_cache
node_search -->|"uses crawl service"| node_crawler
node_platforms -->|"resolves candidate"| node_zhipin
node_zhipin -.->|"delegates requests"| node_api
node_api -->|"reads credentials"| node_auth
node_api -->|"uses browser channel"| node_browser
node_api -->|"requests platform data"| node_boss_service
node_user -->|"organizes jobs"| node_shortlist
node_crawler -->|"saves checkpoints"| node_cache
node_user -->|"tracks conversations"| node_candidate_actions
node_candidate_actions -->|"builds stages"| node_pipeline_state
node_user -->|"requests assistance"| node_ai
node_ai -->|"calls compatible endpoint"| node_local_model
node_user -->|"manages resume"| node_resume
node_user -->|"runs recruiter workflow"| node_recruiter_cmd
node_recruiter_cmd -->|"selects recruiter platform"| node_recruiter_platform
node_recruiter_platform -.->|"uses recruiter client"| node_recruiter_api
node_recruiter_api -->|"requests recruiter data"| node_boss_service

click node_cli "https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/main.py"
click node_wizard "https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/wizard/runner.py"
click node_schema "https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/schema/data.py"
click node_mcp "https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/mcp_tools.py"
click node_search "https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/commands/search.py"
click node_filters "https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/search_filters.py"
click node_platforms "https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/platforms/__init__.py"
click node_zhipin "https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/platforms/zhipin.py"
click node_api "https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/api/client.py"
click node_browser "https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/api/browser_client.py"
click node_auth "https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/auth/manager.py"
click node_cache "https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/cache/store.py"
click node_shortlist "https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/commands/shortlist.py"
click node_crawler "https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/crawler/service.py"
click node_candidate_actions "https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/commands/pipeline.py"
click node_pipeline_state "https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/pipeline_state.py"
click node_ai "https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/ai/service.py"
click node_resume "https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/resume/store.py"
click node_recruiter_cmd "https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/commands/recruiter/candidates.py"
click node_recruiter_platform "https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/platforms/zhipin_recruiter.py"
click node_recruiter_api "https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/api/recruiter_client.py"
click node_output "https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/display.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_wizard,node_output,node_user toneBlue
class node_search,node_filters,node_cache,node_shortlist,node_crawler,node_candidate_actions,node_pipeline_state toneAmber
class node_platforms,node_zhipin,node_api,node_browser,node_auth toneMint
class node_recruiter_cmd,node_recruiter_platform,node_recruiter_api toneRose
class node_schema,node_mcp,node_ai,node_resume,node_boss_service,node_local_model toneIndigo
```

## Components

### Entry and Workflow

- [CLI Router](https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/main.py): `src/boss_agent_cli/main.py`
- [Terminal Wizard](https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/wizard/runner.py): `src/boss_agent_cli/wizard/runner.py`
- [JSON and Terminal Output](https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/display.py): `src/boss_agent_cli/display.py`

### Candidate Experience

- [Job Search](https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/commands/search.py): `src/boss_agent_cli/commands/search.py`
- [Welfare Filters](https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/search_filters.py): `src/boss_agent_cli/search_filters.py`
- [Local Job Cache](https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/cache/store.py): `src/boss_agent_cli/cache/store.py`
- [Shortlist and Stats](https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/commands/shortlist.py): `src/boss_agent_cli/commands/shortlist.py`
- [Resumable Crawler](https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/crawler/service.py): `src/boss_agent_cli/crawler/service.py`
- [Outreach and Pipeline](https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/commands/pipeline.py): `src/boss_agent_cli/commands/pipeline.py`
- [Pipeline Stages](https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/pipeline_state.py): `src/boss_agent_cli/pipeline_state.py`

### Platform Access

- [Platform Registry](https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/platforms/__init__.py): `src/boss_agent_cli/platforms/__init__.py`
- [Candidate Platform](https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/platforms/zhipin.py): `src/boss_agent_cli/platforms/zhipin.py`
- [Candidate API Client](https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/api/client.py): `src/boss_agent_cli/api/client.py`
- [Browser Session](https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/api/browser_client.py): `src/boss_agent_cli/api/browser_client.py`
- [Authentication](https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/auth/manager.py): `src/boss_agent_cli/auth/manager.py`

### Recruiter Experience

- [Recruiter Commands](https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/commands/recruiter/candidates.py): `src/boss_agent_cli/commands/recruiter/candidates.py`
- [Recruiter Platform](https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/platforms/zhipin_recruiter.py): `src/boss_agent_cli/platforms/zhipin_recruiter.py`
- [Recruiter API Client](https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/api/recruiter_client.py): `src/boss_agent_cli/api/recruiter_client.py`

### Agent and AI

- [Capability Schema](https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/schema/data.py): `src/boss_agent_cli/schema/data.py`
- [MCP Tools](https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/mcp_tools.py): `src/boss_agent_cli/mcp_tools.py`
- [AI Assistance](https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/ai/service.py): `src/boss_agent_cli/ai/service.py`
- [Resume Management](https://github.com/can4hou6joeng4/boss-agent-cli/blob/master/src/boss_agent_cli/resume/store.py): `src/boss_agent_cli/resume/store.py`

### Other components

- **User or Agent**
- **BOSS直聘**
- **OpenAI-Compatible Model**

## Connections

- User or Agent → CLI Router: invokes (evidence: `README.md`)
- CLI Router → Terminal Wizard: starts default (evidence: `src/boss_agent_cli/main.py`)
- CLI Router → Capability Schema: exposes capabilities (evidence: `README.md`)
- CLI Router → JSON and Terminal Output: formats results
- Terminal Wizard → Job Search: can start search
- User or Agent → MCP Tools: invokes tools (evidence: `README.md`)
- MCP Tools → Capability Schema: uses capabilities
- Job Search → Authentication: loads credentials (evidence: `src/boss_agent_cli/commands/search.py`)
- Job Search → Platform Registry: selects platform (evidence: `src/boss_agent_cli/commands/search.py`)
- Job Search → Welfare Filters: applies filters (evidence: `src/boss_agent_cli/commands/search.py`)
- Job Search → Local Job Cache: stores results (evidence: `src/boss_agent_cli/commands/search.py`)
- Job Search → Resumable Crawler: uses crawl service (evidence: `src/boss_agent_cli/commands/search.py`)
- Platform Registry → Candidate Platform: resolves candidate (evidence: `src/boss_agent_cli/platforms/__init__.py`)
- Candidate Platform → Candidate API Client: delegates requests
- Candidate API Client → Authentication: reads credentials (evidence: `src/boss_agent_cli/auth/manager.py`)
- Candidate API Client → Browser Session: uses browser channel
- Candidate API Client → BOSS直聘: requests platform data (evidence: `README.md`)
- User or Agent → Shortlist and Stats: organizes jobs (evidence: `README.md`)
- Resumable Crawler → Local Job Cache: saves checkpoints (evidence: `src/boss_agent_cli/crawler/service.py`)
- User or Agent → Outreach and Pipeline: tracks conversations (evidence: `README.md`)
- Outreach and Pipeline → Pipeline Stages: builds stages (evidence: `src/boss_agent_cli/commands/pipeline.py`)
- User or Agent → AI Assistance: requests assistance (evidence: `README.md`)
- AI Assistance → OpenAI-Compatible Model: calls compatible endpoint (evidence: `README.md`)
- User or Agent → Resume Management: manages resume (evidence: `README.md`)
- User or Agent → Recruiter Commands: runs recruiter workflow (evidence: `README.md`)
- Recruiter Commands → Recruiter Platform: selects recruiter platform (evidence: `README.md`)
- Recruiter Platform → Recruiter API Client: uses recruiter client
- Recruiter API Client → BOSS直聘: requests recruiter data (evidence: `README.md`)
