From 786dc80f17c383077e901393d9793f79d3076d60 Mon Sep 17 00:00:00 2001
From: ModeEric <ericjm4@illinois.edu>
Date: Sat, 27 Dec 2025 21:48:28 -0500
Subject: [PATCH 1/2] feat(examples): add workflow_dispatch example for
 on-demand Claude tasks

Adds a new example showing how to trigger Claude manually via GitHub UI
or API without creating an issue. This addresses the use case described
in #764 where users want to run Claude on-demand.

Features:
- Trigger via GitHub Actions UI with custom task input
- Trigger via GitHub API for external integrations
- Optional issue number input for additional context
- Includes curl example for API usage
---
 examples/workflow-dispatch.yml | 54 ++++++++++++++++++++++++++++++++++
 1 file changed, 54 insertions(+)
 create mode 100644 examples/workflow-dispatch.yml

diff --git a/examples/workflow-dispatch.yml b/examples/workflow-dispatch.yml
new file mode 100644
index 000000000..d62d46836
--- /dev/null
+++ b/examples/workflow-dispatch.yml
@@ -0,0 +1,54 @@
+# Run Claude on-demand via GitHub UI or API
+#
+# This workflow lets you trigger Claude manually with any task.
+# Useful for:
+#   - Running Claude without creating an issue
+#   - Triggering via API from external systems
+#   - Testing prompts before automating them
+#
+# Trigger via UI: Actions tab → "Run Claude Task" → "Run workflow"
+# Trigger via API (requires a Personal Access Token, not GITHUB_TOKEN):
+#   curl -X POST \
+#     -H "Authorization: Bearer $PAT" \
+#     -H "Accept: application/vnd.github.v3+json" \
+#     https://api.github.com/repos/OWNER/REPO/actions/workflows/workflow-dispatch.yml/dispatches \
+#     -d '{"ref":"main","inputs":{"task":"Add tests for utils.ts"}}'
+
+name: Run Claude Task
+
+on:
+  workflow_dispatch:
+    inputs:
+      task:
+        description: "What should Claude do?"
+        required: true
+        type: string
+      issue_number:
+        description: "Optional: Reference an issue number for context"
+        required: false
+        type: string
+
+jobs:
+  claude:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+      issues: write
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v5
+
+      - name: Run Claude
+        uses: anthropics/claude-code-action@v1
+        with:
+          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          prompt: |
+            Repository: ${{ github.repository }}
+            Branch: ${{ github.ref_name }}
+            ${{ github.event.inputs.issue_number && format('Related Issue: #{0}', github.event.inputs.issue_number) || '' }}
+
+            Task: ${{ github.event.inputs.task }}

From 0dd1bcc8d3fc11950e4229e0b805b07a43399057 Mon Sep 17 00:00:00 2001
From: ModeEric <ericjm4@illinois.edu>
Date: Sun, 28 Dec 2025 14:46:13 -0500
Subject: [PATCH 2/2] add allowed tools per reviewer feedback

---
 examples/workflow-dispatch.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/examples/workflow-dispatch.yml b/examples/workflow-dispatch.yml
index d62d46836..5afb524c4 100644
--- a/examples/workflow-dispatch.yml
+++ b/examples/workflow-dispatch.yml
@@ -52,3 +52,6 @@ jobs:
             ${{ github.event.inputs.issue_number && format('Related Issue: #{0}', github.event.inputs.issue_number) || '' }}
 
             Task: ${{ github.event.inputs.task }}
+          # Basic file operations - add more tools as needed (e.g., Bash commands)
+          claude_args: |
+            --allowedTools "Read,Write,Edit,MultiEdit,LS"