opencode GitHub Action

A GitHub Action that integrates opencode directly into your GitHub workflow.

Mention /opencode in your comment, and opencode will execute tasks within your GitHub Actions runner.

Features

Explain an issue

Leave the following comment on a GitHub issue. opencode will read the entire thread, including all comments, and reply with a clear explanation.

/opencode explain this issue

Fix an issue

Leave the following comment on a GitHub issue. opencode will create a new branch, implement the changes, and open a PR with the changes.

/opencode fix this

Review PRs and make changes

Leave the following comment on a GitHub PR. opencode will implement the requested change and commit it to the same PR.

Delete the attachment from S3 when the note is removed /oc

Review specific code lines

Leave a comment directly on code lines in the PR's "Files" tab. opencode will automatically detect the file, line numbers, and diff context to provide precise responses.

[Comment on specific lines in Files tab]
/oc add error handling here

When commenting on specific lines, opencode receives:

• The exact file being reviewed
• The specific lines of code
• The surrounding diff context
• Line number information

This allows for more targeted requests without needing to specify file paths or line numbers manually.

Installation

Run the following command in the terminal from your GitHub repo:

opencode github install

This will walk you through installing the GitHub app, creating the workflow, and setting up secrets.

Manual Setup

1. Install the GitHub app https://github.com/apps/opencode-agent. Make sure it is installed on the target repository.

2. Add the following workflow file to .github/workflows/opencode.yml in your repo. Set the appropriate model and required API keys in env.

   name: opencode
   
   on:
     issue_comment:
       types: [created]
     pull_request_review_comment:
       types: [created]
   
   jobs:
     opencode:
       if: |
         contains(github.event.comment.body, '/oc') ||
         contains(github.event.comment.body, '/opencode')
       runs-on: ubuntu-latest
       permissions:
         id-token: write
       steps:
          - name: Checkout repository
            uses: actions/checkout@v7
            with:
              fetch-depth: 1
              persist-credentials: false
   
          - name: Run opencode
            uses: step-security/opencode-action@v1
            env:
             ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
             GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
            with:
             model: anthropic/claude-sonnet-4-20250514
             use_github_token: true

3. Store the API keys in secrets. In your organization or project settings, expand Secrets and variables on the left and select Actions. Add the required API keys.