🆘 - How can I implement this GitHub action

[efraespada]

Have you checked for existing help or discussions?

• I have searched existing issues and discussions.

What area do you need help with?

Code or implementation

Describe your problem or question

How can I implement this GitHub action? I need a tutorial

Steps or attempts you've already made

No response

Environment or context

No response

Additional context or screenshots

No response

[vypbot]

I'd be happy to help you implement this GitHub Action! To provide you with the most relevant guidance, I need to understand what this project does.

Let me first explore the repository structure and documentation to see what kind of GitHub Action this is.

[vypbot]

🪄 Automatic Actions

1. The issue was assigned to @efraespada (creator).
2. The issue's title was updated from How can I implement this GitHub action to 🆘 - How can I implement this GitHub action.
3. The issue was linked to vypdev and moved to the column Todo.
4. Priority set to P1 in vypdev.

🚀 Happy coding!

[efraespada]

How can I implement this GitHub action? I need a tutorial @vypbot

[vypbot]

This is Copilot - a comprehensive GitHub Action that automates Git-Flow methodology with AI-powered features. Here's how to implement it:

Quick Setup (Recommended)

# Install the CLI
npm install -g @vypdev/copilot

# Run setup in your repository
cd your-repo
copilot setup

This copies workflow files, issue templates, and PR templates automatically.

Manual Setup

1. Create Workflow Files

Create .github/workflows/copilot_issue.yml:

name: Copilot Issue Handler
on:
  issues:
    types: [opened, labeled, assigned, unlabeled]
jobs:
  copilot:
    runs-on: ubuntu-latest
    steps:
      - uses: vypdev/copilot@v2
        with:
          action: issue
          openCodeApiKey: ${{ secrets.OPENCODE_API_KEY }}
          githubToken: ${{ secrets.PAT }}

2. Create a Personal Access Token (PAT)

Go to GitHub Settings → Developer settings → Personal access tokens → Fine-grained tokens:

• Select your repository
• Grant permissions:
  • Repository: Contents (read/write), Issues (read/write), Pull requests (read/write), Metadata (read)
  • Projects: Read and write

Add it as PAT secret in your repo settings.

3. Add Issue Templates

Create .github/ISSUE_TEMPLATE/feature_request.yml:

name: Feature Request
description: Suggest a new feature
title: "[Feature] "
labels: ["feature"]
body:
  - type: textarea
    attributes:
      label: Description
      description: What feature do you want?

4. Configure (Optional)

Add to .github/variables or workflow with: section:

• projectIds: GitHub Project IDs to link issues
• openCodeModel: AI model to use (default: opencode/kimi-k2.5-free)
• debug: Set true for verbose logging

Usage Examples

Auto-branch creation: Label an issue with feature → branch feature/123-short-name is created.

AI PR descriptions: Open a PR → Copilot generates description based on linked issue.

Progress tracking: Push commits → Issue gets progress % and size labels updated.

Full Documentation

Visit https://docs.page/vypdev/copilot for complete guides.

Key Features Enabled

• Issue automation: Branch creation, project linking, labeling
• PR automation: AI descriptions, reviewer assignment, issue linking
• Commit tracking: Progress updates, commit notifications
• AI tools: Bug detection, progress checking, code recommendations