Skip to content
Back to search

claude-code-filetree

MarketplaceWorks with Claude CodeGitHub

An IDE-style file tree for Claude Code that shows what Claude is doing and where in files

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026. Its scripts were only partly scanned.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/data-goblin/claude-code-filetree with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/data-goblin/claude-code-filetree'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/data-goblin--claude-code-filetree/badge.svg)](/listings/data-goblin--claude-code-filetree)

HTML

<a href="/listings/data-goblin--claude-code-filetree"><img src="/api/listings/data-goblin--claude-code-filetree/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

The repo is its own plugin marketplace. Run this in the terminal:

claude plugin marketplace add data-goblin/claude-code-filetree
claude plugin install filetree@claude-code-filetree

Or inside a Claude Code session:

/plugin marketplace add data-goblin/claude-code-filetree
/plugin install filetree@claude-code-filetree

Installed it as `filetree@filetree` before the repository was renamed? Nothing to do: that install keeps loading and keeps receiving updates.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 16 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "claude-code-filetree",
  3. "owner": {
  4. "name": "Kurt Buhler"
  5. },
  6. "metadata": {
  7. "description": "An IDE-style file tree for Claude Code that shows what Claude is doing and where in files"
  8. },
  9. "plugins": [
  10. {
  11. "name": "filetree",
  12. "description": "File tree of the session cwd with git status, lines changed, shimmer on files Claude touches and its git activity",
  13. "source": "./"
  14. }
  15. ]
  16. }
README.md · README · 184 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <h1 align="center">Claude Code Filetree</h1>
  2. <p align="center">
  3. An IDE-style file tree for Claude Code that shows what Claude is doing and where in files
  4. </p>
  5. <p align="center">
  6. <img src="https://img.shields.io/badge/Claude_Code-%E2%89%A5_2.1.306-D97757?logo=claude&logoColor=fff" alt="Claude Code 2.1.306 or newer">
  7. <img src="https://img.shields.io/badge/version-0.8.5-blue" alt="Version">
  8. <img src="https://img.shields.io/badge/type-mod-6f42c1" alt="Claude Code mod">
  9. <img src="https://img.shields.io/badge/license-MIT-green" alt="License">
  10. </p>
  11. <details open>
  12. <summary><b>Claude Code CLI</b></summary>
  13. <p align="center">
  14. <img src="media/filetree-shimmer.gif" alt="filetree shimmering the file Claude is editing" width="900">
  15. </p>
  16. </details>
  17. <details>
  18. <summary><b>Claude Code in Desktop App</b></summary>
  19. <p align="center">
  20. <img src="media/0.8.2/desktop-light.png" alt="The file tree in the Desktop app in light mode, with the header buttons including the Clawd shimmer button, the branch row, search row and folders" width="600">
  21. </p>
  22. </details>
  23. **Key features:**
  24. * Show/nav all files in a directory (with support for Git status, nvim bindings)
  25. * Animations show where Claude is reading/working
  26. * Keyboard shortcuts:
  27. * Nav directories with `z` (zoxide-like)
  28. * Search with `s` or `i` (in highlighted folder) or `q` (in file contents)
  29. * Diff files with `d` or all changed files in a folder
  30. * Terminal-first features: File previews, directory size treemap, and more
  31. ---
  32. ## Installation
  33. The repo is its own plugin marketplace. Run this in the terminal:
  34. ```bash
  35. claude plugin marketplace add data-goblin/claude-code-filetree
  36. claude plugin install filetree@claude-code-filetree
  37. ```
  38. Or inside a Claude Code session:
  39. ```text
  40. /plugin marketplace add data-goblin/claude-code-filetree
  41. /plugin install filetree@claude-code-filetree
  42. ```
  43. An install fails with `Unrecognized key: "options"` on Claude Code older than 2.1.287: run `claude update`, then install again.
  44. ## Features
  45. - File tree of the cwd or a pinned folder, with Git, size, line count and date columns ([tree](docs/tree.md))
  46. - Collapse all, and expand all up to three levels deep ([tree](docs/tree.md))
  47. - Symlink arrows, a brain on agent instruction files, and Nerd Font, plain or text glyphs ([tree](docs/tree.md))
  48. - Search by name across unopened folders, by case or regular expression, scoped to one folder ([search](docs/search.md))
  49. - Search inside files with `git grep` or `grep -r`, and open a match at its line ([search](docs/search.md))
  50. - Jump to any folder zoxide style with `z` ([search](docs/search.md))
  51. - Git status per file and folder, line counts on changed files, and the branch with ahead and behind ([git](docs/git.md))
  52. - Git and GitHub commands Claude runs show as a status line ([git](docs/git.md))
  53. - Claude's reads, writes and commits shimmer in the tree, and auto-collapse closes the folders it opened ([activity](docs/activity.md))
  54. - The Activity shimmer setting turns the shimmer off in every session; the Clawd button in the Desktop app header flips it ([activity](docs/activity.md))
  55. - File references with a line in Claude's replies become links to that line ([activity](docs/activity.md))
  56. - Follow work moves the session to the repo Claude works in ([activity](docs/activity.md))
  57. - IDE-style multi-select; the shaded rows go to Claude as context: the selected row, or up to 100 marked rows ([context](docs/context.md)):
  58. - click selects one row and clears the marks
  59. - with rows marked, j / k move only the cursor, and `v` marks or unmarks the row under it
  60. - shift+click marks the range from the last click or j / k move, in tree order
  61. - ctrl+click marks or unmarks one row without opening it; alt+click on macOS
  62. - double-click or Enter opens a file
  63. - the clear selection button clears every marked and selected row
  64. - marked rows show the selection background; `y`, `Y` and `u` copy the shaded rows
  65. - with rows marked, the row under the cursor shows an accent tint in the Desktop app and the accent cursor mark in the terminal
  66. - Split preview of code, Markdown, images, video frames, PDF and Word pages ([preview and treemap](docs/preview-treemap.md))
  67. - Treemap of a folder by bytes or lines, with Claude's activity lit ([preview and treemap](docs/preview-treemap.md))
  68. - Diff of a file or every changed file in a folder, in the pane or your diff tool ([diff](docs/diff.md))
  69. - Open files in their default app, an editor in a tmux or herdr pane, or any command ([open](docs/open.md))
  70. - Guard files and folders from Claude's edits, and see files written outside the repo ([guards](docs/guards.md))
  71. - Keyboard-driven: vim-style moves, a shortcuts overlay, and alt+l / alt+h in the terminal ([keys](docs/keys.md))
  72. - `/filetree` commands and where the pane shows in the terminal and the Desktop app ([sidebar](docs/sidebar.md))
  73. <img src="media/filetree-git.gif" alt="A committed file shimmers green and the footer shows the commit" width="800">
  74. <img src="docs/media/preview-media.gif" alt="An image, a video, a PDF turned to page 2 and a Word document in the preview" width="800">
  75. ## Settings
  76. All settings are in `/config` under filetree, each with its own description there.
  77. ```yaml
  78. Claude activity: reads and writes | writes | reads | none
  79. Activity shimmer: on | off
  80. Follow Claude: on | off
  81. Jump moves Claude: tree and Claude | tree
  82. Right-click copies: relative | absolute
  83. Follow work: on | off
  84. Open at start: on | off
  85. Focus on open: on | off
  86. Right column: date | age | size | loc | files
  87. Date format: year-month-day | day-month | month-day
  88. Clock: 24h | 12h
  89. Long file: 500 | a line count | off
  90. Remote branch: off | on
  91. Hints: on | off
  92. Search spacing: on | off
  93. Column headers: on | off
  94. Auto-collapse: off | on
  95. Shortcuts: auto | always | off
  96. Open with: empty | editor | preview | a command with {path} and {dir}
  97. Binary files: Open with | default app
  98. Edit with: empty | a command with {path} and {line}
  99. Diff with: empty | a command such as "hunk diff --" or "lazygit -f"
  100. Diff groups: folder | kind | off
  101. Terminal target: auto | pane right | pane below | tab | workspace
  102. Ignore: names to hide, such as ".cache .tmp"
  103. Preview pane: bottom | top
  104. Treemap: auto | image | cells | off
  105. Palette: key=#hex pairs over the terminal colors
  106. Glyphs: auto | nerd | plain | text
  107. ```
  108. In the terminal the accent colors folders, the root, the cursor, search matches and the top-level boxes of the cells treemap. It is the terminal's bright blue with a dark Claude theme and its blue with a light one. `accent=#hex` in Palette sets another color for all of them.
  109. Follow work is described in [Claude activity](docs/activity.md).
  110. Open at start applies to every new session, `/clear` included. When you open or close the tree with `/filetree`, that choice lasts until the next `/clear`. After `/clear`, the tree is open or closed as Open at start says.
  111. ## Requirements
  112. ```yaml
  113. required: Claude Code 2.1.306 or newer, git
  114. optional:
  115. inotifywait: live updates on Linux (inotify-tools)
  116. magick or ffmpeg: images other than PNG, video frames
  117. pdftoppm or gs: PDF pages
  118. soffice: Word and office pages
  119. pandoc, pdftotext: document text in tmux, herdr and other terminals
  120. tmux or herdr: an editor or diff tool in a new pane
  121. Nerd Fonts 3.2+: icons for Glyphs auto, which draws plain Unicode without one or with an older one
  122. pictures: Ghostty or kitty, outside tmux and herdr, on Linux and macOS
  123. ```
  124. ## Considerations
  125. - The Desktop app has no split preview or treemap
  126. - The Desktop app shimmers at most four rows at once; more lit rows show in their color without the shimmer, while the terminal shimmers them all. If the pane still floods, the Clawd button in the header or the Activity shimmer setting turns the shimmer off
  127. - The Desktop app draws at most 150 rows around the cursor, and fewer when rows are deep, have long paths or show git changes; a note counts the rows it leaves out
  128. - GIFs and videos show one still frame
  129. - Windows sizes folders through file listings, and the treemap draws one level
  130. - Row clicks need herdr 0.9.1 or later; run `herdr update`
  131. ## Contributing
  132. Open pull requests against a release branch, not `main`:
  133. - Fixes: the patch branch, such as `release/0.8.2`
  134. - Features: the minor branch, such as `release/0.9.0`
  135. Keep the version of that branch.
  136. Turn on the git hooks once per clone. The pre-commit hook runs the fast checks in seconds: grep rules, types, oxlint, and `claude plugin validate` when the manifests change. The pre-push hook checks the version against the release branch and runs the plugin tests:
  137. ```bash
  138. git config core.hooksPath .githooks
  139. ```
  140. The same checks run on macOS, Windows and Linux in CI on every push that touches the plugin.
  141. ## License
  142. [MIT](LICENSE). The treemap labels use glyphs from [Terminus Font](https://terminus-font.sourceforge.net/) by Dimitar Zhekov (Lat2-Terminus16, SIL Open Font License 1.1).
  143. *This project is inspired by my Omarchy app [FileBlade](https://github.com/data-goblin/fileblade)*

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.