convez.ai
SkillAutomaçãoIntermediário
oxGrad

Spice Bag

oxGrad/spicebag

Tempere cada candidatura perfeitamente com IA

Ver no GitHub
InicialPluginScore · de 0 a 100

CLI em Go que usa Claude AI para adaptar inteligentemente seu CV e carta de apresentação para cada vaga. Armazena variantes de CV e cartas em Markdown, rastreia aplicações, exporta PDFs e oferece comandos slash para customização automática dentro do Claude Code.

Instalação

$npx convez-ai oxGrad/spicebag

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 3 dias
Versão
v0.11.1
Issues abertas
8
Contribuidores
2

Casos de uso

  • Adaptar CV automaticamente para cada vaga de emprego
  • Gerar cartas de apresentação personalizadas baseadas em job postings
  • Rastrear histórico completo de aplicações e status
  • Extrair vagas live de sites de empresas e encontrar matches contra seus target roles

Veredito

Ferramenta prática e bem arquitetada para automação de candidaturas. Resolve um problema real — a repetição manual de adaptação de CV — com abordagem inteligente via Claude. Requer Go 1.22+ e Docker, mas instalação é direta via Homebrew ou go install.

README

A tradução para o português deste README ainda está na fila.

🌶️ Spice Bag

Season Every Application Perfectly

Your CV is like a great recipe. You have all the right ingredients — experience, skills, achievements — but without the right seasoning, it might not stand out.

Spice Bag is an AI-powered tool that helps you tailor your CV and cover letter for every job application. Like a chef selecting the perfect spices for a dish, it analyzes each job posting and helps you emphasize the right experiences, skills, and achievements to make your application stand out.

No more generic CVs. Just perfectly seasoned applications for every role you apply to.

What it does

  • Your Spice Bag — stores base CV variants and cover letters as Markdown in ~/.config/spicebag/
  • Flavor extraction — pulls experience stats (years per role type) from CV frontmatter into SQLite
  • Application tracking — tracks every job application with full status history
  • PDF export — exports to print-quality PDF via Gotenberg (no browser print dialogs)
  • Four slash commands — /customize-cv, /write-cover-letter, /apply, /scrape-jobs directly in Claude Code
  • Job scraping — fetch live listings from company ATS pages and surface matches against your target roles
  • Dashboard — browse and manage everything at http://localhost:8080

Prerequisites

  • Go 1.22+
  • Docker (for Gotenberg PDF export)
  • Claude Code

Installation

Option A — Homebrew

brew install oxGrad/tap/spicebag

Option B — go install

go install github.com/oxGrad/spicebag/cmd/spicebag@latest

Open the dashboard

spicebag start        # foreground
spicebag start -d     # background (logs to ~/.config/spicebag/spicebag.log)
spicebag stop         # stop background server

On first run, spicebag start automatically sets up ~/.config/spicebag/, registers the MCP server with Claude Code, installs default themes, and adds slash commands. Open http://localhost:8080 in your browser. The dashboard includes a Gotenberg status widget — use it to start the PDF export service when needed.

Run spicebag init manually to re-run setup at any time.

Claude Plugin Marketplace

Install directly from the marketplace — no spicebag init needed.

1. Add the marketplace (first time only):

claude plugin marketplace add oxGrad/spicebag

2. Install the plugin:

claude plugin install spicebag@spicebag

This registers the MCP server, installs default themes, and adds slash commands automatically.

Slash commands

Use these inside Claude Code. Arguments can be a file reference (@job-post.md), a URL, or pasted text.

CommandWhat it does
/customize-cv <job post or role>Select the recipe — tailor your most relevant base CV for the role and save a new version
/write-cover-letter <job post>A fresh cover letter that explains why you're the perfect spice blend for their team
/apply <job post>Full application in one pass: tailored CV + cover letter + saved job post
/scrape-jobsFetch live job listings from your saved ATS companies and surface matches against your target roles

The seasoning process

Step 1 — Your Spice Bag: Upload your CV — your full ingredient list.

Step 2 — Select the Recipe: Paste the job description. Spice Bag understands what flavor profile they're looking for.

Step 3 — Let's Season: Claude analyzes the recipe and selects the perfect spice blend from your experience for this specific role.

Step 4 — Taste Test: Review your tailored CV and cover letter in the dashboard.

Step 5 — Serve it Up: Export to PDF and apply — perfectly seasoned.

CLI reference

CommandDescription
spicebag initRe-run setup: config dir, MCP registration, themes, slash commands
spicebag startStart the dashboard (foreground)
spicebag start -dStart the dashboard (background)
spicebag stopStop the background dashboard server
spicebag syncSync experience stats from CV frontmatter to SQLite
spicebag mcpRun the MCP server (invoked automatically by Claude Code)

MCP tools

These tools are available to Claude Code via the MCP server:

list_cvs, read_cv, write_cv, list_cover_letters, read_cover_letter, write_cover_letter, get_experience_stats, create_application, list_applications, export_pdf, get_scrape_preferences, fetch_ats_jobs, save_scraped_jobs

ToolWhat it does
get_scrape_preferencesReturns saved scrape companies, target roles, and location preferences
fetch_ats_jobsFetches current job listings from all registered ATS companies
save_scraped_jobsSaves matched jobs for dashboard review

Job Scraping

Spice Bag can pull live job listings from company careers pages and surface roles that match your preferences.

Setup: In the dashboard Settings → Job Scraping, add the careers page URLs of companies you want to track (Greenhouse, Lever, Ashby, SmartRecruiters, Workable, Recruitee, Breezy, BambooHR, Personio, and Workday are supported). Set your target role keywords and location preferences.

Run: Type /scrape-jobs in Claude Code. The skill fetches listings via fetch_ats_jobs, filters for matches, and saves them via save_scraped_jobs.

Review: Open the dashboard Jobs page to see matched listings. Click Apply next to any role to get a copyable /apply <url> command — paste it into Claude Code to kick off a full tailored application.

CV frontmatter (for experience stats)

Add an experience block to your CV Markdown files — this is your spice collection. Run spicebag sync after editing to update the database.

---
experience:
  - role_type: backend
    company: Acme Corp
    start: "2020-01-01"
    end: "2023-06-01"
  - role_type: frontend
    company: Beta Inc
    start: "2023-07-01"
    end: ""
---
# Your CV content here

role_type is a free-form string (e.g. backend, frontend, devops, management). Leave end empty for current roles.

Dashboard

Open http://localhost:8080 to:

  • Browse and export CVs and cover letters with CSS themes
  • Track application status (applied → interview → offer / rejected)
  • View experience stats
  • Upload custom CSS themes

Themes

CSS files in ~/.config/spicebag/themes/ control how CVs and cover letters render in the dashboard and PDF export. Think of them as your plating style.

Two themes are installed by default:

  • minimal — serif font, clean layout
  • modern — sans-serif, blue accents

To add more: upload a .css file via the dashboard, or drop it directly into ~/.config/spicebag/themes/.

Config directory layout

~/.config/spicebag/
  config.toml       dashboard port, Gotenberg URL
  spicebag.db       SQLite: experience stats + application tracking
  cv/               base CV markdown files (your spice bag)
  cover-letters/    cover letter templates
  themes/           CSS themes
  applications/     one folder per job application
  spicebag.log      background dashboard log (when using start -d)

Uninstall

rm $(which spicebag)
rm -rf ~/.config/spicebag
rm -rf ~/.claude/commands/spicebag
# Remove the "spicebag" entry from ~/.claude/mcp.json under mcpServers
Ver o original no GitHub

Bom para

Relacionados