Skip to content

GitHub Integration

SnakeFlow integrates deeply with GitHub — Issues, PRs, and CI Actions are managed directly from the sidebar.

Requirements

  • gh CLI installed and authenticated: gh auth login
  • For GitHub Actions locally: act + Docker Desktop

GitHub Issues

Features

  • View issues with real-time filters: milestone, assignee, date range, label, full-text search
  • Create new issues (optional AI-assisted title via Google Gemini)
  • Edit title, body, assignees, milestone, labels
  • Close issues
  • Add comments
  • Create a branch from an issue — names the branch issue-{number}-{title-slug}
  • Send to Cursor Chat — sends the full issue context for AI assistance

Command: Ctrl+M I — Create Issue | Sidebar → GitHub Issues panel

Filters

The sidebar shows up to 50 issues. Filter by:

  • Milestone — select from your repo’s milestones
  • Assignee — filter to your issues or a specific user
  • Date — created after / before a date
  • Search — full-text search in title and body

AI Title Generation (Gemini)

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

When configured, SnakeFlow calls Gemini to suggest a concise issue title based on your description.

Get a free API key at aistudio.google.com.

Send to Chat

"devManager.issueToChat.prompt": "Analyze this issue and suggest an implementation plan."

Pull Requests

View open PRs in the sidebar with review status, CI status, and author.

Features

  • PRs grouped by status: needs review, approved, changes requested
  • Open PR on GitHub with one click
  • Send PR to Cursor Chat — sends the diff + description for AI code review

Custom Chat Prompt

"devManager.prToChat.prompt": "Review this PR focusing on security, performance, and test coverage."

GitHub Actions (CI)

Run GitHub Actions workflows locally using act — without pushing to GitHub.

Install act

Terminal window
# Windows
winget install nektos.act
# macOS
brew install act
# Linux
curl -s https://raw.githubusercontent.com/nektos/act/master/install.sh | sudo bash

Requires Docker Desktop to be running.

Usage

Main menu → CI / Run GitHub Actions Locally

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