Guida rapida
Inizia a usare career-ops in circa quindici minuti: installa il sistema AI open source per la ricerca di lavoro, apri la tua CLI AI e valuta il tuo primo annuncio. Non serve saper programmare.
Questa guida ti porta da zero al tuo primo annuncio valutato in circa quindici minuti al primo utilizzo. Configurerai il workspace, aprirai il tuo assistente di programmazione AI e incollerai un annuncio di lavoro. L'agente completa l'onboarding, se serve, e poi ti restituisce un report completo, un punteggio e un curriculum in PDF su misura.
Cosa ti serve
Non devi saper programmare. Ti basta saper aprire un terminale ed eseguire un comando.
Non hai mai usato il terminale?
Se non hai mai usato una riga di comando, nessun problema, ma questa guida non è il posto giusto per impararlo. Per metterti in pari in fretta, leggi il manuale Command Line for Beginners di freeCodeCamp (in inglese). Copre tutto quello che ti serve per seguire questa guida. Quando saprai aprire un terminale ed eseguire un comando, torna qui e riprendi dal Passo 1.
Assistente di programmazione AI
Installa Claude Code, Codex, OpenCode, Qwen Code o GitHub Copilot CLI: è l'assistente di programmazione AI che fa funzionare questo sistema. career-ops funziona con undici CLI pienamente supportate; installane una qualsiasi e fai il login prima di continuare.
Node.js 22.13+
Installa Node.js, versione 22.13 o successiva (su Node 23, 23.4 o successiva). Esegue gli script di supporto e genera i PDF. Le versioni precedenti non superano il controllo di configurazione, perché l'indice SQLite del tracker richiede una versione più recente di Node. Controlla la tua versione con node --version.
Passo 1: Configura il workspace
Apri un terminale nella cartella in cui vuoi installare career-ops. Il percorso consigliato richiede un solo comando; subito sotto trovi quello avanzato con git clone. Se manca Node (22.13+, oppure 23.4+ su Node 23) o Git, npx si rifiuterà di partire: installali entrambi prima (vedi i prerequisiti qui sopra).
Consigliato: un solo comando
npx @santifer/career-ops initIl comando clona l'ultima release in ./career-ops, installa le dipendenze e crea la struttura del workspace. Rileva anche quale CLI di programmazione AI hai installato e ti indica il comando giusto con cui partire. Installa solo in una cartella nuova: se ./career-ops esiste già e non è vuota, il comando si ferma con un errore e non modifica nulla, quindi rieseguirlo non ripara né aggiorna un workspace esistente.
Quando ha finito, entra nel workspace:
cd career-opsAvanzato: clona tu il repository
Usa questo percorso se vuoi seguire un branch specifico, contribuire al progetto o controllare il codice prima di installare le dipendenze.
git clone https://github.com/career-ops-hq/career-ops.git
cd career-ops
npm installBrowser headless (una volta sola)
career-ops usa un Chromium headless per diversi compiti: generare i PDF, verificare se gli annunci sono ancora attivi ed eseguire le scansioni complete degli ATS. Lo strumento di installazione lo configura in automatico dopo le dipendenze; se quel passaggio non è andato a buon fine sul tuo computer, installalo a mano:
npx playwright install chromiumPasso 2: Apri il tuo assistente AI
Dalla cartella career-ops, avvia la CLI di programmazione AI che hai installato.
claudecodexopencodeqwencopilotagypiL'onboarding parte quando serve il tuo profilo
Prima della tua prima valutazione di un annuncio, o di un altro flusso di lavoro che richiede il tuo profilo, l'agente di career-ops controlla la tua configurazione e, se serve, avvia una breve conversazione di onboarding. Puoi anche chiedergli direttamente di avviarla. Ti chiede il tuo CV, i tipi di ruolo a cui punti, la tua fascia retributiva e le tue preferenze sulla sede di lavoro. Tu rispondi con parole tue e l'agente scrive i file di configurazione al posto tuo. La sessione dura circa due o tre minuti. Esplorare il workspace, rivedere il codice o diagnosticare la tua configurazione non avvia l'onboarding e non crea i file del profilo.
Una richiesta che non c'entra e che potresti vedere
Alcune CLI (Claude Code, per esempio) ti chiedono se consideri attendibili i file di una cartella nuova la prima volta che la apri. Quella richiesta arriva dalla CLI, non da career-ops. Rispondi di sì per continuare. Accettarla non avvia l'onboarding di career-ops.
Paghi Claude Pro o Max? Controlla cosa ti sta addebitando questa sessione
Esegui node doctor.mjs dalla cartella career-ops prima della tua prima valutazione. Ti indica in una riga da dove arriva l'addebito.
Se nel tuo ambiente è impostata ANTHROPIC_API_KEY, la tua CLI la usa e addebita per token, anche mentre paghi Pro o Max. Questa regola di precedenza è di Claude Code, non di career-ops: il doctor si limita a rilevarla e a segnalartelo. Per usare invece il tuo abbonamento, rimuovi la riga export ANTHROPIC_API_KEY=... da ~/.zshrc, ~/.bashrc, ~/.profile o da un .env di progetto, riavvia il terminale ed esegui /login. Se volevi usare i crediti API, è tutto a posto.
Ognuna delle altre CLI stabilisce una propria regola tra abbonamento e chiave, che career-ops non controlla. Trovi la risposta completa nelle FAQ.
Passo 3: Fai la tua prima valutazione
Copia l'URL di un qualsiasi annuncio di lavoro e incollalo nella chat. Se il tuo profilo non è pronto, l'agente completerà prima l'onboarding. Con Claude Code, Antigravity CLI o Pi, fallo precedere dal comando esplicito; con le altre CLI, incolla l'URL e chiedi all'agente di eseguire l'auto-pipeline:
/career-ops auto-pipeline https://jobs.example.com/senior-engineer-aiRun the auto-pipeline command with the job URL: https://jobs.example.com/senior-engineer-aiRun the auto-pipeline command with the job URL: https://jobs.example.com/senior-engineer-aiRun the auto-pipeline command with the job URL: https://jobs.example.com/senior-engineer-aiRun the auto-pipeline command with the job URL: https://jobs.example.com/senior-engineer-ai/career-ops https://jobs.example.com/senior-engineer-ai/skill:career-ops auto-pipeline https://jobs.example.com/senior-engineer-aiSe non hai un URL, incolla nella chat il testo completo dell'annuncio. L'agente riconosce entrambi gli input come un annuncio di lavoro ed esegue in automatico l'intera pipeline: è l'auto-pipeline.
Cosa succede dopo
Dopo che hai incollato l'annuncio, career-ops esegue automaticamente quanto segue:
Legge l'annuncio
Capisce il ruolo, i requisiti e la retribuzione.
Legge il tuo CV
Parte da cv.md per trovare corrispondenze e lacune rispetto al ruolo.
Assegna un punteggio all'annuncio
Valuta il ruolo da 1 a 5 su più dimensioni, come l'aderenza al ruolo, la retribuzione e la politica sul lavoro da remoto.
Scrive un report
Salva un'analisi dettagliata nella cartella reports/.
Genera un curriculum in PDF su misura
Salva nella cartella output/ una versione del tuo CV personalizzata per questo annuncio specifico.
Aggiunge una riga al tuo tracker
Registra la candidatura in data/applications.md.
L'intero processo richiede circa uno o due minuti. Quando ha finito, career-ops ti mostra il punteggio e un riepilogo del report.
Come leggere i risultati
Il report include Score Evidence dopo Risk Summary. Copre cinque dimensioni: corrispondenza con il CV, allineamento con la North Star, retribuzione, segnali culturali e campanelli d'allarme. Ogni riga riporta uno stato delle prove (supported, partial o unknown), una fonte o un'osservazione concreta e una domanda ancora aperta. La sezione si chiude con un livello di affidabilità delle prove (High, Medium o Low), la sua motivazione e fino a tre priorità di verifica.
Apri il file del report in reports/. Il nome del file segue lo schema {number}-{company}-{date}.md. All'interno troverai:
- Punteggio: un numero da 1 a 5. Tutto ciò che sta sotto 4,0 significa che l'annuncio probabilmente non fa per te.
- Blocco A: un riepilogo del ruolo in parole semplici.
- Blocco B: una tabella che mostra come il tuo CV risponde a ciascun requisito dell'annuncio, con le eventuali lacune.
- Blocco C: una strategia consigliata su come presentarti per questo ruolo.
- Blocco D: una ricerca sulla retribuzione che confronta quella dell'annuncio con i valori di mercato.
- Blocco E: note di personalizzazione per la tua candidatura.
- Blocco F: preparazione al colloquio di lavoro, con storie costruite con il metodo STAR su misura per questo annuncio.
- Blocco G: attendibilità dell'annuncio, cioè un controllo euristico di segnali come il fatto che l'annuncio sia ancora aperto o che venga ripubblicato di continuo. Riporta ciò che trova e lascia il giudizio a te.
- Blocco H: bozze di risposta per il modulo di candidatura, scritte solo quando il punteggio è 4,5 o superiore.
Il tuo curriculum in PDF su misura è nella cartella output/. Rileggilo prima di mandarlo a chiunque: career-ops non invia mai nulla senza la tua approvazione.
Cosa fare dopo
Ora che hai fatto la tua prima valutazione, ecco alcune cose che puoi provare:
- Affina il tuo profilo. Racconta all'agente qualcosa di nuovo su di te, per esempio "Ecco altro contesto: ho appena rilasciato X." L'agente aggiorna il profilo e le valutazioni successive diventano più precise.
- Valuta altri annunci. Incolla altri URL o altre descrizioni. Ognuno si aggiunge al tuo tracker.
- Scansiona i portali di lavoro. Scrivi
/career-ops scanper cercare in una volta sola tra decine di pagine "Lavora con noi" aziendali già configurate. - Confronta gli annunci. Se hai più report, scrivi
/career-ops ofertasper ottenere un confronto in classifica.
Risoluzione dei problemi
Hai trovato un bug o hai una domanda?
Se qualcosa non funziona come descritto in questa guida, segnalalo. Le segnalazioni di bug aiutano tutti quelli che arrivano dopo di te.
- Segnala un bug: Apri una issue nel repository GitHub. Descrivi che cosa ti aspettavi, che cosa è successo davvero e incolla gli eventuali messaggi di errore che hai visto.
- Fai una domanda: Unisciti alla community Discord. È il modo più rapido per ricevere aiuto dagli altri utenti e dall'autore.
- Proponi una correzione: Se sai come risolvere il problema, leggi CONTRIBUTING.md prima di aprire una pull request. In breve: apri prima una issue per una nuova funzionalità, una nuova modalità o un nuovo comando, o una modifica all'architettura. Le correzioni di bug, i nuovi provider di scansione senza autenticazione, la documentazione e le traduzioni possono essere proposte direttamente in una pull request.