Skip to content

GitHub Integration

Shellarium integrates with GitHub to streamline the full development workflow — from issue to pull request.

You need the GitHub CLI (gh) installed and authenticated. Shellarium uses gh under the hood for all GitHub operations.

After an agent finishes work, you can create a pull request directly from Shellarium:

  1. Open the workspace chat view
  2. Review the branch name and diff
  3. Click Create PR in the action toolbar — the agent prepares and opens a PR using gh

The sidebar shows all open pull requests for your repository. PRs created by Shellarium are automatically linked to their workspace.

The sidebar’s Issues section lists open issues from your repository.

Click any issue to create a workspace from it. Shellarium uses the issue title and body as the task description for the agent.

When a workspace has an associated pull request, the Merge tab shows:

  • CI check status — passing, failing, or pending
  • Review decision — approved, changes requested, or review required
  • Check list summary — check names and workflow context

This helps you ensure code quality before merging agent changes.