Claude Code mod
file-trail
Shows which file each Read, Edit and Write touched (Glob and Grep too, where the build has them as tools), with the time and whether it was blocked, in a side pane, the status line and a local file.
Install
/plugin marketplace add nightlab-agent/file-trail
/plugin install file-trail@nightlab-file-trailMods install like plugins. Run /reload-plugins or start a new session to load it.
What it can access
- Reach
- L2Writes or runs: writes files, reads files, reads mod state, draws
- Sees
- classic hooks, every tool call
- Draws in
ToolGroupPane- Hooks
session.startui.rendercommand.runsession.endclassic.PreToolUseclassic.PostToolUseFailuretool.checktool.call
From a static scan of the mod's code by awesome-claude-code-mods. It shows what the code asks for, not a security review.
How Claude Code mods work
- A mod is a plugin with a JavaScript or TypeScript module that runs inside Claude Code (version 2.1.287 or later). It can draw panes beside the transcript, a band above the prompt, buttons and toasts, restyle the spinner and tool rows, and watch or rewrite tool calls and prompts.
- It installs like any plugin: add its marketplace with /plugin marketplace add owner/repo, then /plugin install name@marketplace.
- Check what a mod can reach before installing: it runs with your permissions. Reach goes from drawing only, to reading files, to writing files or running processes, to the network. Run claude plugin validate on a clone to list its hooks and calls without running it.
- Turn one off from the Installed tab in /plugin, or start Claude Code with --safe-mode to skip every customization for a session.
Details
- Repository
- nightlab-agent/file-trail
- Folder
.- Marketplace
nightlab-file-trail- Author
- Nightlab
- License
- MIT
- Last updated
- 7 November 2026
- Listed in
- awesome-claude-code-mods
FAQ
What is file-trail?
Shows which file each Read, Edit and Write touched (Glob and Grep too, where the build has them as tools), with the time and whether it was blocked, in a side pane, the status line and a local file. It is a mod for Claude Code, from nightlab-agent/file-trail on GitHub.
What can the file-trail mod access?
Its widest reach is "writes or runs" (writes files, reads files, reads mod state, draws). It sees classic hooks, every tool call. It draws in ToolGroup, Pane. Like any mod, it runs with your permissions.
How do I install file-trail?
Inside Claude Code (v2.1.287 or later), run /plugin marketplace add nightlab-agent/file-trail and then /plugin install file-trail@nightlab-file-trail.
More guard & safety mods
explain-permission
petershk/explain-permission
Explains each Claude Code permission request in plain English (WHAT, WHY, RISK) in a side pane
flowpane
diwakersurya/flowpane
Side panel for Claude Code: pin rules the model keeps through /compact, flip live guards (read-only, no push, no edits on main, fence, secret shield), queue prompts, one-click snippets, and ask side questions that never enter the conversation
env-guard
ABDUAZIZX/env-guard
Claude Code mod: blocks Claude from reading .env secret files and counts blocked attempts in the status line
freeze
francktrouillez/claude-freeze
Freeze a Claude Code session at the next safe boundary and resume it later as if nothing happened (ctrl+x f, /freeze)
dependency-bouncer
ccdwyer/dependency-bouncer
Vets npm and PyPI packages before they install: blocks hallucinated, typosquatted and brand-new install-script packages, flags risky ones
ghost-proc-guard
thieung/claude-mods
Stops Claude from starting a second copy of your dev servers on the next free port (monorepos and worktrees included), tracks the servers it starts, and stops leftovers from a /procs pane.
Browse the most popular Claude Code mods, all guard & safety mods, or the skills and MCP server directories.