data-goblin / claude-code-filetree

Claude Code Filetree 
 An IDE-style file tree for Claude Code that shows what Claude is doing and where in files
> [!NOTE]
> filetree is a Claude Code **mod** and needs **Claude Code 2.1.287+**. It shows in the right sidebar, which in the terminal needs the fullscreen layout (`/tui fullscreen`) and a terminal at least 110 columns wide; the Desktop app docks it on its own, and `/filetree` reopens it there after you close it. Tested on Linux, macOS and Windows; mods don't load in WSL sessions of the Desktop app.
---
## Installation
The repo is its own plugin marketplace. Run this in the terminal:
 [code] 
Or inside a Claude Code session:
 [code] 
Installed it as `filetree@filetree` before the repository was renamed? Nothing to do: that install keeps loading and keeps receiving updates.
Install fails with `Unrecognized key: "options"`? Your Claude Code is older than 2.1.287: run `claude update`, then install again.
## Features
- Interactive file tree for the working directory where you're using Claude Code; it follows the cwd, or `/filetree ` pins another folder
- Search the file tree, including folders you have not opened yet
- Git status per file and folder in color, with exact lines changed (`+N` `-N`) on modified files and `?:N M:N D:N` file counts on folders
- Branch, upstream and ahead/behind in the header
- Visual indicator of Claude reads and searches (purple), writes (orange) and commits (green); collapsed folders open to show the file
- Git and GitHub operations via `git` and `gh` (commit, push, pull, checkout, merge, PR and more) shown as a status at the bottom of the pane
- Selection-aware: the selected file is passed to Claude as context through a `prompt.submit` hook, and `@path` mentions in a prompt reveal that file in the tree
- File and folder sizes: the `Σ` header button swaps the date column for sizes; folders show their disk usage (`du`, or a summed listing on Windows), worked out in the background for the rows on screen and refreshed after Claude writes
- Double-click a file to open it in its default app
- On macOS, Space on a file shows it in Quick Look
- Click to select, arrow keys or `j`/`k`/`h`/`l` to move through the tree
- Hover a header button to see what it does
- Light on large repos: outside a repo it only checks once whether one exists, and every git call is scoped to the cwd
- Nerd Font icons with a plain Unicode fallback
- On Omarchy, the pane takes its colors and background from the current theme and follows theme switches
- A light `/config` theme in the terminal gets its own palette, with every text color at WCAG AAA contrast (7:1 or more), also on the selected and hovered rows
- Your own colors through the Palette setting, laid over whichever theme is active
- `d` on a changed file shows its diff, in the pane or in hunk, lazygit or any diff tool you name
### Keyboard navigation
With the filetree pane focused, use `j`/`k` to move down/up, `l` to expand a folder, and `h` to collapse it or move to its parent. `o` o