opencode integrates with your GitHub workflow. Mention /opencode or /oc in your comment, and opencode will execute tasks within your GitHub Actions runner.

• Triage issues: Ask opencode to look into an issue and explain it to you.
• Fix and implement: Ask opencode to fix an issue or implement a feature. And it will work in a new branch and submits a PR with all the changes.
• Secure: opencode runs inside your GitHub's runners.

Run the following command in a project that is in a GitHub repo:

opencode github install

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

Or you can set it up manually.

1. Install the GitHub app

   Head over to github.com/apps/opencode-agent. Make sure it's installed on the target repository.

2. Add the workflow

   Add the following workflow file to .github/workflows/opencode.yml in your repo. Make sure to 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@v4
           with:
             fetch-depth: 1
   
         - name: Run opencode
           uses: sst/opencode/github@latest
           env:
             ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
           with:
             model: anthropic/claude-sonnet-4-20250514
             # share: true
             # github_token: xxxx

3. Store the API keys in secrets

   In your organization or project settings, expand Secrets and variables on the left and select Actions. And add the required API keys.

• model: The model to use with opencode. Takes the format of provider/model. This is required.

• share: Whether to share the opencode session. Defaults to true for public repositories.

• prompt: Optional custom prompt to override the default behavior. Use this to customize how opencode processes requests.

• token: Optional GitHub access token for performing operations such as creating comments, committing changes, and opening pull requests. By default, opencode uses the installation access token from the opencode GitHub App, so commits, comments, and pull requests appear as coming from the app.

  Alternatively, you can use the GitHub Action runner's built-in GITHUB_TOKEN without installing the opencode GitHub App. Just make sure to grant the required permissions in your workflow:

  permissions:
    id-token: write
    contents: write
    pull-requests: write
    issues: write

  You can also use a personal access tokens(PAT) if preferred.

Override the default prompt to customize opencode's behavior for your workflow.

- uses: sst/opencode/github@latest
  with:
    model: anthropic/claude-sonnet-4-5
    prompt: |
      Review this pull request:
      - Check for code quality issues
      - Look for potential bugs
      - Suggest improvements

This is useful for enforcing specific review criteria, coding standards, or focus areas relevant to your project.

Here are some examples of how you can use opencode in GitHub.

• Explain an issue

  Add this comment in a GitHub issue.

  /opencode explain this issue
  

  opencode will read the entire thread, including all comments, and reply with a clear explanation.

• Fix an issue

  In a GitHub issue, say:

  /opencode fix this
  

  And opencode will create a new branch, implement the changes, and open a PR with the changes.

• Review PRs and make changes

  Leave the following comment on a GitHub PR.

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

  opencode will implement the requested change and commit it to the same PR.

• Review specific code lines

  Leave a comment directly on code lines in the PR's "Files" tab. opencode automatically detects 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.