claude-code-filetree
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.
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
Markdown
[](/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.
- {
- "name": "claude-code-filetree",
- "owner": {
- "name": "Kurt Buhler"
- },
- "metadata": {
- "description": "An IDE-style file tree for Claude Code that shows what Claude is doing and where in files"
- },
- "plugins": [
- {
- "name": "filetree",
- "description": "File tree of the session cwd with git status, lines changed, shimmer on files Claude touches and its git activity",
- "source": "./"
- }
- ]
- }
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.
- <h1 align="center">Claude Code Filetree</h1>
- <p align="center">
- An IDE-style file tree for Claude Code that shows what Claude is doing and where in files
- </p>
- <p align="center">
- <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">
- <img src="https://img.shields.io/badge/version-0.8.5-blue" alt="Version">
- <img src="https://img.shields.io/badge/type-mod-6f42c1" alt="Claude Code mod">
- <img src="https://img.shields.io/badge/license-MIT-green" alt="License">
- </p>
- <details open>
- <summary><b>Claude Code CLI</b></summary>
- <p align="center">
- <img src="media/filetree-shimmer.gif" alt="filetree shimmering the file Claude is editing" width="900">
- </p>
- </details>
- <details>
- <summary><b>Claude Code in Desktop App</b></summary>
- <p align="center">
- <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">
- </p>
- </details>
- **Key features:**
- * Show/nav all files in a directory (with support for Git status, nvim bindings)
- * Animations show where Claude is reading/working
- * Keyboard shortcuts:
- * Nav directories with `z` (zoxide-like)
- * Search with `s` or `i` (in highlighted folder) or `q` (in file contents)
- * Diff files with `d` or all changed files in a folder
- * Terminal-first features: File previews, directory size treemap, and more
- ---
- ## Installation
- The repo is its own plugin marketplace. Run this in the terminal:
- ```bash
- claude plugin marketplace add data-goblin/claude-code-filetree
- claude plugin install filetree@claude-code-filetree
- ```
- Or inside a Claude Code session:
- ```text
- /plugin marketplace add data-goblin/claude-code-filetree
- /plugin install filetree@claude-code-filetree
- ```
- An install fails with `Unrecognized key: "options"` on Claude Code older than 2.1.287: run `claude update`, then install again.
- ## Features
- - File tree of the cwd or a pinned folder, with Git, size, line count and date columns ([tree](docs/tree.md))
- - Collapse all, and expand all up to three levels deep ([tree](docs/tree.md))
- - Symlink arrows, a brain on agent instruction files, and Nerd Font, plain or text glyphs ([tree](docs/tree.md))
- - Search by name across unopened folders, by case or regular expression, scoped to one folder ([search](docs/search.md))
- - Search inside files with `git grep` or `grep -r`, and open a match at its line ([search](docs/search.md))
- - Jump to any folder zoxide style with `z` ([search](docs/search.md))
- - Git status per file and folder, line counts on changed files, and the branch with ahead and behind ([git](docs/git.md))
- - Git and GitHub commands Claude runs show as a status line ([git](docs/git.md))
- - Claude's reads, writes and commits shimmer in the tree, and auto-collapse closes the folders it opened ([activity](docs/activity.md))
- - 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))
- - File references with a line in Claude's replies become links to that line ([activity](docs/activity.md))
- - Follow work moves the session to the repo Claude works in ([activity](docs/activity.md))
- - 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)):
- - click selects one row and clears the marks
- - with rows marked, j / k move only the cursor, and `v` marks or unmarks the row under it
- - shift+click marks the range from the last click or j / k move, in tree order
- - ctrl+click marks or unmarks one row without opening it; alt+click on macOS
- - double-click or Enter opens a file
- - the clear selection button clears every marked and selected row
- - marked rows show the selection background; `y`, `Y` and `u` copy the shaded rows
- - with rows marked, the row under the cursor shows an accent tint in the Desktop app and the accent cursor mark in the terminal
- - Split preview of code, Markdown, images, video frames, PDF and Word pages ([preview and treemap](docs/preview-treemap.md))
- - Treemap of a folder by bytes or lines, with Claude's activity lit ([preview and treemap](docs/preview-treemap.md))
- - Diff of a file or every changed file in a folder, in the pane or your diff tool ([diff](docs/diff.md))
- - Open files in their default app, an editor in a tmux or herdr pane, or any command ([open](docs/open.md))
- - Guard files and folders from Claude's edits, and see files written outside the repo ([guards](docs/guards.md))
- - Keyboard-driven: vim-style moves, a shortcuts overlay, and alt+l / alt+h in the terminal ([keys](docs/keys.md))
- - `/filetree` commands and where the pane shows in the terminal and the Desktop app ([sidebar](docs/sidebar.md))
- <img src="media/filetree-git.gif" alt="A committed file shimmers green and the footer shows the commit" width="800">
- <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">
- ## Settings
- All settings are in `/config` under filetree, each with its own description there.
- ```yaml
- Claude activity: reads and writes | writes | reads | none
- Activity shimmer: on | off
- Follow Claude: on | off
- Jump moves Claude: tree and Claude | tree
- Right-click copies: relative | absolute
- Follow work: on | off
- Open at start: on | off
- Focus on open: on | off
- Right column: date | age | size | loc | files
- Date format: year-month-day | day-month | month-day
- Clock: 24h | 12h
- Long file: 500 | a line count | off
- Remote branch: off | on
- Hints: on | off
- Search spacing: on | off
- Column headers: on | off
- Auto-collapse: off | on
- Shortcuts: auto | always | off
- Open with: empty | editor | preview | a command with {path} and {dir}
- Binary files: Open with | default app
- Edit with: empty | a command with {path} and {line}
- Diff with: empty | a command such as "hunk diff --" or "lazygit -f"
- Diff groups: folder | kind | off
- Terminal target: auto | pane right | pane below | tab | workspace
- Ignore: names to hide, such as ".cache .tmp"
- Preview pane: bottom | top
- Treemap: auto | image | cells | off
- Palette: key=#hex pairs over the terminal colors
- Glyphs: auto | nerd | plain | text
- ```
- 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.
- Follow work is described in [Claude activity](docs/activity.md).
- 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.
- ## Requirements
- ```yaml
- required: Claude Code 2.1.306 or newer, git
- optional:
- inotifywait: live updates on Linux (inotify-tools)
- magick or ffmpeg: images other than PNG, video frames
- pdftoppm or gs: PDF pages
- soffice: Word and office pages
- pandoc, pdftotext: document text in tmux, herdr and other terminals
- tmux or herdr: an editor or diff tool in a new pane
- Nerd Fonts 3.2+: icons for Glyphs auto, which draws plain Unicode without one or with an older one
- pictures: Ghostty or kitty, outside tmux and herdr, on Linux and macOS
- ```
- ## Considerations
- - The Desktop app has no split preview or treemap
- - 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
- - 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
- - GIFs and videos show one still frame
- - Windows sizes folders through file listings, and the treemap draws one level
- - Row clicks need herdr 0.9.1 or later; run `herdr update`
- ## Contributing
- Open pull requests against a release branch, not `main`:
- - Fixes: the patch branch, such as `release/0.8.2`
- - Features: the minor branch, such as `release/0.9.0`
- Keep the version of that branch.
- 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:
- ```bash
- git config core.hooksPath .githooks
- ```
- The same checks run on macOS, Windows and Linux in CI on every push that touches the plugin.
- ## License
- [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).
- *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 inFree to use. If it’s helped, pass it on.