convez.ai
Hook
ch4nn0n

fencepost

ch4nn0n/fencepost

Ver no GitHub
BomPluginScore · de 0 a 100

A configurable permission gate for every Claude Code tool call

Instalação

$npx convez-ai ch4nn0n/fencepost

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
85%
Último commit
há 2 meses
Versão
v0.13.1
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

fencepost

A configurable permission gate for every Claude Code tool call.

CI Docs License: GPL v3

fencepost installs as a Claude Code plugin and runs on the PreToolUse hook (plus PostToolUse for secrets redaction), so it sees every tool call before it happens and evaluates it against a YAML rule set you control. Each call resolves to one of three decisions:

DecisionWhat happensReason shown to
allowThe tool runs, silently (fast path).—
askClaude Code prompts you to approve.You
denyThe tool is blocked, with an actionable alternative.Claude

A denial isn't a dead end: fencepost steers Claude toward the suggested alternative instead of letting it retry the same wall.

fencepost is meant to be your permission layer. Run Claude Code in bypassPermissions mode and the YAML rule set becomes the single gate — Claude's native prompts step aside while fencepost's allow/ask/deny still decide every call.

📖 Full documentation: ch4nn0n.github.io/fencepost

Why

  • Curated, shareable rules. Import battle-tested rule sets for git, kubernetes, helm, ansible, filesystem and more with one line.
  • Real bash understanding. Commands are parsed with tree-sitter, not pattern-matched — fencepost reasons about redirections, every argument, compound commands, and even inline python -c / node -e snippets.
  • A scratch sandbox. Funnel temp files into /tmp/claude and scope destructive permissions to it; the rest of the filesystem stays gated.
  • Secrets protection. Using whichever of gitleaks (recommended) / betterleaks / trufflehog / detect-secrets you have installed, fencepost denies tool inputs that embed credentials and redacts secrets from tool output before they reach the model.
  • Fail-closed safety. A broken security config denies everything until a human fixes it, rather than silently degrading.
  • An audit trail. Every decision is logged; the /audit skill turns real usage into concrete config suggestions.

fencepost ships as a small committed JS bundle (~280 KB plus the tree-sitter grammars), so there's no build step for users and no large binary to download. It runs on Node (which you already have if you run Claude Code via npm) or Bun.

Install

The repository doubles as a single-plugin marketplace:

/plugin marketplace add ch4nn0n/fencepost
/plugin install fencepost@fencepost

The hooks register and the gate is live on the next tool call. Run Claude with fencepost as the sole gate:

claude --permission-mode bypassPermissions

This drops Claude's own prompts and lets your config decide. It also disables Claude's other safety nets, so use it in a container or VM and keep default/onError at ask or deny — see permission modes. To try it against a clone without installing:

git clone https://github.com/ch4nn0n/fencepost.git
claude --permission-mode bypassPermissions --plugin-dir ./fencepost

See the installation guide for details.

Quick start

Create .claude/fencepost.yaml in your project:

import:
  - claude        # allow Claude's built-in tools + enable the /tmp sandbox
  - git           # sensible git porcelain rules

default: ask      # what to do when nothing matches
onError: ask      # what to do when a command can't be checked

That's enough to be useful:

git status            # → allow (silent)
git push origin main  # → ask   (you approve)
git push --force      # → deny  (steered to --force-with-lease)

Layer your own rules on top — imports are the base, your rules always win. See the configuration guide.

Bundled presets

claude · claude-web · git · gh · kubernetes · helm · helmfile · ansible · context7 · playwright · filesystem · python-safety · secrets

See the preset reference.

Development

bun install
bun test             # run the test suite
bun run typecheck    # tsc --noEmit
bun run build        # bundle src/ → dist/index.js (+ wasm grammars)
bun run dev          # run the entry point directly

dist/ is committed on purpose — it's the artifact the plugin ships — so rebuild and commit it whenever you change src/.

The documentation site lives in docs/ (Docusaurus):

cd docs
bun install
bun start            # dev server with HMR
bun run build        # static site → docs/build/

Releases

Releases are automated with release-please. Write Conventional Commits (feat:, fix:, …); release-please maintains a release PR that bumps the version (in both package.json and .claude-plugin/plugin.json) and updates CHANGELOG.md. Merging that PR tags the release and publishes a ready-to-install plugin archive.

License

GNU General Public License v3.0 or later.

Ver o original no GitHub

Bom para

Relacionados