[BUG] opencode github install hangs indefinitely after GitHub App installation

[Harshit16g]

Description

Bug: opencode github install hangs indefinitely after GitHub App installation

Summary

After successfully installing the OpenCode Agent GitHub App and granting the requested repository permissions, running:

opencode github install

never completes.

The CLI remains waiting indefinitely until the operation is manually cancelled. Re-running the command produces the same behavior.

---

Environment

Item	Value
Operating System	Ubuntu Linux
Shell	Bash
OpenCode CLI	Latest available at the time of reporting
GitHub Account	Personal account
Repository	Private repository
Repository Access	All repositories

---

Steps to Reproduce

1. Navigate to any Git repository.

cd /path/to/project

2. Execute:

opencode github install

3. The browser opens the GitHub App installation page.

4. Install the OpenCode GitHub App.

5. Grant the requested permissions.

6. Return to the terminal.

---

Expected Behavior

Once the GitHub App installation has been completed, the CLI should:

• Detect the completed installation.
• Finish the setup process.
• Exit successfully.
• Display a confirmation message or continue with any remaining configuration steps.

Example:

✓ GitHub Agent installed successfully.

---

Actual Behavior

The installation never completes.

The terminal remains waiting indefinitely with no progress indicator or additional output until the process is manually cancelled.

Cancelling the operation and executing the command again produces the exact same behavior.

Example:

$ opencode github install

┌ Install GitHub agent
│
◇ Canceled

Running the command again:

$ opencode github install

┌ Install GitHub agent
│
◇ Canceled

---

CLI Output

$ cd /path/to/project

$ opencode github install

┌ Install GitHub agent
│
◇ Canceled

$ opencode github install

┌ Install GitHub agent
│
◇ Canceled

---

GitHub App Status

The GitHub App installation appears to complete successfully.

Permissions granted include:

• Read access

  • Actions
  • Checks
  • Deployments
  • Metadata
  • Packages

• Read and write access

  • Code
  • Issues
  • Pull Requests
  • Secrets
  • Workflows

Repository access was configured for All repositories.

The attached screenshot shows the successful installation page.

---

Possible Cause

The CLI appears to be waiting for a completion event that never occurs. Possible causes include:

• Failure to detect the completed GitHub App installation.
• An OAuth or callback endpoint not being triggered.
• Indefinite polling of the GitHub API without a timeout.
• Failure to associate the completed installation with the current CLI session.
• Missing or unhandled API response during the installation verification step.

---

Suggested Improvements

• Add a timeout while waiting for installation confirmation.
• Display progress or polling status during the installation process.
• Provide a --verbose or --debug mode showing:
  • API requests
  • Polling status
  • Installation ID
  • Current authentication state
• Report API or authentication errors instead of waiting silently.
• Allow the CLI to resume an existing installation rather than restarting the flow.

---

Severity

Medium–High

The GitHub App installs successfully, but the CLI never completes the installation workflow, preventing users from using the GitHub integration.

---

Privacy Notice

This report has been sanitized for public disclosure.

The attached screenshot has been redacted to remove:

• Local filesystem paths
• Email addresses
• Personal identifiers
• Any other personally identifiable information (PII)

Plugins

GitHub

OpenCode version

1.17.20

Steps to reproduce

1. Navigate to any Git repository.

   cd /path/to/project

2. Run:

   opencode github install

3. The browser opens the GitHub App installation page.

4. Install the OpenCode GitHub App and grant the requested permissions.

5. Return to the terminal.

6. Observe that the CLI waits indefinitely and never completes.

7. Cancel the operation and run the command again.

8. The same behavior occurs every time.

Screenshot and/or share link

Operating System

Ubuntu 24.04.2 LTS

Terminal

ubuntu:GNOME