@justestif/go-jobs 0.1.5 → 0.1.9
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 +109 -0
- package/bin.js +2 -2
- package/install.js +1 -1
- package/package.json +2 -2
package/README.md
ADDED
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
# @justestif/go-jobs
|
|
2
|
+
|
|
3
|
+
CLI for [go-jobs](https://github.com/justEstif/go-jobs) — a self-hosted job aggregator that pulls from 1000+ companies on Greenhouse, Lever, and Ashby.
|
|
4
|
+
|
|
5
|
+
**Live site:** [jobs.estifanos.cc](https://jobs.estifanos.cc)
|
|
6
|
+
|
|
7
|
+
## Install
|
|
8
|
+
|
|
9
|
+
```sh
|
|
10
|
+
npm install -g @justestif/go-jobs
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
This downloads the prebuilt `jobs` binary for your platform (macOS, Linux, Windows).
|
|
14
|
+
|
|
15
|
+
## Quick start
|
|
16
|
+
|
|
17
|
+
```sh
|
|
18
|
+
# Target the hosted site
|
|
19
|
+
jobs --base-url https://jobs.estifanos.cc search --query "backend engineer"
|
|
20
|
+
|
|
21
|
+
# Register / login
|
|
22
|
+
jobs --base-url https://jobs.estifanos.cc register
|
|
23
|
+
jobs --base-url https://jobs.estifanos.cc login
|
|
24
|
+
|
|
25
|
+
# Search with filters
|
|
26
|
+
jobs search --query "frontend react" --role engineering --seniority senior
|
|
27
|
+
|
|
28
|
+
# Track applications
|
|
29
|
+
jobs interested <job-id>
|
|
30
|
+
jobs apply <job-id>
|
|
31
|
+
jobs pipeline
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
If you're running your own instance, set `--base-url` to your server or export `BASE_URL`.
|
|
35
|
+
|
|
36
|
+
## Job Coach
|
|
37
|
+
|
|
38
|
+
Analyze job postings against your resume with AI:
|
|
39
|
+
|
|
40
|
+
```sh
|
|
41
|
+
# Set your resume
|
|
42
|
+
jobs resume set --file ~/resume.md
|
|
43
|
+
|
|
44
|
+
# Analyze a job (requires LLM provider configured in web UI)
|
|
45
|
+
jobs analyze <job-id>
|
|
46
|
+
|
|
47
|
+
# Export the raw prompt to pipe to your own LLM
|
|
48
|
+
jobs prompt <job-id> | llm "analyze my fit for this role"
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
`jobs prompt` outputs the full analysis prompt without calling any LLM — no API key needed, just a resume on file.
|
|
52
|
+
|
|
53
|
+
## Use with AI agents
|
|
54
|
+
|
|
55
|
+
The CLI is designed to work as a tool for AI coding agents. Give your agent a prompt like:
|
|
56
|
+
|
|
57
|
+
> Search go-jobs for backend engineering roles, find one that matches my resume, analyze the fit, and draft a case study for my strongest matching project.
|
|
58
|
+
|
|
59
|
+
The agent can drive the full workflow:
|
|
60
|
+
|
|
61
|
+
```sh
|
|
62
|
+
jobs search --query "backend engineer" --role engineering --json
|
|
63
|
+
jobs resume set --file ~/resume.md
|
|
64
|
+
jobs analyze <job-id>
|
|
65
|
+
jobs prompt <job-id> | llm "optimize my resume for this role"
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
**MCP server coming soon.**
|
|
69
|
+
|
|
70
|
+
## Commands
|
|
71
|
+
|
|
72
|
+
| Command | Description |
|
|
73
|
+
|---|---|
|
|
74
|
+
| `jobs search` | Search jobs with filters |
|
|
75
|
+
| `jobs login` | Authenticate with email/password |
|
|
76
|
+
| `jobs register` | Create an account |
|
|
77
|
+
| `jobs logout` | Clear session |
|
|
78
|
+
| `jobs interested <id>` | Mark a job as interested |
|
|
79
|
+
| `jobs apply <id>` | Mark a job as applied |
|
|
80
|
+
| `jobs status <id> <status>` | Set job status |
|
|
81
|
+
| `jobs notes <id> <text>` | Add notes to a job |
|
|
82
|
+
| `jobs applied` | List applied jobs |
|
|
83
|
+
| `jobs pipeline` | View full pipeline |
|
|
84
|
+
| `jobs resume set` | Set resume from file or stdin |
|
|
85
|
+
| `jobs resume show` | Print stored resume |
|
|
86
|
+
| `jobs resume clear` | Remove stored resume |
|
|
87
|
+
| `jobs analyze <id>` | AI analysis of job vs resume |
|
|
88
|
+
| `jobs prompt <id>` | Export raw LLM prompt |
|
|
89
|
+
| `jobs scrape` | Run the scrape pipeline |
|
|
90
|
+
| `jobs enrich` | Run enrichment on untagged jobs |
|
|
91
|
+
| `jobs serve` | Start the web server |
|
|
92
|
+
|
|
93
|
+
## Self-hosting
|
|
94
|
+
|
|
95
|
+
```sh
|
|
96
|
+
docker pull ghcr.io/justestif/go-jobs:latest
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
See the [self-hosting guide](https://github.com/justEstif/go-jobs/blob/main/docs/self-hosting.md) for Docker Compose setup, environment variables, and deployment.
|
|
100
|
+
|
|
101
|
+
## Links
|
|
102
|
+
|
|
103
|
+
- [GitHub](https://github.com/justEstif/go-jobs)
|
|
104
|
+
- [Live site](https://jobs.estifanos.cc)
|
|
105
|
+
- [Architecture docs](https://github.com/justEstif/go-jobs/blob/main/docs/ARCHITECTURE.md)
|
|
106
|
+
|
|
107
|
+
## License
|
|
108
|
+
|
|
109
|
+
MIT
|
package/bin.js
CHANGED
|
@@ -4,11 +4,11 @@ const { spawnSync } = require("child_process");
|
|
|
4
4
|
const path = require("path");
|
|
5
5
|
const fs = require("fs");
|
|
6
6
|
|
|
7
|
-
const exe = process.platform === "win32" ? "jobs.exe" : "jobs";
|
|
7
|
+
const exe = process.platform === "win32" ? "go-jobs.exe" : "go-jobs";
|
|
8
8
|
const binPath = path.join(__dirname, "bin", exe);
|
|
9
9
|
|
|
10
10
|
if (!fs.existsSync(binPath)) {
|
|
11
|
-
console.error(`jobs: binary not found at ${binPath}`);
|
|
11
|
+
console.error(`go-jobs: binary not found at ${binPath}`);
|
|
12
12
|
console.error("Try reinstalling: npm install -g @justestif/go-jobs");
|
|
13
13
|
process.exit(1);
|
|
14
14
|
}
|
package/install.js
CHANGED
package/package.json
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@justestif/go-jobs",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.9",
|
|
4
4
|
"description": "CLI for jobs.estifanos.cc — search job postings and track applications",
|
|
5
5
|
"bin": {
|
|
6
|
-
"jobs": "bin.js"
|
|
6
|
+
"go-jobs": "bin.js"
|
|
7
7
|
},
|
|
8
8
|
"scripts": {
|
|
9
9
|
"postinstall": "node install.js"
|