Skip to content
Cosine

Merging Pull Requests

The merge panel gives you full control of the process, including editing commit messages, picking merge strategies (squash, rebase, or merge), and managing approvals—all without leaving Cosine.

Here’s how to use it:

1. Open the Pull Request Panel

  • Go to your Task: Open any task that is linked to a GitHub repository and has an active pull request.
  • Open the “PR” panel: The panel shows a full overview of the current PR, including checks, approval status, description, code changes, and a “Merge PR” button.
GitHub merge pull request button

Note:
If the task isn’t connected to a GitHub repo or doesn’t have a PR, you’ll see a message explaining why the merge panel isn’t available.

2. Review PR Status and Details

  • At a glance, you’ll see:
    • Task status (e.g. ready, in progress, success)
    • CI checks (pass/fail/waiting)
    • Approval status (review requirements, any requested changes)
    • PR title (editable)
    • Description (editable)
    • Number of changed files, additions, and deletions — click through to see the diff
  • Tabs let you switch between an overview, all comments and review threads, and a complete list of commits.
PR status and details overview

Edit Title:
Click on the title to edit it. Cosine will update the PR on GitHub when you click away.

Edit Description:
Type in the new description and click “Save” — Cosine will update the PR on GitHub. “Reset” reverts the description to what’s currently on GitHub. “Clear” removes it so you can start from scratch.

3. Check comments left on the PR

  • You can see global PR comments as well as unresolved review threads, including replies, from the “Comments” tab.
  • You can respond to and resolve unresolved threads directly from the Comments tab.
  • Everything stays in sync with GitHub — new comments appear instantly, and your replies are posted to the PR immediately.
PR comments tab showing review comments and replies

4. Click “Merge PR”

  • Click the Merge PR button to begin. If the PR is already closed or merged, you’ll see its current status.
  • A confirmation panel will open with several options before you commit.

5. Choose Merge Strategy and Commit Message

  • Pick a Merge Strategy:
    Cosine will show the available strategies for this repository (e.g. Merge, Squash, or Rebase).
    • Use tabs to pick your preferred method.
    • Not all repos support every strategy — Cosine only shows what’s enabled in your GitHub settings.
  • Set Commit Message:
    For “merge” and “squash” strategies, you can edit the final commit message before merging.

Warning:
If your task is not in the “success” state (e.g. CI checks failed), Cosine will warn you before letting you proceed. Merging is still possible, but not recommended.

Merge strategy and commit message options

6. Confirm the Merge

  • Click Confirm Merge to complete the process.
  • Cosine will merge the PR via GitHub’s API and show a success or error notification.
  • If you run into errors, Cosine will display them in the panel for quick troubleshooting.

7. After the Merge

  • The PR panel will update to show the new status (“MERGED”).
  • All comments, threads, and commit history remain available for reference.

FAQ & Troubleshooting

  • Can I change the PR title/description before merging?
    Yes — edit either field and click “Save.” Cosine syncs changes to GitHub immediately.
  • Why can’t I see certain merge methods?
    Only strategies enabled for your repo in GitHub will appear.
  • What if CI checks or approvals are missing?
    Cosine will warn you but won’t block the merge. If your GitHub settings allow merging without passing CI, approvals, or resolved threads, Cosine won’t override that.
  • What if the merge fails?
    Cosine shows detailed error messages if GitHub returns any issues (e.g. conflicts, branch protection rules, permission errors).

Support

For more help, reach out to the Cosine support team or check with your GitHub administrator if you’re blocked by repo settings.