career-compass-mcp 2.15.0 → 2.15.2

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.
Files changed (3) hide show
  1. package/PRIVACY.md +2 -2
  2. package/README.md +36 -31
  3. package/package.json +1 -1
package/PRIVACY.md CHANGED
@@ -40,8 +40,8 @@ Career Compass reads and writes the career information *you* give it:
40
40
 
41
41
  ## Where it is stored
42
42
 
43
- In a single directory on your machine, set by the `CAREER_DATA_PATH` environment variable
44
- (in the plugin, the **Career data folder** setting). The default is `~/.career-compass/`. Files are ordinary YAML you can open, edit, back up,
43
+ In a single directory on your machine: `~/.career-compass/` by default, or the folder named by the
44
+ `CAREER_DATA_PATH` environment variable when it is set. Files are ordinary YAML you can open, edit, back up,
45
45
  or delete with any text editor. While a write is in progress the folder also briefly holds a
46
46
  `.write-claim` file naming the process doing the writing, so a second Career Compass process
47
47
  (a dashboard, or a server registered in two clients) refuses rather than overwriting it. It is
package/README.md CHANGED
@@ -5,12 +5,6 @@
5
5
  </picture>
6
6
  </h1>
7
7
 
8
- [![npm](https://img.shields.io/npm/v/career-compass-mcp.svg)](https://www.npmjs.com/package/career-compass-mcp)
9
- [![npm downloads](https://img.shields.io/npm/dm/career-compass-mcp.svg)](https://www.npmjs.com/package/career-compass-mcp)
10
- [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
11
- [![Node](https://img.shields.io/badge/node-%3E%3D22-green.svg)](https://nodejs.org)
12
- [![MCP](https://img.shields.io/badge/MCP-server-7c4dff.svg)](https://modelcontextprotocol.io)
13
-
14
8
  **Paste a job posting. Get an honest fit verdict.**
15
9
 
16
10
  Paste a job posting and your resume, and ask "Do I fit this?" You get a straight verdict
@@ -20,6 +14,16 @@ tailor your résumé, write the cover letter and prep the interview without padd
20
14
  history. Free, MIT-licensed, and in Claude Code and Cowork your files stay on your own
21
15
  computer.
22
16
 
17
+ ## Get it in the Claude directory
18
+
19
+ In the Claude app or on claude.ai, open **Customize → Plugins**, search for
20
+ **Career Compass**, and add it. That's the whole install.
21
+
22
+ | Where you use Claude | What you get |
23
+ |---|---|
24
+ | **claude.ai chat** (web, desktop, mobile) | The skills only. Paste a résumé and a posting and Claude does the fit check, tailoring, interview prep or offer review in the conversation. A short Career Compass card carries your roles and dates into your next chat (keep it in a "Job search" Project and every chat there starts from it), and Claude can put your next follow-up on your calendar. |
25
+ | **Cowork** and **Claude Code** on your computer | The skills plus the local server: your career history and every application are kept as plain YAML on your computer, so later answers start from them. Needs **Node.js 22 or newer**. |
26
+
23
27
  ## Try it now
24
28
 
25
29
  Just installed it and not sure what to type? Open a new chat and send whichever of these
@@ -47,17 +51,7 @@ Show me a sample Career Compass fit check.
47
51
 
48
52
  ## What a fit check looks like
49
53
 
50
- <p align="center">
51
- <img src="https://raw.githubusercontent.com/benskamps/career-compass-mcp/main/docs/assets/demo/demo.gif" width="100%" alt="A chat: the user pastes a Director of Operations posting and asks Do I fit this. Career Compass's explore_opportunity tool returns the sample candidate's evidence and preference contract, and Claude replies: Strong fit, pay inside the band, the first three must-haves matched to evidence, and two gaps, risk ops and payments regulation. Verdict: pursue it.">
52
- </p>
53
-
54
- *A real run:* the `explore_opportunity` output on the bundled sample data,
55
- and Claude's reply to it, trimmed for length (every cut is shown as "…"). Also as an
56
- [MP4](docs/assets/demo/demo.mp4); how it was made is in
57
- [docs/assets/demo/source](docs/assets/demo/source/README.md).
58
-
59
- Another example in text, on the same fictional Alex Rivera who ships with the package and a
60
- different made-up posting:
54
+ On the fictional Alex Rivera who ships with the package, and a made-up posting:
61
55
 
62
56
  ```
63
57
  You: [pastes a VP of Operations posting from a payments company]
@@ -88,6 +82,19 @@ Claude: Stretch: strong on operations at scale, but no P&L or payments
88
82
  The real reply goes on with talking points, red flags and questions to ask. A "day in the
89
83
  life" of the role comes only when you ask for one.
90
84
 
85
+ The same thing as a recording, in claude.ai chat with nothing installed but the skills,
86
+ against a different made-up posting:
87
+
88
+ <p align="center">
89
+ <img src="https://raw.githubusercontent.com/benskamps/career-compass-mcp/main/docs/assets/demo/demo.gif" width="100%" alt="A chat: the user pastes a sample résumé and a Director of Operations posting and asks Do I fit this. The Career Compass skill loads, and Claude replies: Verdict: strong fit. It clears the knockouts, marks all four must-haves as met with quoted résumé lines, names two gaps, payments and risk ops, and level and scope, flags a skills-list number that doesn't match the résumé dates, and asks whether the user knows anyone at the company for a referral.">
90
+ </p>
91
+
92
+ *A real run (recorded on the previous patch release, with the same skills):* the posting, a sample résumé (fictional Alex Rivera) and Claude's
93
+ reply with only the Career Compass skills loaded and no MCP tools, the way claude.ai chat
94
+ runs it. The reply is trimmed for length, and every cut is shown as "…". Also as an
95
+ [MP4](docs/assets/demo/demo.mp4); how it was made is in
96
+ [docs/assets/demo/source](docs/assets/demo/source/README.md).
97
+
91
98
  ## It won't pad your résumé
92
99
 
93
100
  Every sentence it writes about you has to come from your history or from what you told it.
@@ -102,17 +109,9 @@ When a stronger draft needs a fact it doesn't have, the draft says so in place:
102
109
  The sample record says what changed, not how many people did it, so the bullet asks. You
103
110
  fill in the bracket or cut it; nothing gets invented to sound stronger.
104
111
 
105
- ## Get it in the Claude directory
106
-
107
- In the Claude app or on claude.ai, open **Customize → Plugins**, search for
108
- **Career Compass**, and add it. That's the whole install.
109
-
110
- | Where you use Claude | What you get |
111
- |---|---|
112
- | **claude.ai chat** (web, desktop, mobile) | The skills only. Paste a résumé and a posting and Claude does the fit check, tailoring, interview prep or offer review in the conversation. A short Career Compass card carries your roles and dates into your next chat (keep it in a "Job search" Project and every chat there starts from it), and Claude can put your next follow-up on your calendar. |
113
- | **Cowork** and **Claude Code** on your computer | The skills plus the local server: your career history and every application are kept as plain YAML on your computer, so later answers start from them. Needs **Node.js 22 or newer**. |
112
+ ## Commands, and what it does over time
114
113
 
115
- The commands below work in Claude Code and Cowork. In claude.ai chat, just ask in plain
114
+ These commands work in Claude Code and Cowork. In claude.ai chat, just ask in plain
116
115
  words ("prep me for my interview on Friday").
117
116
 
118
117
  | Command | What it does |
@@ -182,6 +181,12 @@ with pages for [people who were laid off](https://benskamps.github.io/career-com
182
181
 
183
182
  ## For other MCP clients
184
183
 
184
+ [![npm](https://img.shields.io/npm/v/career-compass-mcp.svg)](https://www.npmjs.com/package/career-compass-mcp)
185
+ [![npm downloads](https://img.shields.io/npm/dm/career-compass-mcp.svg)](https://www.npmjs.com/package/career-compass-mcp)
186
+ [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
187
+ [![Node](https://img.shields.io/badge/node-%3E%3D22-green.svg)](https://nodejs.org)
188
+ [![MCP](https://img.shields.io/badge/MCP-server-7c4dff.svg)](https://modelcontextprotocol.io)
189
+
185
190
  Everything below is for running the server yourself, outside the Claude directory: Claude
186
191
  Desktop, Cursor, other MCP clients, or Claude Code without the plugin. If you installed the
187
192
  plugin, skip it. Running the command below as well would register a second copy of every
@@ -266,7 +271,7 @@ Add the server:
266
271
  }
267
272
  ```
268
273
 
269
- Pin a version in `args` (`"career-compass-mcp@2.15.0"` rather than the bare name) if you can:
274
+ Pin a version in `args` (`"career-compass-mcp@2.15.2"` rather than the bare name) if you can:
270
275
  Desktop starts the server twice at once, and an unpinned name reinstalls on every release,
271
276
  which can leave npx's cache half-written (see **On npx** below). `install` does this for you.
272
277
 
@@ -608,9 +613,9 @@ Alex Rivera) if you want to see the shape before writing your own.
608
613
  |---------|---------|-------------|
609
614
  | `CAREER_DATA_PATH` | `~/.career-compass` | Directory holding your career and pipeline YAML |
610
615
 
611
- Plugin users set the same thing in the plugin's settings as **Career data folder**
612
- (`data_path`, default `~/.career-compass`). The plugin passes it to the server as
613
- `CAREER_DATA_PATH`.
616
+ The directory plugin has no folder setting since 2.15.2 (the directory's scan flagged it), so it
617
+ uses `~/.career-compass` unless `CAREER_DATA_PATH` is set in the environment Claude starts the
618
+ server from.
614
619
 
615
620
  ---
616
621
 
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "career-compass-mcp",
3
3
  "mcpName": "io.github.benskamps/career-compass-mcp",
4
- "version": "2.15.0",
4
+ "version": "2.15.2",
5
5
  "description": "AI-native career co-pilot for Claude — Career KB, resume tailoring, job pipeline, interview prep, and offer evaluation via MCP",
6
6
  "type": "module",
7
7
  "main": "build/src/index.js",