docs: recommend reusable workflow for GitHub Actions

Replace inline workflow with Continue's reusable workflow which handles
agent discovery, parallel execution, and check reporting. GH_TOKEN is
now automatically provided for agents using the gh CLI.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: bdougie

docs/guides/run-agents-locally.mdx

@@ -220,158 +220,57 @@ Before enabling fully automated agents:
 
 ## GitHub Actions Integration
 
-Automate agent execution on pull requests with this workflow.
+Continue provides a [reusable workflow](https://github.com/continuedev/continue/blob/main/.github/workflows/continue-agents.yml) that handles agent discovery, parallel execution, and GitHub Check reporting.
 
-### Basic Workflow
+### Using the Reusable Workflow (Recommended)
 
-Create `.github/workflows/continue-agents.yml`:
+Create `.github/workflows/run-agents.yml`:
 
 ```yaml
-name: Continue Agents
+name: Run Agents
 
 on:
   pull_request:
     types: [opened, reopened, synchronize]
     branches:
       - main
 
-permissions:
-  contents: write
-  checks: write
-  pull-requests: write
+jobs:
+  agents:
+    uses: continuedev/continue/.github/workflows/continue-agents.yml@main
+    secrets:
+      ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+```
+
+The reusable workflow automatically:
+- Discovers all `.md` files in `.continue/agents/`
+- Runs each agent in parallel
+- Creates GitHub Check runs for each agent
+- Provides `GH_TOKEN` for agents using the `gh` CLI
+- Writes job summaries with agent output
 
+### Configuration Options
+
+```yaml
 jobs:
-  discover:
-    runs-on: ubuntu-latest
-    outputs:
-      matrix: ${{ steps.discover.outputs.matrix }}
-      has-agents: ${{ steps.discover.outputs.has_agents }}
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Discover agents
-        id: discover
-        run: |
-          AGENTS_DIR=".continue/agents"
-          if [ -d "$AGENTS_DIR" ]; then
-            FILES=$(find "$AGENTS_DIR" -name "*.md" -type f 2>/dev/null | jq -R . | jq -sc .)
-            COUNT=$(echo "$FILES" | jq 'length')
-            HAS_AGENTS=$([[ $COUNT -gt 0 ]] && echo "true" || echo "false")
-          else
-            FILES="[]"
-            HAS_AGENTS="false"
-          fi
-
-          echo "matrix=$FILES" >> $GITHUB_OUTPUT
-          echo "has_agents=$HAS_AGENTS" >> $GITHUB_OUTPUT
-
-  run-agent:
-    needs: discover
-    if: needs.discover.outputs.has-agents == 'true'
-    runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        agent: ${{ fromJson(needs.discover.outputs.matrix) }}
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-
-      - name: Install Continue CLI
-        run: npm i -g @continuedev/cli
-
-      - name: Extract agent name
-        id: agent-name
-        run: |
-          AGENT_FILE="${{ matrix.agent }}"
-          AGENT_NAME=$(basename "$AGENT_FILE" .md)
-          echo "name=$AGENT_NAME" >> $GITHUB_OUTPUT
-
-      - name: Create Check Run
-        id: check
-        uses: actions/github-script@v7
-        env:
-          AGENT_NAME: ${{ steps.agent-name.outputs.name }}
-        with:
-          script: |
-            const { data: check } = await github.rest.checks.create({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              name: `Continue: ${process.env.AGENT_NAME}`,
-              head_sha: context.sha,
-              status: 'in_progress',
-              started_at: new Date().toISOString(),
-            });
-            core.setOutput('id', check.id);
-
-      - name: Run agent
-        id: run
-        env:
-          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
-          GH_TOKEN: ${{ github.token }}
-        run: |
-          AGENT_FILE="${{ matrix.agent }}"
-
-          if OUTPUT=$(cn -p --agent "$AGENT_FILE" 2>&1); then
-            echo "success=true" >> $GITHUB_OUTPUT
-            echo "output<<EOF" >> $GITHUB_OUTPUT
-            echo "$OUTPUT" >> $GITHUB_OUTPUT
-            echo "EOF" >> $GITHUB_OUTPUT
-          else
-            echo "success=false" >> $GITHUB_OUTPUT
-            echo "error<<EOF" >> $GITHUB_OUTPUT
-            echo "$OUTPUT" >> $GITHUB_OUTPUT
-            echo "EOF" >> $GITHUB_OUTPUT
-          fi
-
-      - name: Update Check Run
-        if: always()
-        uses: actions/github-script@v7
-        env:
-          AGENT_OUTPUT: ${{ steps.run.outputs.output }}
-          AGENT_ERROR: ${{ steps.run.outputs.error }}
-          AGENT_SUCCESS: ${{ steps.run.outputs.success }}
-          CHECK_RUN_ID: ${{ steps.check.outputs.id }}
-        with:
-          script: |
-            const success = process.env.AGENT_SUCCESS === 'true';
-            const output = process.env.AGENT_OUTPUT || '';
-            const error = process.env.AGENT_ERROR || '';
-
-            await github.rest.checks.update({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              check_run_id: parseInt(process.env.CHECK_RUN_ID, 10),
-              status: 'completed',
-              conclusion: success ? 'success' : 'failure',
-              completed_at: new Date().toISOString(),
-              output: {
-                title: success ? 'Agent completed' : 'Agent failed',
-                summary: success
-                  ? `Agent completed.\n\n\`\`\`\n${output.slice(0, 60000)}\n\`\`\``
-                  : `Agent failed.\n\n\`\`\`\n${error.slice(0, 60000)}\n\`\`\``,
-              },
-            });
-
-      - name: Fail if agent failed
-        if: steps.run.outputs.success != 'true'
-        run: exit 1
+  agents:
+    uses: continuedev/continue/.github/workflows/continue-agents.yml@main
+    with:
+      agents-path: '.continue/agents'  # Custom agents directory (optional)
+    secrets:
+      ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
 ```
 
 ### Required Secrets
 
-Add these secrets to your repository under **Settings > Secrets and variables > Actions**:
+Add this secret to your repository under **Settings > Secrets and variables > Actions**:
 
 | Secret | Description |
 |--------|-------------|
 | `ANTHROPIC_API_KEY` | Your Anthropic API key for Claude |
 
 <Info>
-  The `GH_TOKEN` is automatically provided by GitHub Actions via `${{ github.token }}`. This token is scoped to the repository and expires after the workflow completes.
+  The reusable workflow automatically provides `GH_TOKEN` via `${{ github.token }}`, so agents using the `gh` CLI work out of the box.
 </Info>
 
 ## Environment Variables