Skip to main content
The GitHub sidebar brings issues, pull requests and GitHub Projects into the workspace. Use it to choose work without copying an issue into a new conversation by hand.

​
Connect a repository

  1. Install the GitHub CLI (gh) on the Mac and sign in with access to the repository.
  2. Add its local Git folder as a Dure project. Confirm that its remote identifies the intended GitHub repository.
  3. Open GitHub in the sidebar and choose the repository.
  4. Select Issues, Pull requests or Projects, then use search, filters and refresh as needed.
The sidebar uses your desktop GitHub access. Provider login is separate, and organization access may require additional GitHub permissions. Projects needs the read:project scope; if it reports a permission error, run gh auth refresh -s read:project. Issues and pull requests still work without it.

​
Start an agent from an issue

Click Start on the work item. Dure opens New agent with the project, an agent name and a request for the issue or pull request filled in. Isolate in a dedicated worktree starts off; turn it on when the task needs separate files. Review and edit the request, project and provider, then press Enter or Start agent.

The Start action on an example GitHub issue opens the agent task flow.

For an issue, the prefilled request asks the agent to check it against the current code first. If the issue is already resolved, the request may ask the agent to comment with the completion evidence and close the issue instead of making duplicate changes. Edit the request before starting if the agent should not change the issue. For a pull request, the request asks the agent to address the remaining work and prepare it for review; starting the agent does not merge it.

​
Return to the work

If a matching agent already exists, Open returns to it. Read the item detail for discussion and current status, and use its external link when you want the full GitHub page. Check the repository and action before changing GitHub state. Review the agent’s changes and verification using Diff. Keep the issue’s outcome aligned with the work you actually accepted.

​
Configure the integration

Open Plugins → GitHub → Plugin settings for settings such as refresh interval and the default issue list in the selected workspace. See plugins for compatibility and settings scope. For a remote agent reading issues through the desktop login, use the separate SSH GitHub read connection. Its supported commands and access boundaries differ from the local sidebar.