Skip to content

v0.1.0

Choose a tag to compare

@karlkfi karlkfi released this 18 Jul 19:01
b165980

Initial release: a PreToolUse hook for Bash that guards the session's main-thread time.

  • feat: initial foreground-guard plugin by @karlkfi in #1

Class A catches foreground polling/watching — gh pr checks --watch, gh run watch, kubectl logs -f / get -w, tail -f, journalctl -f, docker logs -f, watch, sleep-polling loops, repeat-with-sleep chains, and bare sleep at or above a configurable floor — and prompts ask (config may escalate to deny). Class B catches commands the repo has registered as slow when they are about to run with an inadequate Bash-call timeout, naming the exact fix; its registry ships empty and is populated per-repo in .claude/foreground-guard.json. Exemptions: run_in_background: true, a detaching &, and timeout N wraps. The hook never emits allow, so it composes with the sibling guards; FOREGROUND_GUARD_OVERRIDE=<reason> downgrades a config-escalated deny to a confirmation prompt.

Full Changelog: https://github.com/karlkfi/claude-foreground-guard/commits/v0.1.0