Create Issues from TODOs

June 15, 2026 · View on GitHub

Scan code for TODO comments and automatically create corresponding GitHub issues. Authenticates via GitHub App, locates TODOs with file and line references, and can optionally add issues to a GitHub Project.

Inputs

NameDescriptionRequiredDefault
client-idGitHub App Client ID (preferred over the deprecated app-id)❌¹-
app-idGitHub App ID. Deprecated — use client-id instead❌¹-
app-private-keyGitHub App Private Key-
projectGitHub Project to add issues to-

¹ Provide exactly one of client-id or app-id. Prefer client-id: actions/create-github-app-token has deprecated app-id, so passing it emits a Input 'app-id' has been deprecated warning.

Usage

Standard TODO scanning

steps:
  - name: Create issues from TODOs
    uses: devantler-tech/actions/create-issues-from-todos@main
    with:
      client-id: ${{ vars.APP_CLIENT_ID }}
      app-private-key: ${{ secrets.APP_PRIVATE_KEY }}

With project integration

steps:
  - name: Create issues from TODOs
    uses: devantler-tech/actions/create-issues-from-todos@main
    with:
      client-id: ${{ vars.APP_CLIENT_ID }}
      app-private-key: ${{ secrets.APP_PRIVATE_KEY }}
      project: "organization/devantler-tech/1"