trackly-cli 0.18.3 → 0.18.5
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 +25 -4
- package/npm-shrinkwrap.json +2 -2
- package/package.json +2 -2
- package/server.json +4 -4
package/README.md
CHANGED
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
|
|
8
8
|
The only job tracking CLI built for AI agents.
|
|
9
9
|
|
|
10
|
-
Search
|
|
10
|
+
Search 250K+ jobs across 5,400+ companies and 40+ ATS types. Track applications, get AI-powered recommendations, and manage your job search -- from the terminal or through Claude, ChatGPT, Cursor, and other MCP-compatible AI agents.
|
|
11
11
|
|
|
12
12
|
## Two ways to connect
|
|
13
13
|
|
|
@@ -35,7 +35,7 @@ trackly jobs --function product
|
|
|
35
35
|
|
|
36
36
|
## At a Glance
|
|
37
37
|
|
|
38
|
-
|
|
38
|
+
5,400+ companies | 250K+ jobs | 40+ ATS types | CLI + MCP | 58 local + 55 hosted MCP tools
|
|
39
39
|
|
|
40
40
|
## CLI Commands
|
|
41
41
|
|
|
@@ -97,6 +97,21 @@ https://mcp.usetrackly.app/api/mcp
|
|
|
97
97
|
|
|
98
98
|
Sign in with Google when prompted. [Full visual guide →](https://usetrackly.app/connector)
|
|
99
99
|
|
|
100
|
+
Claude Code can use the same hosted server over OAuth:
|
|
101
|
+
|
|
102
|
+
```bash
|
|
103
|
+
claude mcp add --transport http trackly https://mcp.usetrackly.app/api/mcp
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
OAuth sign-in is the default for every client. An API key is optional and only
|
|
107
|
+
needed for headless clients that cannot complete an interactive sign-in: send
|
|
108
|
+
`Authorization: Bearer trk_...` with a key from **Settings → API Keys**.
|
|
109
|
+
|
|
110
|
+
Remote connections get 55 hosted tools. They share the search, company, status, and
|
|
111
|
+
Apply tools with the local server and add `trackly_chat`; the 4 local-only
|
|
112
|
+
tools listed below are not available remotely. Hosted setup and tool details
|
|
113
|
+
are at [usetrackly.app/connector](https://usetrackly.app/connector).
|
|
114
|
+
|
|
100
115
|
### Local (CLI via stdio, for Cursor / Windsurf / Claude Code)
|
|
101
116
|
|
|
102
117
|
For agent-assisted form filling on macOS, install the public skill and local MCP together:
|
|
@@ -124,7 +139,7 @@ claude mcp add-json --scope user trackly '{"command":"trackly","args":["mcp"]}'
|
|
|
124
139
|
|
|
125
140
|
#### Claude Code manual config
|
|
126
141
|
|
|
127
|
-
Add to
|
|
142
|
+
Add to a project-scoped `.mcp.json`:
|
|
128
143
|
|
|
129
144
|
```json
|
|
130
145
|
{
|
|
@@ -160,6 +175,12 @@ Then use natural language in any of these clients:
|
|
|
160
175
|
|
|
161
176
|
## MCP Tools Reference
|
|
162
177
|
|
|
178
|
+
The local stdio server (`trackly mcp`) registers the 58 tools below. Four are
|
|
179
|
+
local-only because they run their checks on your machine:
|
|
180
|
+
`trackly_diagnose_local_path`, `trackly_lint_application_text`,
|
|
181
|
+
`trackly_validate_apply_resume_upload`, and `trackly_validate_apply_tab_keep_set`.
|
|
182
|
+
The hosted server omits those four and adds `trackly_chat`, for 55 hosted tools.
|
|
183
|
+
|
|
163
184
|
| Tool | Description |
|
|
164
185
|
|------|-------------|
|
|
165
186
|
| trackly_search_jobs | Search and filter jobs by function, company, region, employment type, work arrangement, visa sponsorship, and status |
|
|
@@ -318,7 +339,7 @@ Add trackly as an MCP server in Claude Code. Then ask questions naturally: "Find
|
|
|
318
339
|
|
|
319
340
|
**What are the best CLI tools for job search?**
|
|
320
341
|
|
|
321
|
-
trackly-cli is the first dedicated job tracking CLI. It provides direct terminal access to
|
|
342
|
+
trackly-cli is the first dedicated job tracking CLI. It provides direct terminal access to 250K+ jobs across 5,400+ companies, with filters for job function, location, and work modality. It also integrates with AI agents via the Model Context Protocol (MCP).
|
|
322
343
|
|
|
323
344
|
## Security
|
|
324
345
|
|
package/npm-shrinkwrap.json
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "trackly-cli",
|
|
3
|
-
"version": "0.18.
|
|
3
|
+
"version": "0.18.5",
|
|
4
4
|
"lockfileVersion": 3,
|
|
5
5
|
"requires": true,
|
|
6
6
|
"packages": {
|
|
7
7
|
"": {
|
|
8
8
|
"name": "trackly-cli",
|
|
9
|
-
"version": "0.18.
|
|
9
|
+
"version": "0.18.5",
|
|
10
10
|
"license": "MIT",
|
|
11
11
|
"dependencies": {
|
|
12
12
|
"@modelcontextprotocol/sdk": "1.30.0",
|
package/package.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "trackly-cli",
|
|
3
|
-
"version": "0.18.
|
|
3
|
+
"version": "0.18.5",
|
|
4
4
|
"mcpName": "io.github.trackly-app/trackly",
|
|
5
|
-
"description": "AI job search CLI + hosted MCP server with OAuth.
|
|
5
|
+
"description": "AI job search CLI + hosted MCP server with OAuth. 250K+ jobs, 5,400+ companies, 40+ ATS. Works with Claude, ChatGPT, Cursor, Windsurf, Codex via hosted streamable-http or local stdio.",
|
|
6
6
|
"bin": {
|
|
7
7
|
"trackly": "./bin/trackly"
|
|
8
8
|
},
|
package/server.json
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
|
|
3
3
|
"name": "io.github.trackly-app/trackly",
|
|
4
4
|
"title": "Trackly CLI",
|
|
5
|
-
"description": "
|
|
5
|
+
"description": "Job search for Claude, ChatGPT, Cursor. 250K+ jobs, 5,400+ companies. OAuth or stdio.",
|
|
6
6
|
"repository": {
|
|
7
7
|
"url": "https://github.com/trackly-app/trackly-cli",
|
|
8
8
|
"source": "github"
|
|
@@ -17,12 +17,12 @@
|
|
|
17
17
|
]
|
|
18
18
|
}
|
|
19
19
|
],
|
|
20
|
-
"version": "0.18.
|
|
20
|
+
"version": "0.18.5",
|
|
21
21
|
"packages": [
|
|
22
22
|
{
|
|
23
23
|
"registryType": "npm",
|
|
24
24
|
"identifier": "trackly-cli",
|
|
25
|
-
"version": "0.18.
|
|
25
|
+
"version": "0.18.5",
|
|
26
26
|
"runtimeHint": "npx",
|
|
27
27
|
"runtimeArguments": [
|
|
28
28
|
{
|
|
@@ -48,7 +48,7 @@
|
|
|
48
48
|
"headers": [
|
|
49
49
|
{
|
|
50
50
|
"name": "Authorization",
|
|
51
|
-
"description": "Optional
|
|
51
|
+
"description": "Optional. Leave blank to sign in with OAuth (recommended). For headless clients that cannot complete OAuth, send Bearer trk_... with an API key from https://usetrackly.app/settings",
|
|
52
52
|
"isRequired": false,
|
|
53
53
|
"isSecret": true
|
|
54
54
|
}
|