Copilot is a GitHub Action for task management using Git-Flow: it links issues, branches, and pull requests to GitHub Projects, automates branch creation from labels, and keeps boards and progress in sync. Think of it as bringing Atlassian-style integration (boards, tasks, branches) to GitHub.
Full documentation: docs.page/vypdev/copilot
| Section | Description |
|---|---|
| How to use | Step-by-step setup: PAT, copilot setup, workflows |
| Features & capabilities | Workflow triggers, single actions, AI (OpenCode), concurrency |
| Authentication | PAT setup, permissions, token best practices |
| Configuration | All inputs: branches, labels, projects, images, etc. |
| OpenCode (AI) | Progress, Bugbot, think, AI PR description |
| Testing OpenCode locally | Run check-progress, detect-potential-problems, recommend-steps via CLI |
| Single actions | On-demand: check progress, think, create release/tag, deployed |
| Issues | Issue configuration and types (feature, bugfix, hotfix, release, docs, chore) |
| Pull requests | PR configuration and AI description |
| Troubleshooting | Common issues and solutions |
| Support | How to get help |
- Create a PAT and store it as a repo secret (e.g.
PAT). See Authentication. - Use the action from the marketplace so versions are stable:
uses: vypdev/copilot@v2
- Add workflows — Copy the files from
setup/workflows/into your.github/workflows/, or runcopilot setupfrom your repo root (withPERSONAL_ACCESS_TOKENin.env). See How to use.
- Issues — Branch creation from labels (feature, bugfix, hotfix, release, docs, chore), project linking, assignees, size/progress labels; optional Bugbot (AI) on the issue; from a comment you can ask to fix reported findings (Bugbot autofix).
- Pull requests — Link PRs to issues, update project columns, assign reviewers; optional AI-generated PR description; from a PR review comment you can ask to fix reported findings (Bugbot autofix).
- Push (commits) — Notify the issue, update size/progress; optional Bugbot (detection) and prefix checks.
- Projects — Link issues and PRs to boards and move them to the right columns.
- Single actions — On-demand: check progress, think, create release/tag, mark deployed, etc.
- Concurrency — Waits for previous runs of the same workflow so runs can be sequential. See Features → Workflow concurrency.
AI features (progress, Bugbot, think, AI PR description) use OpenCode; see OpenCode (AI). You can also run progress and Bugbot locally via the CLI — Testing OpenCode locally and Single actions → Workflow & CLI.
See CONTRIBUTING.md for development setup, conventions, and how to submit changes.