job-application-agent 3.1.0 → 3.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +82 -130
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -2,201 +2,153 @@
|
|
|
2
2
|
|
|
3
3
|
# 💼 Job Application Agent
|
|
4
4
|
|
|
5
|
-
###
|
|
5
|
+
### Find better roles, apply with verified facts, and learn from outcomes.
|
|
6
6
|
|
|
7
7
|
[](https://github.com/vaibhavarora14/job-application-agent/actions/workflows/validate.yml)
|
|
8
|
-
[](LICENSE)
|
|
9
|
-
[](job-application-agent/SKILL.md)
|
|
10
|
-
[](https://nodejs.org/)
|
|
11
8
|
[](https://www.npmjs.com/package/job-application-agent)
|
|
9
|
+
[](LICENSE)
|
|
10
|
+
[](job-application-agent/SKILL.md)
|
|
12
11
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
[Quick start](#-quick-start) · [How it works](#-how-it-works) · [Safety](#-safety-by-design) · [Privacy](#-privacy-model) · [Public dashboard](https://job-application-agent-telemetry.varora1406.workers.dev/) · [Analytics](#-usage-analytics) · [Security](SECURITY.md)
|
|
12
|
+
[Get started](#-get-started) · [Safety](#-safety) · [Privacy](#-privacy) · [Dashboard](https://job-application-agent-telemetry.varora1406.workers.dev/) · [Security](SECURITY.md)
|
|
16
13
|
|
|
17
14
|
</div>
|
|
18
15
|
|
|
19
16
|
---
|
|
20
17
|
|
|
21
|
-
Job Application Agent helps
|
|
18
|
+
Job Application Agent is an [Agent Skill](https://agentskills.io/specification) that helps a coding agent discover, evaluate, complete, and track your own job applications. It uses one verified résumé, checks eligibility and duplicates, and records only confirmed submissions.
|
|
22
19
|
|
|
23
|
-
##
|
|
20
|
+
## 🚀 Get started
|
|
24
21
|
|
|
25
|
-
|
|
22
|
+
Install it:
|
|
26
23
|
|
|
27
24
|
```bash
|
|
28
25
|
npx job-application-agent@latest install
|
|
29
26
|
```
|
|
30
27
|
|
|
31
|
-
|
|
28
|
+
Then tell your coding agent:
|
|
32
29
|
|
|
33
30
|
```text
|
|
34
|
-
|
|
35
|
-
npx job-application-agent@latest install
|
|
36
|
-
|
|
37
|
-
Then confirm the installed version with:
|
|
38
|
-
npx job-application-agent@latest status
|
|
31
|
+
Use job-application-agent to onboard my résumé and job preferences.
|
|
39
32
|
```
|
|
40
33
|
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
```bash
|
|
44
|
-
# See the installed version and update mode
|
|
45
|
-
npx job-application-agent@latest status
|
|
46
|
-
|
|
47
|
-
# Update immediately
|
|
48
|
-
npx job-application-agent@latest update
|
|
34
|
+
After onboarding, use natural commands:
|
|
49
35
|
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
36
|
+
```text
|
|
37
|
+
search jobs
|
|
38
|
+
apply https://company.example/jobs/123
|
|
39
|
+
apply all relevant jobs from this thread: <URL>
|
|
40
|
+
run a round of 10
|
|
41
|
+
show attention queue
|
|
42
|
+
record outcome Company — Senior Engineer — interview
|
|
53
43
|
```
|
|
54
44
|
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
> [!IMPORTANT]
|
|
58
|
-
> You stay in control. The agent pauses for authentication, CAPTCHA, legal attestations, demographic questions, unclear eligibility, sensitive identifiers, and unverifiable claims.
|
|
45
|
+
Requires Node.js 20 or newer and a browser-capable coding agent.
|
|
59
46
|
|
|
60
47
|
## ✨ What it does
|
|
61
48
|
|
|
62
|
-
|
|
|
63
|
-
|
|
64
|
-
|
|
|
65
|
-
|
|
|
66
|
-
|
|
67
|
-
|
|
|
68
|
-
|
|
69
|
-
| Keeps profile data in OS-backed storage and browser auth in the browser. | Records only visibly confirmed submissions in a private local ledger. | Reviews results every ten applications and proposes targeting changes. |
|
|
70
|
-
| Stops at sensitive or judgment-heavy steps. | Captures explicit round IDs and a resumable attention queue. | Opens tested, sanitized improvement PRs without merging or publishing them. |
|
|
71
|
-
|
|
72
|
-
## 🛡️ Safety by design
|
|
49
|
+
| Stage | Behavior |
|
|
50
|
+
|---|---|
|
|
51
|
+
| **Discover** | Searches direct career pages, ATS platforms, and candidate-provided leads. |
|
|
52
|
+
| **Qualify** | Checks seniority, skills, location, authorization, compensation, and posting status. |
|
|
53
|
+
| **Apply** | Fills forms and uploads one canonical résumé using verified facts only. |
|
|
54
|
+
| **Track** | Deduplicates applications and records only visible submission confirmations. |
|
|
55
|
+
| **Improve** | Reviews outcomes and proposes targeting changes without rewriting candidate facts. |
|
|
73
56
|
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
- passwords, SSO, MFA, and CAPTCHA;
|
|
77
|
-
- demographic and voluntary self-identification questions;
|
|
78
|
-
- legal attestations and government identifiers;
|
|
79
|
-
- unclear work authorization, sponsorship, location, or compensation;
|
|
80
|
-
- claims that cannot be verified from your profile or résumé.
|
|
57
|
+
## 🤖 Choose your autonomy level
|
|
81
58
|
|
|
82
|
-
|
|
59
|
+
- **`review-each`** — review every completed application before submission.
|
|
60
|
+
- **`routine-auto`** — allow routine submissions while keeping sensitive and judgment-heavy steps with you.
|
|
83
61
|
|
|
84
|
-
|
|
62
|
+
For durable autonomy across resumable or scheduled runs:
|
|
85
63
|
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
```sh
|
|
89
|
-
npx job-application-agent@latest install
|
|
90
|
-
```
|
|
91
|
-
|
|
92
|
-
This is the supported installation path for both people and coding agents. After install, ask the current agent to list available skills if it does not pick up `job-application-agent` immediately.
|
|
93
|
-
|
|
94
|
-
### 2. Onboard your profile
|
|
95
|
-
|
|
96
|
-
Start a new agent chat and invoke this skill however your agent names skills (`$job-application-agent`, `/job-application-agent`, or natural language):
|
|
97
|
-
|
|
98
|
-
```text
|
|
99
|
-
Use job-application-agent to onboard my resume and job-search preferences.
|
|
64
|
+
```bash
|
|
65
|
+
echo '{"mode":"routine-auto"}' | node ~/.agents/skills/job-application-agent/scripts/job-application.mjs autonomy grant --stdin
|
|
100
66
|
```
|
|
101
67
|
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
- `review-each` — inspect every completed application before submission.
|
|
105
|
-
- `routine-auto` — allow routine submissions within a destination or batch you explicitly authorize; safety pauses still apply.
|
|
68
|
+
Check or revoke it at any time:
|
|
106
69
|
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
```sh
|
|
110
|
-
echo '{"mode":"routine-auto"}' | node ~/.agents/skills/job-application-agent/scripts/job-application.mjs autonomy grant --stdin
|
|
70
|
+
```bash
|
|
111
71
|
node ~/.agents/skills/job-application-agent/scripts/job-application.mjs autonomy status
|
|
72
|
+
node ~/.agents/skills/job-application-agent/scripts/job-application.mjs autonomy revoke
|
|
112
73
|
```
|
|
113
74
|
|
|
114
|
-
|
|
75
|
+
## 🛡️ Safety
|
|
115
76
|
|
|
116
|
-
|
|
77
|
+
The agent pauses for:
|
|
117
78
|
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
79
|
+
- passwords, SSO, MFA, and CAPTCHA;
|
|
80
|
+
- legal attestations and government identifiers;
|
|
81
|
+
- demographic or voluntary self-identification questions;
|
|
82
|
+
- unclear work authorization, sponsorship, location, or compensation;
|
|
83
|
+
- claims that cannot be verified from your profile or résumé;
|
|
84
|
+
- browser or operating-system permission prompts.
|
|
85
|
+
|
|
86
|
+
It never reads browser cookies or session files, bypasses access controls, or counts a filled form as a submission.
|
|
126
87
|
|
|
127
88
|
## 🧭 How it works
|
|
128
89
|
|
|
129
90
|
```mermaid
|
|
130
91
|
flowchart LR
|
|
131
|
-
A["Verified résumé + profile"] --> B["
|
|
132
|
-
B --> C["
|
|
133
|
-
C --> D["
|
|
134
|
-
D --> E
|
|
135
|
-
E --> F
|
|
136
|
-
|
|
137
|
-
F
|
|
138
|
-
G --> H
|
|
139
|
-
H --> I["Confirm success and update ledger"]
|
|
92
|
+
A["Verified résumé + profile"] --> B["Find active roles"]
|
|
93
|
+
B --> C["Check fit + duplicates"]
|
|
94
|
+
C --> D["Fill truthful application"]
|
|
95
|
+
D --> E{"Needs you?"}
|
|
96
|
+
E -- Yes --> F["Attention queue"]
|
|
97
|
+
E -- No --> G["Submit"]
|
|
98
|
+
F --> G
|
|
99
|
+
G --> H["Confirm + record"]
|
|
140
100
|
```
|
|
141
101
|
|
|
142
|
-
The bundled
|
|
102
|
+
The bundled CLI handles private profile storage, résumé import, scoring, duplicate checks, resumable rounds, attention queues, and application/outcome ledgers. The coding agent handles discovery and browser interaction under the rules in [`SKILL.md`](job-application-agent/SKILL.md).
|
|
143
103
|
|
|
144
|
-
## 🔐 Privacy
|
|
104
|
+
## 🔐 Privacy
|
|
145
105
|
|
|
146
|
-
| Data |
|
|
147
|
-
|
|
148
|
-
|
|
|
149
|
-
|
|
|
150
|
-
|
|
|
151
|
-
|
|
|
152
|
-
| Browser authentication | Existing browser session | Never exported |
|
|
153
|
-
| Skill instructions and scripts | Local skill directory | Version controlled |
|
|
106
|
+
| Data | Where it stays |
|
|
107
|
+
|---|---|
|
|
108
|
+
| Profile | macOS Keychain or Windows Credential Manager |
|
|
109
|
+
| Résumé and ledgers | Owner-only local state directory |
|
|
110
|
+
| Browser login | Existing browser session |
|
|
111
|
+
| Skill code | Version-controlled installation directory |
|
|
154
112
|
|
|
155
|
-
|
|
113
|
+
Candidate data, résumés, application history, credentials, and browser sessions are never committed to this repository.
|
|
156
114
|
|
|
157
|
-
|
|
115
|
+
Anonymous structured analytics are enabled by default to improve the agent. They may include job and workflow categories, but never candidate identity, résumé content, prompts, answers, browser data, IP addresses, or raw errors.
|
|
158
116
|
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
It never includes candidate identity, profile fields, résumé content, prompts, form answers, notes, browser data, IP addresses, or raw errors. A Cloudflare relay validates the schema before forwarding personless events to a private PostHog dashboard.
|
|
162
|
-
|
|
163
|
-
The [public usage dashboard](https://job-application-agent-telemetry.varora1406.workers.dev/) shows aggregate installations, activity, applications, outcomes, ATS mix, and role seniority. The relay increments a separate aggregate-only Cloudflare D1 store after PostHog accepts each event. The public API exposes no raw events or installation identifiers and suppresses small segments.
|
|
164
|
-
|
|
165
|
-
```sh
|
|
117
|
+
```bash
|
|
166
118
|
node ~/.agents/skills/job-application-agent/scripts/job-application.mjs telemetry status
|
|
167
119
|
node ~/.agents/skills/job-application-agent/scripts/job-application.mjs telemetry disable
|
|
168
120
|
```
|
|
169
121
|
|
|
170
|
-
See the
|
|
171
|
-
|
|
172
|
-
## 🧰 Requirements
|
|
122
|
+
See [`ANALYTICS.md`](job-application-agent/references/ANALYTICS.md) for the event contract and retention policy, or view the [public aggregate dashboard](https://job-application-agent-telemetry.varora1406.workers.dev/).
|
|
173
123
|
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
- OS-backed profile storage (macOS Keychain, or Windows Credential Manager + DPAPI)
|
|
124
|
+
<details>
|
|
125
|
+
<summary><strong>Installation and update details</strong></summary>
|
|
177
126
|
|
|
178
|
-
|
|
127
|
+
The installer places the skill at `~/.agents/skills/job-application-agent` and enables automatic updates by default. Compatible vendor skill directories are also supported when they already exist.
|
|
179
128
|
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
129
|
+
```bash
|
|
130
|
+
npx job-application-agent@latest status
|
|
131
|
+
npx job-application-agent@latest update
|
|
132
|
+
npx job-application-agent@latest updates disable
|
|
133
|
+
npx job-application-agent@latest updates enable
|
|
184
134
|
```
|
|
185
135
|
|
|
186
|
-
|
|
136
|
+
Updates are staged and validated before replacement. Private candidate state lives outside the replaceable skill directory.
|
|
187
137
|
|
|
188
|
-
|
|
138
|
+
</details>
|
|
189
139
|
|
|
190
|
-
|
|
140
|
+
## 🧰 Develop
|
|
191
141
|
|
|
192
|
-
|
|
142
|
+
```bash
|
|
143
|
+
npm test
|
|
144
|
+
```
|
|
193
145
|
|
|
194
|
-
|
|
146
|
+
GitHub Actions validates the skill and runs the same test suite on every pull request. To try the workflow without installing, paste [`SHARE_PROMPT.md`](SHARE_PROMPT.md) into a new agent chat.
|
|
195
147
|
|
|
196
|
-
##
|
|
148
|
+
## ⚖️ Responsible use
|
|
197
149
|
|
|
198
|
-
|
|
150
|
+
Use this project only for your own job search. It does not guarantee interviews, offers, eligibility, or application accuracy. Never use it to impersonate another person, bypass CAPTCHA, evade access controls, or make deceptive claims.
|
|
199
151
|
|
|
200
|
-
|
|
152
|
+
Report privacy or security issues through the process in [`SECURITY.md`](SECURITY.md). Do not open a public issue containing personal data or application records.
|
|
201
153
|
|
|
202
154
|
Released under the [MIT License](LICENSE).
|
package/package.json
CHANGED