Add Claude Code GitHub Workflow by rjpower · Pull Request #2384 · marin-community/marin

rjpower · 2026-01-19T17:54:08Z

This PR adds a GitHub Actions workflow that enables Claude Code integration in our repository.

The workflow runs automatically whenever Claude is mentioned in PR or issue comments
Claude gets access to the entire PR or issue context including files, diffs, and previous comments
Claude's default tools are limited to reading/writing files and interacting with our repo by creating comments, branches, and commits.
We can add more allowed tools by adding them to the workflow file like:

Copilot

Pull request overview

This PR adds GitHub Actions workflows to integrate Claude Code, an AI coding assistant, into the repository. The integration allows users to interact with Claude by mentioning @claude in comments, and also provides automated code review capabilities on pull requests.

Changes:

Added .github/workflows/claude.yml for on-demand Claude interactions via @claude mentions in issues and PR comments
Added .github/workflows/claude-code-review.yml for automatic Claude code reviews on all pull requests

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

File	Description
`.github/workflows/claude.yml`	Workflow that triggers Claude when @claude is mentioned in PR comments, issue comments, reviews, or new issues
`.github/workflows/claude-code-review.yml`	Workflow that automatically runs Claude code reviews on all pull requests when opened, synchronized, or reopened

Copilot · 2026-01-19T17:56:16Z

.github/workflows/claude.yml

+      contents: read
+      pull-requests: read
+      issues: read


The permissions for this workflow are insufficient for Claude to perform its intended functions. According to the PR description, Claude should be able to "create comments, branches, and commits", but the current permissions only allow read access.

The workflow needs write permissions added:

contents: write - to create branches and commits

pull-requests: write - to create/update PR comments

issues: write - to create/update issue comments

Without these permissions, Claude will fail when attempting to write any changes or responses back to the repository.

Suggested change

contents: read

pull-requests: read

issues: read

contents: write

pull-requests: write

issues: write

Copilot · 2026-01-19T17:56:17Z

.github/workflows/claude-code-review.yml

+      pull-requests: read
+      issues: read


The permissions for this automated code review workflow are insufficient. The workflow only has read permissions, but needs write permissions to post review comments and feedback.

Add write permissions:

pull-requests: write - to post review comments

issues: write - to create comments on the PR

Without these permissions, Claude will be unable to post its code review feedback.

Suggested change

pull-requests: read

issues: read

pull-requests: write

issues: write

Agree with co pilot here, seems like these permissions are too strict?

Copilot · 2026-01-19T17:56:17Z

.github/workflows/claude-code-review.yml

+  claude-review:
+    # Optional: Filter by PR author
+    # if: |
+    #   github.event.pull_request.user.login == 'external-contributor' ||
+    #   github.event.pull_request.user.login == 'new-developer' ||
+    #   github.event.pull_request.author_association == 'FIRST_TIME_CONTRIBUTOR'


This workflow will run automatically on every pull request (opened, synchronize, ready_for_review, reopened) without any filtering. This could result in:

Unnecessary Claude API costs for every PR

Potential noise from automated reviews on all PRs, including trivial ones

Slower PR workflows due to waiting for automated reviews

Consider uncommenting and configuring the author filter (lines 15-19) to limit automatic reviews to specific users or first-time contributors, or add path filtering (lines 6-11) to only review relevant code changes. Alternatively, you could remove this workflow entirely and only use the @claude mention workflow for on-demand reviews.

@claude-review

Changes: - claude-code-review.yml: Auto-trigger only for PRs from repo writers, manual trigger via @claude-review - claude.yml: Restrict @claude mentions to repo writers only - Both workflows now check author_association (OWNER, MEMBER, COLLABORATOR)

yonromai

Awesome! I actually started hacking on this this weekend, you beat me to it!

yonromai · 2026-01-20T15:49:06Z

.github/workflows/claude-code-review.yml

+      pull-requests: read
+      issues: read


Agree with co pilot here, seems like these permissions are too strict?

yonromai · 2026-01-20T15:49:55Z

.github/workflows/claude-code-review.yml

+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          plugin_marketplaces: 'https://github.com/anthropics/claude-code.git'
+          plugins: 'code-review@claude-code-plugins'
+          prompt: '/code-review:code-review ${{ github.repository }}/pull/${{ steps.pr-number.outputs.number }}'


nit: Why not follow the /review convention in the CLI and the GH action doc

Sounds good to me, we can change it.

yonromai · 2026-01-20T15:54:51Z

.github/workflows/claude-code-review.yml

+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1


nit: I wonder if we should > 100 (or 0 + potentially a file filter). I end up using claude to look into the git history a bunch.

These were the defaults from Claude. I'm not against tweaking it, but I don't know if it has consequences for the actions? Maybe let's start with this and see if we run into issues?

yonromai · 2026-01-20T15:55:05Z

.github/workflows/claude.yml

+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1


nit: ditto ^

@claude-review

- Change permissions from read to write for contents, pull-requests, issues (required for Claude to comment and push changes to PR branches) - Change review trigger from @claude-review to /review - Increase fetch-depth from 1 to 10 for recent git history access

rjpower · 2026-01-20T17:18:10Z

Adjusted permissions and set the fetch limit to 10 to see how that goes..

@claude

Users can trigger code reviews via @claude in the main workflow (e.g., "@claude review this PR" or "@claude /review").

rjpower added 2 commits January 19, 2026 09:53

"Claude PR Assistant workflow"

c54190e

"Claude Code Review workflow"

21e44c5

Copilot AI review requested due to automatic review settings January 19, 2026 17:54

Copilot started reviewing on behalf of rjpower January 19, 2026 17:54 View session

Copilot AI reviewed Jan 19, 2026

View reviewed changes

rjpower requested review from Helw150 and ahmeda14960 January 19, 2026 18:12

dlwh approved these changes Jan 20, 2026

View reviewed changes

yonromai approved these changes Jan 20, 2026

View reviewed changes

rjpower added 2 commits January 20, 2026 09:18

Merge branch 'main' into add-claude-github-actions-1768845234712

d0065e9

Remove separate code review workflow

970d2bf

Users can trigger code reviews via @claude in the main workflow (e.g., "@claude review this PR" or "@claude /review").

rjpower enabled auto-merge (squash) January 20, 2026 17:29

rjpower merged commit 4ecb27d into main Jan 20, 2026
7 of 8 checks passed

rjpower deleted the add-claude-github-actions-1768845234712 branch January 20, 2026 17:31

Conversation

rjpower commented Jan 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Jan 19, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 19, 2026

Choose a reason for hiding this comment

Uh oh!

yonromai Jan 20, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 19, 2026

Choose a reason for hiding this comment

Uh oh!

yonromai left a comment

Choose a reason for hiding this comment

Uh oh!

yonromai Jan 20, 2026

Choose a reason for hiding this comment

Uh oh!

yonromai Jan 20, 2026

Choose a reason for hiding this comment

Uh oh!

rjpower Jan 20, 2026

Choose a reason for hiding this comment

Uh oh!

yonromai Jan 20, 2026

Choose a reason for hiding this comment

Uh oh!

rjpower Jan 20, 2026

Choose a reason for hiding this comment

Uh oh!

yonromai Jan 20, 2026

Choose a reason for hiding this comment

Uh oh!

rjpower commented Jan 20, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

rjpower commented Jan 19, 2026 •

edited

Loading