files-pane
Reviewed
at commit c6ccff9
Sends data to GitHub (api.github.com), through your own signed-in gh CLI, to show the branch's pull request
A file explorer for Claude Code: a live, VS Code-style file tree beside the chat showing what Claude reads, edits and commits, with git status and diffs.
0 upvotes
Log in to upvote or save- Made by
- Marius Adam
- Pinned commit
-
c6ccff980c8b094a2140e436046503586b1c48ca - What we checked
-
Adds a Files pane (and /files) with a VS Code-style tree of the project that shows which files Claude reads, edits and commits, with git status, diffs, file history and a timeline of changes. It runs read-only git commands, asks GitHub's CLI for the branch's pull request, and opens files in your editor or file manager only when you press those actions. It changes no files.
Review details
Static review of the source at the pinned commit; not run. Hooks: session.start and turn.start (one-time setup: registers /files, opens the pane, starts a git read, a baseline snapshot and a polling loop), command.run for /files, tool.call (wraps every tool call and always returns next(e) unchanged; records the file_path of Read/Edit/Write/MultiEdit/NotebookEdit, snapshots git status before and after Bash and other writing tools to attribute changed files, detects git commit/push/gh pr commands by regex to refresh state), turn.step (passes the stream through untouched, showing the tail of Claude's thinking and answer on the pane's card), turn.complete, ui.press and prompt.edit (only close the pane's open menu), ui.render for two panes. Runtime calls: $.process.run for git (always with --no-optional-locks; status, diff, ls-files, log, show with --no-ext-diff --no-textconv, for-each-ref, rev-parse, symbolic-ref, merge-base), gh pr view --json with GH_PROMPT_DISABLED, and editor detection (uname, open -Ra, which, or where plus reading the editor's .cmd shim on Windows); $.fs.list/stat/read for folder listings, file text (2 MB cap, control characters stripped), pictures and git's rebase/merge marker files; $.ui.open/close/panes/scroll/invalidate/copy/toast; $.prompt.fill (only on @ Mention); $.clock timers; $.command.register; plugin atoms for pane state. Git commands that can run repository-configured programs (status, diff, ls-files, log, show) and gh run only in the session's own repository (isTrusted compares git dirs); outside it only rev-parse and show --name-only run. A poll every 3 s or more, only while a pane is shown, relists open folders and runs git status/diff --numstat. On user press only: Open in launches the chosen editor with the file path (no shell; on Windows the exe and script parsed from a VS Code-style code.cmd shim with ELECTRON_RUN_AS_NODE=1), Show in Finder runs open -R, Show in Explorer runs a fixed PowerShell script (passed as -EncodedCommand, path via environment variable) that starts explorer /select and focuses its window. The PR pill is a Link to the PR URL GitHub returns. The pane can browse folders above the project and a Markdown preview reads local images it references; nothing leaves the machine except the gh query. Failures are caught and dropped. No npm dependencies. Read fully: hooks.json, register.tsx, activity.ts, disk.ts, editors.ts, file.tsx, timeline.ts, media.ts, paths.ts, state.ts, diff.ts, diffview.tsx, types; pane.tsx (rendering, 64 KB) read in part and by targeted search for runtime calls, links and actions; look.ts and icons.ts skimmed; the generated icon tables (icon-svgs-*.ts, 330 KB) checked by search to hold only inline SVG strings with no scripts or external references. scripts/gen_icons.py is a developer build script the plugin does not run. The unresolved ../types imports are type-only (types/index.d.ts, included). README and SECURITY.md describe every command it runs and the gh lookup, matching the code.
- What it uses
-
- Reads your prompts: no
- Sees tool calls: yes
- Blocks or changes tool calls: no
- Reads or writes files: yes
- Runs programs on your machine: yes
- Calls the model (uses tokens): no
- Sends data over the network: yes
- Stores data: yes
- Shows something on screen: yes
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/files-pane/)