gh-axi CLI
Обертка над GitHub CLI для агентов: компактный вывод TOON, подсказки следующего шага и структурные ошибки для issues, PR, CI и релизов
- 345 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Инструмент создает, правит и удаляет `issues`, `gists`, секреты и переменные Actions, запускает `workflow` и готовит релизы под вашим токеном `gh`
- Через `gh-axi api` агент получает прямой доступ к GitHub API с правами вашей авторизации
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/gh-axiОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Инструмент создает, правит и удаляет `issues`, `gists`, секреты и переменные Actions, запускает `workflow` и готовит релизы под вашим токеном `gh`
- Через `gh-axi api` агент получает прямой доступ к GitHub API с правами вашей авторизации
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
gh-axi оборачивает официальный `gh` и отдает результат в компактном формате TOON, чтобы агент тратил меньше токенов на ответы GitHub. К выводу добавлены подсказки следующего шага, а ошибки приходят структурой. Запущенный без аргументов, `gh-axi` показывает панель с живым состоянием текущего репозитория: открытые `issues` и PR. Команды покрывают `issues` и подзадачи, пул-реквесты, обсуждения, стеки PR, запуски CI и логи упавших джобов, `workflow`, релизы, репозитории, метки, `gists`, проекты (v2), секреты и переменные Actions, поиск и прямой доступ к API. Многострочные тексты передают через `--body-file`, картинки и видео к `issue` и PR прикрепляют ключом `--attach`. Скилл `gh-axi` служит только заглушкой для обнаружения: он отправляет агента к актуальной справке в `npx -y gh-axi --help` и сам команд не дублирует, поэтому устаревать ему нечему.
Для кого. Для разработчиков, чьи агенты работают с GitHub через оболочку: разбор `issues`, ревью PR, проверка CI, релизы и доски Projects.
Подходит, если
- Агент разбирает упавший CI: `gh-axi run view --job 789012 --log-failed` показывает только упавшие строки лога одной джобы
- Нужно подготовить ревью PR или выпустить релиз, не заливая контекст длинным выводом `gh`
- Вы ведете стопки PR на ветках: `gh-axi stack init`, `stack submit` и `stack view` работают через расширение `gh-stack`
- Агенту нужны секреты или переменные Actions: `echo -n "sk-..." | gh-axi secret set OPENAI_API_KEY` берет значение из `stdin`
- Нужно сразу видеть состояние репозитория в начале сессии: хук `SessionStart` подтягивает открытые `issues` и PR
Не подходит, если
- На машине не установлены `gh` или Node версии 20 и новее: обертка требует обоих
- Нужна авторизация без `gh auth login`: инструмент берет доступ у установленного и авторизованного `gh`
- Вам нужен MCP-сервер с отдельными инструментами: gh-axi работает командами в оболочке, а не протоколом MCP
- Агент не должен менять данные на GitHub: инструмент умеет создавать, править и удалять `issues`, `gists`, секреты и релизы
Пример запроса к агенту
Посмотри, почему упал последний запуск CI в этом репозитории, и покажи только упавшие строки логаОграничения
Нужны установленный и авторизованный `gh` (`gh auth login`) и Node 20 или новее. Прикрепление файлов ключом `--attach` требует `gh` 2.99.0 и новее, закрытие `issue` как дубликата требует 2.88.0. Стеки PR работают только с расширением `gh extension install github/gh-stack`. Для GitHub Enterprise или другого хоста авторизуйте `gh` на этом хосте и передайте `--hostname` либо задайте `GH_HOST`. Нужную копию `gh` можно указать переменной `GH_BIN`.
Скилл помечен как не вызываемый пользователем: агент загружает его сам, когда задача касается GitHub. Опциональный хук `SessionStart` ставится для Claude Code, Codex и OpenCode командой `gh-axi setup hooks`, после нее сессию агента нужно перезапустить.
Как отключить. Скилл, поставленный с ключом `-g`, лежит в `~/.claude/skills/`, удалите оттуда папку `gh-axi`. Глобальный пакет снимается командой `npm uninstall -g gh-axi`.
Частые вопросы
Как поставить gh-axi в Claude Code?
Выполните `npx skills add kunchenguid/gh-axi --skill gh-axi -g`. Ключ `-g` кладет скилл в `~/.claude/skills/` для всех проектов, без него скилл ставится в `.claude/skills/` текущего проекта. Отдельный `npm install` не нужен.
Можно ли пользоваться без установки?
Да. Достаточно сказать агенту «Execute `npx -y gh-axi` to get GitHub tools»: gh-axi устроен как AXI, и любой способный агент запустит CLI напрямую.
Чем gh-axi отличается от обычного gh?
Он отдает вывод в формате TOON и добавляет подсказки следующих шагов. В бенчмарке автора на 17 задачах с моделью `claude-sonnet-4-6` gh-axi прошел все прогоны (100% против 86% у голого `gh`) при цене 0,050 доллара за задачу против 0,054.
Чем он отличается от GitHub MCP?
По тому же бенчмарку обращение через GitHub MCP обошлось дороже: от 0,101 до 0,148 доллара за задачу против 0,050, а входных токенов ушло от 137 до 176 тысяч против 46 тысяч. Успех при этом составил от 82 до 87%.
Как получить состояние репозитория в начале сессии?
Поставьте пакет глобально командой `npm install -g gh-axi`, затем выполните `gh-axi setup hooks`. Хук `SessionStart` для Claude Code, Codex и OpenCode покажет открытые `issues` и PR текущего репозитория. После этого перезапустите сессию агента.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыРасширение gh для агентных воркфлоу: задача описывается в Markdown и запускается агентом в GitHub Actions
Run Gemini CLI
run-gemini-cli
Официальное действие Google для GitHub Actions: запускает Gemini CLI в репозитории для ревью pull request, разбора задач и правки кода
Локальный шлюз перед git push: ревью, тесты, документация и линтер проходят в отдельной копии, и только после этого ветка уходит в удаленный репозиторий
Официальный MCP-сервер GitHub: код, issues, пул-реквесты, Actions и алерты безопасности прямо из агента
CLI для git worktree, заточенный под параллельные сессии Claude Code и Codex: команда wt, плагин и хуки автоматизации
Нативный терминал для macOS на базе Ghostty с вертикальными вкладками и уведомлениями, когда агенту нужен ответ
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| gh-axi (эта запись) | нет | 345 | ||
| GitHub MCP Server | нет | ключ необязателен | 33 890 | официальный MCP-сервер GitHub, а здесь обертка над gh без протокола MCP |
| Скиллы GitHub CLI | нет | 46 712 | официальные скиллы, которые учат агента вызывать сам gh, а здесь отдельная обертка с компактным выводом | |
| gh-image | нет | 279 | расширение GitHub CLI и скилл для агентов |
Коротко о README
Описание открывается кратким определением и бенчмарком axi из 17 реальных задач GitHub на пяти вариантах интерфейса, затем идет быстрый старт с установкой скилла. Дальше описаны другие способы подключения: запуск без установки и хук сессии. Основная часть — справочник команд с примерами, правилами передачи тела текста из файла, ключом `--attach` и повторяемыми флагами.