Claude Code GitHub Action

Features

• Process PR and issue comments with different prefixes to trigger specific behaviors
• Get AI-powered code analysis and suggestions
• Create GitHub-compatible suggested changes that can be applied with one click
• Automatically analyze issues and create fix PRs
• Provide rich context about PRs and issues to Claude
• Simple setup with minimal configuration
• Uses GitHub CLI and Claude Code CLI for reliability

Quick Start

1. Add Claude to Your Repository

Create a workflow file to integrate Claude with your repository:

File: .github/workflows/claude-code.yml

name: Claude Code Integration

on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]

jobs:
  claude-integration:
    uses: fractureinc/claude-code-github-action/.github/workflows/claude-full.yml@v0.5.6
    with:
      issue-label: 'claude-fix'  # Optional: customize the trigger label
    secrets:
      ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

Example Queries

PR Comments

• claude: Explain the changes in this PR
• claude: Suggest improvements for the code quality
• claude: Identify potential security issues
• claude: Is this implementation optimal?
• claude-suggest: Refactor this code to be more maintainable
• claude-suggest: Add error handling for edge cases

PR Code Review Comments

• claude: What's the purpose of this function?
• claude: Is there a potential bug here?
• claude-suggest: Fix this loop to handle empty arrays
• claude-suggest: Optimize this database query

Issue Comments

• claude: What might be causing this bug?
• claude: Analyze this error log and suggest potential fixes
• claude: How would you implement this feature?
• claude-fix: Implement proper error handling for division by zero
• claude-fix: Fix the memory leak in the connection pool

Release v0.5.6: Initial release

Claude Code GitHub Action v0.5.6

Features

• Process PR and issue comments with different prefixes to trigger specific behaviors
• Get AI-powered code analysis and suggestions
• Create GitHub-compatible suggested changes that can be applied with one click
• Automatically analyze issues and create fix PRs
• Provide rich context about PRs and issues to Claude
• Simple setup with minimal configuration
• Uses GitHub CLI and Claude Code CLI for reliability

Quick Start

1. Add Claude to Your Repository

Create a workflow file to integrate Claude with your repository:

File: .github/workflows/claude-code.yml

name: Claude Code Integration

on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]

jobs:
  claude-integration:
    uses: fractureinc/claude-code-github-action/.github/workflows/claude-full.yml@v0.5.6
    with:
      issue-label: 'claude-fix'  # Optional: customize the trigger label
    secrets:
      ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

Example Queries

PR Comments

• claude: Explain the changes in this PR
• claude: Suggest improvements for the code quality
• claude: Identify potential security issues
• claude: Is this implementation optimal?
• claude-suggest: Refactor this code to be more maintainable
• claude-suggest: Add error handling for edge cases

PR Code Review Comments

• claude: What's the purpose of this function?
• claude: Is there a potential bug here?
• claude-suggest: Fix this loop to handle empty arrays
• claude-suggest: Optimize this database query

Issue Comments

• claude: What might be causing this bug?
• claude: Analyze this error log and suggest potential fixes
• claude: How would you implement this feature?
• claude-fix: Implement proper error handling for division by zero
• claude-fix: Fix the memory leak in the connection pool

Release v0.5.5: Fix workflow issues

Claude Code GitHub Action v0.5.5

This release fixes critical issues with GitHub Action workflows that were preventing proper execution.

What's Fixed

• Workflow Execution Issues: Fixed problems that were preventing workflows from starting properly
• Removed heredoc multi-line handling: Reverted to simpler echo key=value approach for GitHub Actions outputs
• Version consistency: Ensured all references use v0.5.5 throughout the codebase
• Removed all GH_TOKEN references: Eliminated any remaining references to custom GitHub tokens

Technical Details

• Simplified GitHub Actions output handling
• Consistently using built-in github.token throughout
• Ensured all workflow and action references are updated to v0.5.5

Upgrading

To upgrade, update the version references in your workflow files:

uses: fractureinc/claude-code-github-action/.github/workflows/claude-full.yml@v0.5.5
uses: fractureinc/claude-code-github-action/.github/workflows/claude-label-fix.yml@v0.5.5

The only secret you need to pass is your ANTHROPIC_API_KEY:

secrets:
  ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

Release v0.5.4: Simplify workflow token usage

Claude Code GitHub Action v0.5.4

This release significantly simplifies the GitHub token handling in workflows and fixes a critical issue with reserved token names.

What's Fixed

• Workflow Token Handling: Removed the need to pass GITHUB_TOKEN as a secret
• Token Name Collision: Fixed error with reserved GITHUB_TOKEN name in reusable workflows
• Simplified Integration: Users no longer need to pass GITHUB_TOKEN to workflows explicitly

Technical Details

• Now using GitHub's built-in github.token context variable
• Removed token passing requirements from all reusable workflows
• Updated examples and README to match this simpler approach

Upgrading

To upgrade, simply update the version references in your workflow files:

uses: fractureinc/claude-code-github-action/.github/workflows/claude-full.yml@v0.5.4
uses: fractureinc/claude-code-github-action/.github/workflows/claude-label-fix.yml@v0.5.4

The only secret you now need to pass is your ANTHROPIC_API_KEY:

secrets:
  ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

All previous features from v0.5.3 remain intact, including the multi-line feedback handling.

Release v0.5.3: Fix GitHub Actions workflow validation issues

Claude Code GitHub Action v0.5.3

This release fixes critical GitHub Actions workflow validation issues that were preventing the action from running correctly.

What's Fixed

• GitHub Actions Output Syntax: Fixed inconsistent output handling across workflow steps
• Multi-line String Handling: Applied proper heredoc-style syntax consistently throughout all workflow files
• Workflow Validation Errors: Resolved "Unable to process file command output" errors that were preventing workflows from starting

Technical Details

The fix ensures consistent use of the GitHub Actions heredoc-style syntax (<<EOF delimiter) for all variables being set as outputs, which properly handles multi-line strings in user feedback.

All previous features from v0.5.2 remain intact, including the improved in-line code suggestion functionality.

Upgrading

To upgrade, simply update the version references in your workflow files:

uses: fractureinc/claude-code-github-action/.github/workflows/claude-full.yml@v0.5.3
uses: fractureinc/claude-code-github-action/.github/workflows/claude-label-fix.yml@v0.5.3

Release v0.5.2: Fix multi-line feedback handling

Claude Code GitHub Action v0.5.2

This release fixes an issue with handling multi-line feedback in GitHub Actions.

What's Fixed

• Multi-line Feedback Handling: Fixed an issue where user feedback containing newlines would cause GitHub Actions to fail
• Improved Workflow Reliability: Updated output handling to properly use GitHub Actions' heredoc-style syntax for multi-line strings
• Enhanced User Experience: Users can now provide more detailed multi-line feedback in comments without causing workflow failures

This fix ensures that when users provide feedback like:

claude-suggest: Fix this function to handle error cases

Add try/catch blocks and proper error handling.

The workflow will process it correctly instead of failing with "Unable to process file command 'output' successfully" errors.

All other features from v0.5.1 remain unchanged, including the improved in-line code suggestion functionality.

Release v0.5.1: Fix for In-line Code Suggestions

Claude Code GitHub Action v0.5.1

This release fixes an issue with the in-line code suggestion feature.

What's Fixed

• In-line Code Suggestions: Claude can now suggest multi-line changes when needed
• Improved Context: Expanded context window around the line being reviewed
• Better Suggestions: More comprehensive fixes when a single-line change is insufficient

When commenting on a specific line with claude-suggest:, Claude will now be able to suggest:

• A single-line change when that's sufficient
• A multi-line change when needed to properly implement the requested functionality

This makes the suggestion feature much more useful for cases where the fix requires changes to an entire function or block of code.

Example

When commenting on a line with:

claude-suggest: Fix this calculation to handle division by zero

Claude can now suggest a complete implementation that might span multiple lines, rather than being limited to just the one line where the comment was made.

All other features from v0.5.0 remain unchanged, including the simplified integration with reusable workflows.

Release v0.5.0: Simplified Integration

Claude Code GitHub Action v0.5.0

This release significantly simplifies integration with your repositories by introducing reusable workflows.

What's New

• Reusable Workflows: Add Claude to your repository with minimal configuration
• Simplified Setup: Only two small workflow files needed to get started
• Improved Documentation: Clearer examples and configuration options
• Better Usability: All the same functionality with much less configuration

How to Use

Create two small workflow files in your repository:

Comment-based interactions (PR & issue comments):

# .github/workflows/claude-code.yml
name: Claude Code Integration

on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]

jobs:
  claude-integration:
    uses: fractureinc/claude-code-github-action/.github/workflows/claude-full.yml@v0.5.0
    with:
      issue-label: 'claude-fix'  # Optional: customize as needed
    secrets:
      ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
      GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Label-based issue fixes:

# .github/workflows/claude-issue-fix.yml
name: Claude Code Issue Fix

on:
  issues:
    types: [labeled]

jobs:
  claude-label-fix:
    uses: fractureinc/claude-code-github-action/.github/workflows/claude-label-fix.yml@v0.5.0
    with:
      issue-label: 'claude-fix'  # Must match your chosen label
    secrets:
      ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
      GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

That's it! You can now use Claude in your repository with the standard prefixes:

• claude: <query> - For analysis on PRs and issues
• claude-suggest: <query> - For code suggestions on PRs
• claude-fix: <query> - For auto-fixing issues
• Add the claude-fix label to an issue - For auto-fixing issues

v0.4.0: Added issue interactions and standard project files

This release adds support for issue interactions and includes standard project files:

New Features:

• Support for comments on issues to get analysis without code changes
• Support for comments on issues to create fix PRs
• Improved documentation with clear examples of all supported modes
• Complete GitHub repo structure with LICENSE, CONTRIBUTING, etc.

The GitHub Action now supports:

1. PR comments with and
2. PR code review comments with and
3. Issue comments with and
4. Issue labels with

This makes Claude Code fully integrated with both PRs and issues.

v0.3.9: Add configurable issue label and debug mode

This release adds more flexibility to the issue-fix mode:

Improvements:

• Added configurable issue label (default: 'claude-fix')
• Added debug mode option to enable shell tracing and Claude debug output
• Improved code to handle the new options
• Updated documentation to reflect these new options

These changes make it easier to integrate the action into your workflows by allowing customization of the labels that trigger the action and providing better debugging capabilities when troubleshooting issues.