ghfs CLI
ghfs хранит issues и pull request GitHub как Markdown-файлы, чтобы агент читал их офлайн и правил пачкой
- 283 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- `ghfs execute --run` закрывает issues, меняет метки и пишет комментарии от вашего аккаунта.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/ghfsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- `ghfs execute --run` закрывает issues, меняет метки и пишет комментарии от вашего аккаунта.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Команда `ghfs` внутри репозитория выгружает открытые issues и pull request в каталог `.ghfs`: индексы `issues.md` и `pulls.md`, по файлу на каждый элемент, патчи для PR. Агент читает эти файлы без сетевых запросов и суммирует их. Правки не уходят в GitHub сразу. Они копятся в очереди `execute.md` или `execute.yml`, а также в frontmatter карточек (заголовок, состояние, метки, исполнители, milestone). `ghfs execute` показывает отчет, `ghfs execute --run` применяет очередь. Есть локальный веб-интерфейс `ghfs ui` и панель `ghfs hub` для нескольких проектов.
Для кого. Мейнтейнерам с большим потоком issues и PR, которые разбирают очередь вместе с агентом и хотят проверять изменения до отправки.
Подходит, если
- Нужно разобрать сотню открытых issues и закрыть дубли одной пачкой.
- Агент должен прочитать обсуждения без обращения к API на каждый вопрос.
- Метки и исполнителей расставляют по правилам, а итог проверяют глазами.
- Вы ведете несколько репозиториев и хотите общий список свежих обсуждений.
Не подходит, если
- Нужен стабильный инструмент: README сам предупреждает, что проект еще в разработке.
- Достаточно разового ответа на комментарий в браузере.
- Команда не готова хранить копию обсуждений в рабочем каталоге.
Пример запроса к агенту
Синхронизируй issues, найди дубли среди открытых и поставь в очередь закрытие с комментарием, но не запускай `execute --run`.Ограничения
README открывается предупреждением, что проект в разработке и пока не готов к использованию. Команды и формат файлов могут измениться. Выгрузка идет в каталог репозитория, поэтому добавьте `.ghfs` в `.gitignore`, если не хотите коммитить обсуждения. Предложение меток через `ghfs label` требует ключ AI Gateway от Vercel и отправляет текст элементов внешней модели. Сохраненные ответы GitHub по `github.com/settings/replies` не синхронизируются: у них нет публичного API.
Как отключить. Удалите скилл из каталога скиллов агента и каталог `.ghfs` в репозитории. Очередь `execute` без `--run` ничего не отправляет.
Частые вопросы
Что изменится на GitHub после правки файла?
Ничего до `ghfs execute --run`. Без флага команда только показывает, какие операции будут выполнены.
Как поставить скилл для агента?
Команда `pnpx skills add antfu/ghfs` ставит скилл из папки `skills/ghfs`. Пакет `@ghfs/cli` тоже содержит скиллы для `skills-npm`.
Можно ли смотреть issues без терминала?
Да. `ghfs ui` открывает двухпанельный просмотр на порту 7710, правки из него тоже попадают в очередь.
Нужен ли ключ GitHub?
Для обращений к GitHub нужна авторизация, как у любой утилиты, которая читает issues и применяет правки. Уточните способ в разделе настройки README.
Что делает `ghfs label`?
Просит модель подобрать метки для неразмеченных элементов по уже размеченным примерам и кладет предложения в очередь, ничего не отправляя на GitHub.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыGo-утилита для issues GitHub: они лежат на диске файлами Markdown, агент правит их пачкой, а команда push отправляет итог на сайт.
Панель GitHub в терминале показывает задачи и запросы на слияние для ручного разбора работы агента в настраиваемых разделах.
CLI и скилл для GitHub: строит граф связанных issues и PR, показывает конкурирующие правки и непрошедшие хвосты до начала работы.
Навык с четырьмя скриптами для gh отдает агенту состояние PR, ветки ревью и сбои CI одним вызовом и коротким выводом.
Расширение GitHub CLI gh stack и скилл для агента: цепочка зависимых веток и PR, перебазирование, отправка и слияние всего стека целиком
Расширение GitHub CLI и скилл для агентов: загружает скриншоты, PDF, архивы и логи в задачи и запросы на слияние из терминала и возвращает готовую ссылку
Коротко о README
Файловое зеркало GitHub для офлайн-чтения и пакетных операций, рассчитанное на человека и агента.