Issues Configuration

Detailed configuration options for issues

The following parameters can be configured in the workflow:

Required Parameters

  • token: GitHub token for branch and project operations within the repository scope.

Optional Parameters

Action Control

  • single-action: Launch single actions
  • single-action-issue: Issue target for executing single action

Branch Management

  • branch-management-launcher-label: Label to trigger branch management actions (default: "branched")
  • branch-management-always: If true, ignores the branch-management-launcher-label requirement (default: "false")
  • branch-management-emoji: Emoji to indicate branched issues (default: "💻")
  • main-branch: Name of the main branch (default: "master")
  • development-branch: Name of the development branch (default: "develop")

Issue Labels

  • bug-label: Label to indicate a bug type (default: "bug")
  • bugfix-label: Label to manage bugfix branches (default: "bugfix")
  • enhancement-label: Label to indicate an enhancement type (default: "enhancement")
  • question-label: Label to detect issues marked as questions (default: "question")
  • help-label: Label to detect help request issues (default: "help")
  • deploy-label: Label to detect deploy actions (default: "deploy")
  • deployed-label: Label to detect the deployed was (default: "deployed")
  • docs-label: Label to manage docs branches (default: "docs")
  • documentation-label: Label to manage docs branches (default: "documentation")
  • chore-label: Label to manage chore branches (default: "chore")
  • maintenance-label: Label to manage chore branches (default: "maintenance")
  • hotfix-label: Label to manage hotfix branches (default: "hotfix")
  • release-label: Label to manage release branches (default: "release")
  • feature-label: Label to manage feature branches (default: "feature")

Size Labels

  • size-xxl-label: Label to indicate a task of size XXL (default: "size: XXL")
  • size-xl-label: Label to indicate a task of size XL (default: "size: XL")
  • size-l-label: Label to indicate a task of size L (default: "size: L")
  • size-m-label: Label to indicate a task of size M (default: "size: M")
  • size-s-label: Label to indicate a task of size S (default: "size: S")
  • size-xs-label: Label to indicate a task of size XS (default: "size: XS")

Size Thresholds

XXL Thresholds
  • size-xxl-threshold-lines: Threshold for size XXL in lines (default: "1000")
  • size-xxl-threshold-files: Threshold for size XXL in files (default: "20")
  • size-xxl-threshold-commits: Threshold for size XXL in commits (default: "10")
XL Thresholds
  • size-xl-threshold-lines: Threshold for size XL in lines (default: "500")
  • size-xl-threshold-files: Threshold for size XL in files (default: "10")
  • size-xl-threshold-commits: Threshold for size XL in commits (default: "5")
L Thresholds
  • size-l-threshold-lines: Threshold for size L in lines (default: "250")
  • size-l-threshold-files: Threshold for size L in files (default: "5")
  • size-l-threshold-commits: Threshold for size L in commits (default: "3")
M Thresholds
  • size-m-threshold-lines: Threshold for size M in lines (default: "100")
  • size-m-threshold-files: Threshold for size M in files (default: "3")
  • size-m-threshold-commits: Threshold for size M in commits (default: "2")
S Thresholds
  • size-s-threshold-lines: Threshold for size S in lines (default: "50")
  • size-s-threshold-files: Threshold for size S in files (default: "2")
  • size-s-threshold-commits: Threshold for size S in commits (default: "1")
XS Thresholds
  • size-xs-threshold-lines: Threshold for size XS in lines (default: "25")
  • size-xs-threshold-files: Threshold for size XS in files (default: "1")
  • size-xs-threshold-commits: Threshold for size XS in commits (default: "1")

Branch Naming Conventions

  • docs-tree: Naming convention for docs branches (default: "docs")
  • chore-tree: Naming convention for chore branches (default: "chore")
  • feature-tree: Naming convention for feature branches (default: "feature")
  • bugfix-tree: Naming convention for bugfix branches (default: "bugfix")
  • hotfix-tree: Naming convention for hotfix branches (default: "hotfix")
  • release-tree: Naming convention for release branches (default: "release")

Issue Management

  • project-ids: Comma-separated list of project IDs to link issues and pull requests
  • emoji-labeled-title: Enable titles with emojis based on issue labels (default: "true")
  • reopen-issue-on-push: Reopens a closed issue when changes are pushed to the branch (default: "true")
  • desired-assignees-count: Number of assignees desired for the issue (default: "1", max: 10)
  • desired-reviewers-count: Number of reviewers desired for pull requests (default: "1", max: 15)

Image Configuration

  • images-on-issue: Include images in issue comments (default: "true")
  • images-on-pull-request: Include images in pull request comments (default: "true")
  • images-on-commit: Include images in commit comments (default: "true")
Issue Images
  • images-issue-automatic: Image URLs to display in automatic action issue comments
  • images-issue-feature: Image URLs to display in feature action issue comments
  • images-issue-bugfix: Image URLs to display in bugfix action issue comments
  • images-issue-docs: Image URLs to display in docs action issue comments
  • images-issue-chore: Image URLs to display in chore action issue comments
  • images-issue-hotfix: Image URLs to display in hotfix action issue comments
  • images-issue-release: Image URLs to display in release action issue comments
Pull Request Images
  • images-pull-request-automatic: Image URLs to display in automatic action pull request comments
  • images-pull-request-feature: Image URLs to display in feature action pull request comments
  • images-pull-request-bugfix: Image URLs to display in bugfix action pull request comments
  • images-pull-request-docs: Image URLs to display in docs action pull request comments
  • images-pull-request-chore: Image URLs to display in chore action pull request comments
  • images-pull-request-hotfix: Image URLs to display in hotfix action pull request comments
  • images-pull-request-release: Image URLs to display in release action pull request comments
Commit Images
  • images-commit-automatic: Image URLs to display in automatic action commit comments
  • images-commit-feature: Image URLs to display in feature action commit comments
  • images-commit-bugfix: Image URLs to display in bugfix action commit comments
  • images-commit-docs: Image URLs to display in docs action commit comments
  • images-commit-chore: Image URLs to display in chore action commit comments
  • images-commit-hotfix: Image URLs to display in hotfix action commit comments
  • images-commit-release: Image URLs to display in release action commit comments

AI (OpenCode)

  • opencode-server-url: OpenCode server URL (default: "http://localhost:4096"). See OpenCode (AI).
  • opencode-model: Model in provider/model format (default: "opencode/kimi-k2.5-free")
  • opencode-start-server: If true, the action starts and stops OpenCode in the job (default: "false")
  • ai-pull-request-description: Enable AI-powered PR descriptions (default: "false")
  • ai-ignore-files: Comma-separated list of files to ignore for AI operations
  • ai-members-only: Restrict AI features to organization/project members (default: "false")

Workflow Configuration

  • release-workflow: Release workflow for running release deploys (default: "release_workflow.yml")
  • hotfix-workflow: Hotfix workflow for running hotfix deploys (default: "hotfix_workflow.yml")
  • merge-timeout: Timeout for the merge workflow in seconds (default: "600")
  • commit-prefix-transforms: Transforms for commit prefix from branch name (e.g. "replace-slash", "kebab-case")