Інтеграція з GitHub

SnakeFlow інтегрується з GitHub: Issues, PR та CI Actions — з сайдбару.

Вимоги

GitHub у редакторі — увійдіть через меню Accounts (GitHub) для Issues, Pull Requests і функцій на REST API. Розширення використовує сесію GitHub редактора.
gh CLI — корисний для скриптів і деяких сценаріїв; не обов’язковий для Issues/PR і PR AI Feedback.
Для локальних Actions: act + Docker Desktop

GitHub Issues

Можливості

Перегляд issues з фільтрами: milestone, assignee, діапазон дат, label, повнотекстовий пошук
Створення issues (опційно AI-заголовок через Google Gemini)
Редагування title, body, assignees, milestone, labels
Закриття issues, коментарі
Гілка з issue — за замовчуванням issue-{number}-{title-slug}; з Gemini — пропозиція на кшталт fix/login-timeout/#42 (AI-назва гілки)
Надіслати в Cursor Chat — контекст issue для AI

Команда: Ctrl+Alt+G — Create Issue | панель GitHub Issues

Фільтри

До 50 issues у сайдбарі. Фільтри:

Milestone
Assignee — ваші або конкретного користувача
Дата — створені після / до
Пошук — у title та body

AI-заголовок (Gemini)

"devManager.gemini.apiKey": "AIza...",
"devManager.gemini.model": "gemini-2.5-flash"

Якщо ключ задано, SnakeFlow може викликати Gemini, щоб запропонувати стислу назву issue на основі вашого опису.

Безкоштовний ключ: aistudio.google.com.

AI-назва гілки

Якщо задано devManager.gemini.apiKey, команда Create Branch from Issue спочатку запитує Gemini коротку назву гілки (type/slug/#N). Можна відредагувати в полі вводу; при помилці API — fallback issue-{number}-{title-slug}.

Голосове введення

Натисніть 🎙 поряд з Description (або Add comment в Edit Issue) — надиктуйте текст у мікрофон. Gemini AI транскрибує аудіо і вставляє результат прямо в поле.

Детальніше: Голосове введення →

Надіслати в чат

"devManager.issueToChat.prompt": "Проаналізуй issue і запропонуй план реалізації."

Центр сповіщень

Сповіщення GitHub і події розширення (помилки Quality Hub, статус workflow тощо) — один список у status bar і QuickPick.

Status bar

Клік по дзвінку (бейдж — кількість непрочитаних).
SnakeFlow: Toggle Notification Scope — лише цей репозиторій або всі доступні.

Команди

Назва команди	Призначення
SnakeFlow: Show Notifications	Відкрити список
SnakeFlow: Refresh Notifications	Оновити з GitHub
SnakeFlow: Mark All Notifications Read	Скинути непрочитані
SnakeFlow: Toggle Notification Scope	Репо / усі репо

GitHub Sprints

Спринти = стандартні GitHub Milestones (окремого бекенду немає). Групування issues, команди спринту.

"devManager.github.sprints.enabled": true,
"devManager.github.sprints.namingHint": "Sprint {YYYY}-W{WW}"

Параметр	За замовч.	Опис
`devManager.github.sprints.enabled`	`false`	Увімкнути спринти
`devManager.github.sprints.namingHint`	`""`	Підказка при створенні спринту

Типовий цикл: Create Sprint → Assign Sprint → Set/Edit/Close Sprint → Toggle Sprint Grouping → Toggle Issue Sort (Created / Sprint Due). Повний список — довідник команд.

Pull Requests

Відкриті PR у сайдбарі: статус рев’ю, CI, автор.

Можливості

Групування за статусом: потрібен рев’ю, approved, changes requested
Відкрити PR на GitHub одним кліком
Надіслати PR у Cursor Chat — diff + опис для AI-рев’ю

Промпт для чату

"devManager.prToChat.prompt": "Переглянь PR з фокусом на безпеку, продуктивність і покриття тестами."

PR AI Feedback

Збирає Markdown-звіт для одного відкритого pull request: метадані PR, результати CI, рев’ю та рядкові коментарі ботів (наприклад Copilot, CodeRabbit, GitHub Actions), а також уривок логів job’ів CI, що завершилися з помилкою, якщо вони доступні. Зручно для одного файлу в чат AI або архіву.

Як запустити

Оберіть проєкт SnakeFlow і переконайтеся, що GitHub авторизований у редакторі.
Палітра команд → SnakeFlow: PR AI Feedback (або з головного меню).
Оберіть відкритий PR (поточна гілка позначена, якщо збігається з head PR).
Дочекайтеся повідомлення — файл відкриється в редакторі.

Куди зберігається файл

У корені проєкту, у папці конфігурації редактора (зазвичай .cursor у Cursor або .vscode у VS Code / Antigravity — та сама зона, де лежать skills), підпапка pr-feedback/. Ім’я файлу: pr-{номер}-{YYYY-MM-DD-HH-mm}.md. За потреби додайте pr-feedback/ до .gitignore.

Умови: remote origin має вказувати на github.com. Для приватних репо потрібні права на читання PR, checks і коментарів (зазвичай достатньо стандартного scope repo з редактора).

GitHub Actions (CI)

Локальний запуск workflow через act — без push на GitHub.

Встановлення act

# Windows
winget install nektos.act

# macOS
brew install act

# Linux
curl -s https://raw.githubusercontent.com/nektos/act/master/install.sh | sudo bash

Потрібен запущений Docker Desktop.

Використання

Головне меню → CI / Run GitHub Actions Locally

"devManager.ci.workflowsPath": ".github/workflows"