git404hub

what is tracewall fr?

vinayjogani14/tracewall — explained in plain English

Analysis updated 2026-05-18

5PythonAudience · developerComplexity · 3/5LicenseSetup · easy

tl;dr

A local security tool that records every action an AI coding agent takes and can block it from leaking private data through a prompt injection attack.

vibe map

mindmap
  root((tracewall))
    What it does
      Records agent tool calls
      Tracks lethal trifecta taint
      Blocks data exfiltration
    Tech stack
      Python
      PyPI package
      MCP proxy
    Use cases
      Session replay
      Egress blocking
      Cross agent policy
    Audience
      Developers
      Security minded users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Record and replay every tool call an AI coding agent makes during a session.

VIBE 2

Block an agent from sending private data like SSH keys or credentials to an outside server.

VIBE 3

Apply one consistent safety policy across multiple AI agent tools through its MCP proxy.

VIBE 4

Choose a strictness level that matches how much you trust the agents you run.

what's the stack?

PythonPyPIMCP

how it stacks up fr

vinayjogani14/tracewall1ncendium/aibusteraaronmayeux/ha-hurricane-tracker
Stars555
LanguagePythonPythonPython
Setup difficultyeasymoderateeasy
Complexity3/53/52/5
Audiencedeveloperops devopsgeneral

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min
Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

Tracewall is a local security tool that watches everything an AI coding agent does, such as Claude Code, and can stop it from leaking your private data. It works by recording every single tool call the agent makes, things like reading a file, running a shell command, or fetching a web page, and it keeps track of a dangerous combination of events across a whole session called the lethal trifecta: the agent has read private data, it has also been exposed to untrusted content such as a web page, and it now tries to send data somewhere outside the machine. When all three line up, tracewall can block the action before it happens, since that pattern usually means a prompt injection has tricked the agent into stealing information. It installs with a simple pip install and then wires itself into Claude Code's settings so every session gets recorded automatically to a local folder, with no cloud account and no extra dependencies needed. By default it only warns, called audit mode, but a single command switches it into enforce mode so it actually blocks risky actions instead of just logging them. There are three strictness profiles: standard, which mainly cares about sensitive files like SSH keys and only blocks the full trifecta pattern, strict, which treats any file read as potentially private, and paranoid, which blocks almost any outgoing connection once private data has been touched at all. Beyond the basic hook, tracewall includes an optional network proxy that inspects the agent's actual outgoing web traffic rather than just guessing from the command text, and a separate proxy for the Model Context Protocol so the same protection can apply to other AI agent tools beyond Claude Code, not only Claude specific ones. The project is upfront that this proxy layer only catches traffic that respects standard proxy settings, and that some low level tricks could still slip past it. Once installed, commands let you replay a recorded session in the terminal, export it as a shareable HTML report, or run a built in demo that stages a fake attack so you can see the blocking in action. It is written in Python, requires Python 3.10 or newer, and is released under the MIT license.

prompts (copy fr)

prompt 1
Help me install tracewall and wire it into my Claude Code settings.
prompt 2
Explain the difference between the standard, strict, and paranoid profiles in tracewall.
prompt 3
Show me how to run the demo that stages a prompt injection attack in tracewall.
prompt 4
Walk me through setting up the tracewall network proxy for egress monitoring.

Frequently asked questions

what is tracewall fr?

A local security tool that records every action an AI coding agent takes and can block it from leaking private data through a prompt injection attack.

What language is tracewall written in?

Mainly Python. The stack also includes Python, PyPI, MCP.

What license does tracewall use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is tracewall to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is tracewall for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.