Claude Code Filetree — плагин
Плагин с деревом файлов для Claude Code: подсвечивает файлы, которые агент читает и правит, показывает git, дифф и предпросмотр
- 377 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Хуки плагина видят, какие файлы агент читает, правит и коммитит
- Настройки `Open with`, `Edit with` и `Diff with` запускают заданные вами команды
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/claude-code-filetreeОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Хуки плагина видят, какие файлы агент читает, правит и коммитит
- Настройки `Open with`, `Edit with` и `Diff with` запускают заданные вами команды
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Claude Code Filetree добавляет в терминал и в десктопное приложение Claude Code панель с деревом файлов текущей папки. Когда агент читает, пишет или коммитит файл, строка в дереве вспыхивает, а автосворачивание закрывает папки, которые агент открыл сам. В колонках видны статус git, размер, число строк и дата, внизу ветка с отставанием и опережением. По дереву двигаются клавишами в стиле vim. `z` переходит в папку как zoxide, `s` ищет по имени, `q` ищет внутри файлов через `git grep` или `grep -r`, `d` показывает дифф файла или всех измененных файлов папки. Выбранный файл и до 100 отмеченных записей уходят Claude как контекст, а ссылки на файлы со строкой в его ответах становятся кликабельными. В терминале работают предпросмотр кода, Markdown, изображений, кадров видео, страниц PDF и Word и карта размеров папки. Отдельный раздел защищает файлы и папки от правок Claude и показывает записи вне репозитория.
Для кого. Разработчикам, которые работают в Claude Code и хотят видеть, какие файлы агент трогает и в каком месте.
Подходит, если
- Агент правит десятки файлов, и за ходом работы надо следить без чтения журнала вызовов
- Перед коммитом хочется просмотреть измененные файлы с диффом прямо в панели
- В репозитории есть файлы вроде конфигов деплоя, которых агент касаться не должен: для них задаются защищенные пути
- Между папками удобно прыгать клавишей `z` и искать по содержимому, не выходя из сессии
- Нужно найти самые тяжелые папки проекта: подойдет карта размеров
Не подходит, если
- Нужен встроенный редактор: плагин открывает файлы во внешнем редакторе, который задан в настройке `Edit with`
- Версия Claude Code старше 2.1.306, а установка на версиях до 2.1.287 падает с ошибкой `Unrecognized key: "options"`
- Картинки в предпросмотре нужны в другом терминале: они рисуются только в Ghostty и kitty вне tmux и herdr
Пример запроса к агенту
Покажи в дереве, какие файлы ты сейчас правишь, и открой дифф по каталогу srcОграничения
Нужны Claude Code 2.1.306 или новее и `git`. Необязательные утилиты расширяют предпросмотр: `magick` или `ffmpeg` для изображений и кадров видео, `pdftoppm` или `gs` для PDF, `soffice` для Word, `inotifywait` для живых обновлений в Linux, `tmux` или `herdr` для открытия редактора в новой панели.
В десктопном приложении нет разделенного предпросмотра и карты размеров. GIF и видео в предпросмотре показывают один кадр. В Windows размеры папок считаются по спискам файлов, а карта рисует один уровень.
Проект молодой, версия 0.7.1: настройки и поведение могут меняться.
Как отключить. Откройте `/plugin` в Claude Code и удалите `filetree`. Настройки хранятся в `/config` под именем filetree и уйдут вместе с плагином.
Частые вопросы
Как установить Claude Code Filetree?
Выполните `claude plugin marketplace add data-goblin/claude-code-filetree`, затем `claude plugin install filetree@claude-code-filetree`. Внутри сессии те же шаги идут командами `/plugin marketplace add` и `/plugin install`.
Какие клавиши нужны в дереве?
`z` переходит в папку, `s` ищет по имени, `i` ищет внутри выбранной папки, `q` ищет в содержимом файлов, `d` открывает дифф. Полный список показывает оверлей горячих клавиш, а описание лежит в `docs/keys.md`.
Работает ли панель в десктопном приложении?
Да, дерево и подсветка действий агента работают. Чего там не хватает по сравнению с терминалом, перечислено в ограничениях.
Как защитить файлы от правок Claude?
Задайте защищенные файлы и папки в разделе guards: плагин не даст Claude править их и покажет записи вне репозитория. Подробности лежат в `docs/guards.md`.
Где менять настройки?
В `/config` под именем filetree. Там задают, какую активность Claude показывать, режим автосворачивания, команды `Open with`, `Edit with` и `Diff with`, палитру и набор значков.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныИнструмент отладки для Claude Code: читает уже сохраненные логи сессий и показывает точные пути файлов, диффы, мышление модели и разбивку контекста по категория
Маркетплейс плагинов Claude Code от Frad LEE: Git и GitFlow, GitHub, рефакторинг, память, исследования, изображения и работа с интерфейсами
Плагин Neovim подключает Claude Code к редактору: текущий файл, выделение, диагностика и просмотр правок в diff
Плагин Claude Code создает и поддерживает CLAUDE.md: оценка от 0 до 100, лимит 150 строк и проверка устаревших ссылок
Плагин для Claude Code, который выводит в статусную строку заполнение контекста, активные инструменты, запущенные субагенты и прогресс задач
Строка статуса Claude Code показывает модель, состояние Git и заполнение контекста прямо в терминале
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Claude Code Filetree (эта карточка) | нет | 377 | |
| Claude HUD | нет | 29 122 | выводит в статусную строку заполнение контекста и ход задач, а Filetree показывает файлы, которые агент читает и правит |
| ccstatusline | нет | 13 542 | настраиваемая строка статуса с моделью, веткой и контекстом, а здесь отдельная панель с деревом файлов |
Коротко о README
Текст начинается с кратких возможностей и анимаций, затем идут установка через собственный маркетплейс, список функций со ссылками на отдельные документы, настройки в формате YAML, требования, ограничения и правила вклада. Изменения принимаются в ветки релизов.