Skip to content

Releases

Gatekeeper 0.2.2

Choose a tag to compare

@AgriciDaniel AgriciDaniel released this 23 Sep 18:53
v0.2.2
9365a4c

Small follow-up to 0.2.1.

  • Flatpak editors: the key is also found in ~/.config/gatekeeper/env when XDG_CONFIG_HOME points into a sandbox, as it does in the VS Code Flatpak. Before, hooks in those sessions could not find the key and failed open (nothing was blocked, but nothing was judged).
  • Per-project logs: python3 scripts/install_hooks.py --project <dir> --gate <gate> --home <folder> --apply gives that project's hooks their own log and state folder, handy for demos and client work. doctor understands the new hook command.

168 offline tests pass on Python 3.11, 3.12 and 3.13. Full notes in CHANGELOG.md.

Gatekeeper 0.2.1

Choose a tag to compare

@AgriciDaniel AgriciDaniel released this 23 Sep 18:33
v0.2.1
fe5c644

First release. Gatekeeper decides which Claude Code agent or skill should handle a prompt before Claude picks one: YAML rules decide what code can decide, and Jev (TypeSafe System One) makes the one semantic call as a typed Choice with a confidence.

Highlights

  • Two rosters. Route to your installed agents, skills and plugins, or to Markdown procedures listed in a JSON index.
  • Rollup by group. When no single skill is confident, probabilities are summed by role, so a vague request still reaches the right team.
  • Three modes. shadow logs what it would do, advise adds the route as context and never blocks, enforce also denies calls that break a confident route or a forbid rule. Every install starts in shadow.
  • Fails open. A Jev outage, a timeout, a missing dependency or a bad argument never blocks a session.
  • doctor. Catches the silent failures: a missing key, a retired model, hooks or skill links left behind by a moved folder, a rising fail-open rate.
  • Example gate. examples/marketing-team/: 24 skills in 11 roles, advise mode, rollup and a bench.

Security and privacy

  • Your TypeSafe key is read from the environment, GATEKEEPER_ENV_FILE or ~/.config/gatekeeper/env, and is never printed or logged.
  • Prompts are masked (the key itself, API keys, tokens, JWTs, private keys, credentials in URLs) before they go to TypeSafe or the local log. The log keeps a hash and a 120-character excerpt, readable only by you.
  • See SECURITY.md for what is sent and how to report a problem.

Install

git clone https://github.com/AgriciDaniel/gatekeeper.git && cd gatekeeper
pip install -e ".[test]" && python3 -m pytest -q
python3 scripts/install_hooks.py --global --skill            # dry run
python3 scripts/install_hooks.py --global --skill --apply    # shadow mode
bin/gatekeeper doctor

Checks

166 offline tests (93% line coverage) on Python 3.11, 3.12 and 3.13; clean-container install, hook and uninstall tests; a security audit and a docs-versus-code audit. Full details in CHANGELOG.md.