Open Source · MIT License · Self-host

Access Control
for Claude Code

Log every tool call, block unwanted domains, and protect sensitive files. Self-hosted, runs entirely on your machine.

$ pip install krabb && krabb init
Self-host
MIT Licensed
Python 3.10+

What it does

krabb hooks into Claude Code and gives you visibility and control over what it accesses.

Tool Logging

Log every WebFetch, WebSearch, Bash, Read, Write, and Edit call to a local SQLite database.

Domain Blocklist

Block specific domains with exact match, wildcard patterns, or full regex support.

File Protection

Prevent Claude from modifying sensitive files using flexible glob patterns.

Dashboard

Web UI at localhost:4242 with live event monitoring, session tracking, and stats.

Filtering & Grouping

Search, filter by tool type or decision, and group events by session or domain.

CLI

Manage everything from the terminal — status, logs, blocklist, and configuration.

Use cases

How krabb helps you keep Claude Code in check.

Block suspicious domains

Prevent Claude Code from fetching content from untrusted or malicious websites.

evil-site.comblocked
*.phishing.netblocked
/tracking\.\w+\.com/blocked

Protect sensitive files

Stop Claude from reading or modifying credentials, environment variables, and secrets.

*.envblocked
*.pemblocked
credentials.jsonblocked

Audit web access

See exactly which URLs Claude is fetching and what search queries it runs.

WebFetchapi.example.com/users
allow
WebSearch"how to parse JSON"
allow
WebFetchsketchy-cdn.io/script.js
deny

Monitor tool usage

Track every Bash command, file read/write, and edit that Claude performs in your project.

Bashnpm install express
allow
Writesrc/config/db.ts
allow
Edit.env.local
deny

Getting started

terminal
# install
$ pip install krabb
# register hook and start daemon
$ krabb init
# open the dashboard
$ krabb dashboard
→ running at localhost:4242

Requires Python 3.10+. Full docs

Dashboard

Browse events, manage rules, and view stats at localhost:4242.

krabb dashboard — localhost:4242
krabb v0.1
Events Today
142
Blocked
3
Top Domain
github.com
Sessions
2
Recent Events
TimeToolDetailStatus
14:23:01WebFetchgithub.com/petricbranko/krabbAllow
14:22:48WebSearch"react hooks best practices"Allow
14:22:35Bashnpm install lucide-reactAllow
14:21:59WebFetchevil-site.com/payload.jsDeny
14:21:44WebFetchdocs.python.org/3/libraryAllow

Installation

Requires Python 3.10+. Works on macOS and Linux.

terminal
# Install from PyPI
$ pip install krabb
# Initialize and start the daemon
$ krabb init
# Check status
$ krabb status
# Open the dashboard
$ krabb dashboard

Full documentation on GitHub

Frequently Asked Questions

Everything you need to know about krabb.