filetree
Reviewed
at commit 3ce5b1c
New version, not yet reviewed
An IDE-style file tree for Claude Code that shows what Claude is doing and where in files
0 upvotes
Log in to upvote or save- Made by
- Kurt Buhler
- Pinned commit
-
3ce5b1c44ac90f6f7a10106c08a7be88cdcbdf00 - What we checked
-
Shows an IDE-style file tree of your working folder in a side pane, with git status, search, diffs and previews, and highlights files Claude reads, writes or commits. It runs git, find, du and installed viewers, adds the selected file to your prompt, blocks Claude's edits to paths you guard, and by default moves the session with /cd to a repo Claude keeps working in. No network calls.
Review details
Static review of the source at the pinned commit; not run. Full re-review of 0.8.3 (the diff since a6d9ed7 was too large for a delta review). Registers /filetree (args: path, open, keys) and hooks session.start, session.end, config.set, command.run, tool.call (Bash/PowerShell/Edit/Write/NotebookEdit, Read, Grep, Glob), tool.check (Edit/Write/NotebookEdit/Bash/PowerShell), turn.start, turn.complete, prompt.submit, ui.message, ui.focus, ui.scroll, ui.close and ui.render (Pane, and AssistantMessage). tool.call hooks only observe: they await next(e) and return the result unchanged, parsing Bash command text to label git actions, read targets and write targets. New: tool.check enforces guards the user sets with x in the tree (kept in $.store under 'guards'): Edit/Write/NotebookEdit on a guarded path (also via symlink real paths) is denied with a reason, and a shell command whose text names a guarded path is escalated to ask the person; it never approves anything and passes through when no guards exist. New: Follow work (setting work, default on, disclosed in docs/activity.md) scores repos Claude reads and writes in via git rev-parse and, at most every two minutes, runs $.command.run cd to that repo after a turn, skipping temp folders, ~/.claude, ~/.config, ~/Library, ~/.cache, ~/.local and hard-coded 'agents vault' paths (~/Git/agents, ~/vault and similar; exclusions only); the z jump list (zoxide query plus its own visit history in $.state, up to 500 folders) also runs cd on Enter; Claude Code's /cd asks before entering an untrusted folder; setting jump=tree keeps Claude in place. New: /filetree keys reads ~/.claude/keybindings.json (or CLAUDE_CONFIG_DIR) and, only after a $.ui.ask confirmation (and a second one before replacing a clashing binding), merges alt+l/alt+h focus bindings into it, writing via a temp file plus mv on Unix; it refuses unparsable, non-regular or read-only files. New: ui.render on AssistantMessage strips emoji variation selectors outside code in the terminal and appends 'in the file tree' links for file:line references that exist inside the tree, which open the preview. $.config.set only flips its own shimmer setting from the header button. prompt.submit appends one context line naming the selected or marked tree entries and reveals @mentioned paths; the text goes only to Claude. Programs run (all argv arrays, user strings passed as arguments, timeouts): git --no-optional-locks (status, diff, ls-files, rev-parse, hash-object, diff --no-index, diff-tree, grep for content search) so a repository's own git config is honoured as with any git use; find -xdev, du, grep -c and a fixed stat/awk script for sizes, line counts, file counts and folder times; grep -rnIH for content search outside git; inotifywait on Linux (stopped at session end); uname, od, readlink, test, chmod/mv/rm on its own temp files, touch/rm -f on its own marker files in TMPDIR; zoxide query; a fixed sh script (fc-list, stat, ps, awk) for Nerd Font detection; herdr --version; python3 -I with a fixed ioctl snippet and a /proc walk plus ghostty +show-config for cell size and colours (image treemap only). Previews convert pictures, video frames, PDF and office pages to PNG through a fixed sh script calling magick (restrictive policy.xml), ffmpeg (file protocol only), pdftoppm or gs -dSAFER, pdfinfo, pdftotext, pandoc and soffice --headless, only if on PATH; output goes to a private 0700 cache folder under XDG_RUNTIME_DIR or TMPDIR, capped, and removed at session end with a guarded rm -rf. User-triggered actions: double-click, Enter or the arrow button opens a file with the OS default app (open, gio/xdg-open, PowerShell Process.Start), so opening an executable or script runs it as from a file manager; Quick Look on macOS; t opens a shell in a tmux or herdr pane; optional Open with, Edit with and Diff with settings run your command or $VISUAL/$EDITOR in tmux, herdr or xdg-terminal-exec, split on spaces without a shell, empty by default; y/Y/u copy paths via $.ui.copy. Reads project files for the preview (text up to 4 MB), .git pointer files, Ghostty config files and keybindings.json. No network calls, no $.model calls, no npm dependencies, no eval; font.ts base64 is a bitmap font decoded only as glyph bits. Failures are caught and shown as toasts or ignored. Read in full: hooks.json, plugin.json, register.tsx except the Pane render JSX (covered by targeted search of its event handlers and runtime calls; only UI calls), open.ts, keybind.ts, peek.ts, git.ts, diff.ts, jump.ts, work.ts, loc.ts, term.ts, refs.ts, guard.ts, keys.ts; treemap.ts, pixmap.ts, svg.ts, palette.ts, icons.ts, tree.ts, regex.ts, rows.tsx, button.tsx, hit.tsx, zone.tsx, font.ts and types covered by targeted search for process, file, network, environment and eval calls (none). The .githooks, scripts/ and workflow files are developer tooling the plugin does not load.
- What it uses
-
- Reads your prompts: yes
- Sees tool calls: yes
- Blocks or changes tool calls: yes
- Reads or writes files: yes
- Runs programs on your machine: yes
- Calls the model (uses tokens): no
- Sends data over the network: no
- Stores data: yes
- Shows something on screen: yes
- Hooked events
An IDE-style file tree for Claude Code that shows what Claude is doing and where in files
Made this mod? Add a badge to your README
Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.
[](https://modsforclaude.com/mods/filetree/)