# Userscripts

A flat collection of standalone browser userscripts (Tampermonkey / Violentmonkey / Greasemonkey).

## Core Rule: One Self-Contained File Per Script

Each userscript is a single `*.user.js` file at the repo root. A script owns everything it needs — metadata header, styles, and logic — in that one file.

- No shared modules, no build step, no bundler. A file must install and run as-is by pasting it into a userscript manager.
- New script → new `name.user.js` file. Do not factor common code into helpers across files; duplication across scripts is acceptable and expected here.
- Every file starts with a complete `==UserScript==` metadata block (`@name`, `@namespace`, `@version`, `@description`, `@match`, `@run-at`, and any `@grant`/`@connect`).

## Linting

[oxlint](https://oxc.rs) lints all scripts. It's a pnpm devDependency (pinned in `package.json` / `pnpm-lock.yaml`), not a Nix package. Config: `.oxlintrc.json` (browser + greasemonkey env, GM globals declared, `_scratch/` ignored).

```bash
pnpm lint         # lint every *.user.js
```

Keep scripts warning-clean.

## Dev Environment

direnv (`.envrc` → `use flake`) auto-loads the Nix flake, which provides `nodejs` + `pnpm` and runs `pnpm install` via its `shellHook`, so `oxlint` is on `PATH` automatically.