Tutorial de career-ops: gestiona la búsqueda de empleo con Codex o Claude Code

career-ops es un espacio local para buscar empleo que funciona dentro de una CLI de programación con IA. Reúne la recopilación y evaluación de vacantes, adaptación del CV, investigación de empresas, generación de PDF y seguimiento de candidaturas en un mismo directorio, para que Codex, Claude Code, OpenCode y herramientas similares trabajen con tus datos reales.

No consigue empleo automáticamente y no debe utilizarse para inventar experiencia ni enviar candidaturas indiscriminadas. Su utilidad práctica es reducir el trabajo repetido, el descontrol de versiones y la falta de seguimiento después de cada solicitud.

Requisitos previos

La instalación más rápida utiliza Node.js y npx. Compruébalos primero:

1
2
3


node --version
npm --version
npx --version

Prepara también un CV veraz en Markdown o texto plano. No guardes en el proyecto números de identidad, domicilio, documentos escaneados ni otros datos innecesarios para analizar una vacante.

La generación de PDF requiere Playwright Chromium. Puedes instalarlo más adelante si solo necesitas evaluar puestos y editar texto.

Inicializar con un comando

El inicializador oficial es:

1

npx @santifer/career-ops init

Coloca la versión más reciente en un directorio career-ops e instala las dependencias. Entra en el directorio e inicia el agente que utilizas:

1
2


cd career-ops
codex

También puedes sustituir el último comando por:

1

claude

En el primer inicio, pide al agente que te guíe con el CV, el perfil y los puestos objetivo. Recorre todo el flujo con un ejemplo ficticio o poco sensible antes de trasladar datos personales reales.

Instalación manual y diagnóstico

Si falla la inicialización automática, instala manualmente:

1
2
3
4


git clone https://github.com/santifer/career-ops.git
cd career-ops
npm install
npm run doctor

Instala el navegador cuando necesites generar PDF:

1

npx playwright install chromium

npm run doctor ofrece una comprobación más útil que la existencia del directorio o un npm install sin errores. Valida los requisitos del proyecto. Si falla, corrige el componente indicado en lugar de borrar y reinstalar inmediatamente todo el proyecto.

Configurar el perfil y las empresas objetivo

En una instalación manual, copia las plantillas:

1
2


cp config/profile.example.yml config/profile.yml
cp templates/portals.example.yml portals.yml

En Windows PowerShell, utiliza:

1
2


Copy-Item config/profile.example.yml config/profile.yml
Copy-Item templates/portals.example.yml portals.yml

Después crea cv.md en la raíz del proyecto. Sigue estas reglas:

Incluye en cv.md únicamente experiencia, proyectos y habilidades reales.
Guarda dirección profesional, preferencias y límites en profile.yml.
Mantén empresas objetivo o fuentes de vacantes en portals.yml.
Conserva una copia del CV original y versiona los archivos editados por la IA.
No envíes API keys, contraseñas de portales o cookies a Git.

Cómo usar career-ops en Codex

Codex no necesita comandos con barra. Puedes indicar el flujo en lenguaje natural. Empieza solo con la evaluación:

1

Lee esta oferta y ejecuta el modo scan de career-ops. Explica los requisitos obligatorios, las coincidencias y las carencias. No modifiques el CV.

Cuando decidas que merece la pena solicitar el puesto, continúa:

1

Prepara una versión adaptada para este puesto a partir de cv.md. No añadas habilidades, cifras ni experiencias ausentes del CV original. Muestra primero un resumen de cambios.

Para generar materiales:

1

Ejecuta el flujo PDF para el último puesto evaluado. Enumera las rutas de los archivos generados y todos los campos que todavía requieren confirmación humana.

Finalmente, actualiza el estado:

1

Ejecuta el modo tracker y registra el estado de hoy, la próxima fecha de seguimiento y las tareas pendientes.

Flujo de trabajo recomendado

No generes un CV adaptado inmediatamente después de recibir un enlace. Sigue este orden:

Guarda la descripción original o URL y registra la fecha de consulta.
Evalúa requisitos obligatorios, responsabilidades y señales de riesgo.
Separa coincidencias demostrables, experiencia cercana y carencias reales.
Ajusta únicamente el orden y la redacción de hechos relevantes del CV.
Comprueba que cada cifra, habilidad y proyecto esté respaldado por los datos originales.
Abre el PDF y revisa paginación, fuentes, enlaces y datos de contacto.
Actualiza el estado y la próxima fecha de seguimiento tras enviar la candidatura.

Este orden evita que el agente complete silenciosamente las carencias con experiencia inventada para aumentar una puntuación de coincidencia.

Problemas habituales

No existe npx o es demasiado antiguo

Instala una versión compatible de Node.js y abre de nuevo la terminal. Evita mezclar Node del sistema, nvm y varios directorios independientes, porque node, npm y npx podrían resolver a versiones distintas.

npm install funciona, pero doctor falla

Utiliza la salida concreta de npm run doctor. Los errores de PDF suelen indicar que falta Playwright Chromium. Para errores de configuración, comprueba que hayas copiado las plantillas, que la sangría YAML sea correcta y que cv.md esté en la raíz.

El PDF está vacío o tiene mal formato

Confirma primero que el navegador está instalado:

1

npx playwright install chromium

Después prueba con un CV corto. Abre el PDF resultante y revisa páginas, saltos de línea, fuentes y enlaces. Un código de salida cero no demuestra por sí solo que el documento sea utilizable.

Privacidad y veracidad

career-ops se ejecuta en un directorio local, pero la CLI de IA puede enviar contexto a un modelo en la nube. Consulta la política de datos del servicio y elimina información identificativa innecesaria.

La IA puede ordenar y reescribir hechos existentes. No debe crear duración de empleos, estudios, certificados, nombres de clientes ni cifras de rendimiento. La automatización debe reducir trabajo repetitivo, no fabricar candidaturas que solo aparentan una alta coincidencia.