Skip to content

Add environment variable toggles to disable hooks per-project #10

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
tyom merged 1 commit into from
Jan 16, 2026
Merged

Add environment variable toggles to disable hooks per-project #10

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 45 additions & 0 deletions claude-plugin/hooks/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
# Hooks

Claude Code hooks that run automatically during various events.

## Available Hooks

### PostToolUse: Lint and Typecheck

**Trigger:** After `Edit`, `MultiEdit`, or `Write` operations on supported files.

**Actions:**

- TypeScript type checking (if tsconfig.json present)
- Prettier formatting (auto-fixes if needed)
- ESLint linting

**Supported file extensions:** `.ts`, `.tsx`, `.js`, `.jsx`, `.mjs`, `.mts`, `.md`, `.mdx`, `.json`, `.yaml`, `.yml`, `.css`, `.scss`, `.html`

### Stop: Run Tests

**Trigger:** Before Claude stops working.

**Actions:**

- Detects test runner (bun, npm, yarn, pnpm, vitest, jest, mocha)
- Runs project tests
- Blocks stopping if tests fail

## Configuration

Both hooks can be disabled per-project using environment variables in `.claude/settings.local.json`:

```json
{
"env": {
"LINT_ON_SAVE": "false",
"RUN_TESTS_ON_STOP": "false"
}
}
```

| Variable | Default | Description |
| ------------------- | ------- | ------------------------------------------------------- |
| `LINT_ON_SAVE` | `true` | Enable/disable lint, typecheck, and format on file save |
| `RUN_TESTS_ON_STOP` | `true` | Enable/disable running tests before stopping |
7 changes: 7 additions & 0 deletions claude-plugin/hooks/post-tool-use/lint-and-typecheck.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -130,12 +130,19 @@ function runCommand(
* Aggregates tool outputs as errors or warnings. Prints errors to stderr and exits with code 2;
* prints warnings to stdout and exits with code 0 on success or when no action was necessary.
*
* Can be disabled by setting LINT_ON_SAVE=false environment variable.
*
* @remarks
* Exit codes:
* - 0: success or no applicable action
* - 2: blocking errors detected (TypeScript, Prettier, or ESLint)
*/
async function main() {
// Check if linting is disabled via environment variable (default: enabled)
if (process.env.LINT_ON_SAVE === "false") {
process.exit(0);
}

let input: ToolInput;

try {
Expand Down
7 changes: 7 additions & 0 deletions claude-plugin/hooks/stop/run-tests.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -225,8 +225,15 @@ async function findProjectRoot(): Promise<string> {
* Reads JSON input from stdin to detect an active stop hook; if present, allows stopping immediately.
* Locates the project root and detects an appropriate test runner; if no runner is found or no test files exist, allows stopping.
* Executes the detected test suite; if tests fail, writes a JSON decision object to stdout with `decision: "block"` and a `reason` that includes the test output, then exits.
*
* Can be disabled by setting RUN_TESTS_ON_STOP=false environment variable.
*/
async function main() {
// Check if tests on stop are disabled via environment variable (default: enabled)
if (process.env.RUN_TESTS_ON_STOP === "false") {
process.exit(0);
}

let input: StopHookInput = {};

try {
Expand Down