convez.ai
SkillAutomaçãoIntermediário
C0nanT

Claude Hooks

C0nanT/claude-hooks

Integra skills Claude Code automaticamente com proteção git

Ver no GitHub
InicialPluginScore · de 0 a 100

Companheiro de hooks para Claude Code que integra automaticamente as skills 'caveman' e 'git-guardrails' no settings.json, sem edição manual. Injeta contexto oculto para economia de tokens e bloqueia comandos git destrutivos antes da execução.

Instalação

$npx convez-ai C0nanT/claude-hooks

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
2
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 2 semanas
Versão
—
Issues abertas
1
Contribuidores
2

Casos de uso

  • Ativar modo economizador de tokens automaticamente a cada sessão
  • Prevenir acidentes com comandos git destrutivos em pré-execução
  • Gerenciar hooks de código sem editar manualmente settings.json

Veredito

Ferramenta minimalista e bem-estruturada que reduz fricção operacional. Solução prática para quem usa Claude Code + skills e quer automação de configuração sem overhead — requer conhecimento prévio do ecossistema C0nanT.

README

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

claude-hooks

Claude Code hooks companion to C0nanT/skills. Wires the caveman and git-guardrails skills into settings.json automatically — no hand-editing.

Prerequisites

Install C0nanT/skills first. The hooks reference skill assets at runtime (~/.claude/skills/caveman/, ~/.claude/skills/git-guardrails-claude-code/) — without the skills installed, the hooks no-op.

npx skills@latest add C0nanT/skills

Requires jq. On Ubuntu/WSL: sudo apt-get install -y jq

Install

npx @c0nant/claude-hooks install

Bundled hooks

HookEventWhat it does
cavemanSessionStartInjects the caveman ruleset as hidden context — agent starts in token-saving mode every session without typing /caveman
git-guardrailsPreToolUse/BashBlocks destructive git commands (push, reset --hard, clean -f, branch -D, checkout ., restore .) before execution

Both hooks no-op gracefully if the skill is absent.

Commands

npx @c0nant/claude-hooks install              # install all hooks
npx @c0nant/claude-hooks install git-guardrails  # one hook only
npx @c0nant/claude-hooks uninstall            # remove all
npx @c0nant/claude-hooks uninstall caveman    # remove one
npx @c0nant/claude-hooks list                 # show installed

Installs are idempotent — re-running syncs without duplicating. Uninstall is surgical — only touches what this tool added.

Project-scoped install

CLAUDE_SETTINGS=.claude/settings.json npx @c0nant/claude-hooks install

Development

Setup

git config core.hooksPath .githooks   # pre-push runs tests
bash test/run.sh                      # requires jq

No npm install — zero runtime dependencies beyond Node ≥18 and jq.

Day-to-day workflow

Where you pushWhat happens
Branch or PRCI runs test/run.sh only — no version bump, no npm publish
mainCI runs tests → bumps patch → publishes to npm

Work on a branch, open a PR (or push directly if solo), merge to main when green.

Releasing

Patch (bugfix, small improvement) — just merge/push to main. CI handles everything:

push to main → tests → 0.1.11 → 0.1.12 → npm publish

Do not bump package.json manually for patch releases.

Minor or major (new feature, breaking change) — bump locally first, then CI publishes on push:

./release.sh minor   # or major — working tree must be clean

The script bumps package.json, commits, tags vX.Y.Z, and pushes main + tags. Requires NPM_TOKEN in GitHub Actions secrets.

Ver o original no GitHub

Bom para

Relacionados