Development
Local setup, pre-commit hooks, and CI for contributing to neeter
Setup
git clone https://github.com/quantumleeps/neeter.git
cd neeter
pnpm install # installs deps + activates lefthook git hooksFor secret scanning, install gitleaks:
brew install gitleaksIf gitleaks isn't installed, the hook skips gracefully — all other hooks still run.
Scripts
| Command | Description |
|---|---|
pnpm check | Biome lint + format |
pnpm build | TypeScript compilation |
pnpm test | Vitest unit tests |
Pre-commit hooks
Lefthook runs these checks on every commit (configured in lefthook.yml):
| Hook | What it does |
|---|---|
| biome | Lint + format staged .ts, .tsx, .js, .json, .css files |
| gitleaks | Scan for secrets, API keys, and tokens (requires gitleaks binary) |
| large-files | Block files over 500KB (excludes pnpm-lock.yaml) |
| private-key | Block .pem, .key, .p12, .pfx files |
| merge-conflict | Catch leftover conflict markers |
| pii-check | Scan for SSNs, phone numbers, and email addresses |
Ship workflow
neeter includes a ship Claude Code skill in .claude/skills/ that automates the full contribution lifecycle — branching, verification, committing, PR creation, merge, version bump, and tagging:
/shipThe skill walks through each step with approval checkpoints for the commit message, PR body, merge timing, and version bump. See .claude/skills/ship/SKILL.md for the full sequence, or follow it manually when not using Claude Code.
CI
Pull requests to main run lint, build, and test via GitHub Actions. See .github/workflows/ci.yml.
Dependabot opens weekly PRs for npm and GitHub Actions dependency updates.