An Obsidian plugin that integrates with GitHub and GitLab to track issues and pull requests directly in your vault.
The configurations are heavily inspired by https://github.com/schaier-io, including some specific settings. However, I had already started working on my prototype before I discovered the plugin, and had initially even given it a similar name.
Check out the documentation for detailed information on setup, configuration, and usage.
- Track issues and pull requests from multiple GitHub and GitLab repositories
- Automatically sync data on startup (configurable)
- Background sync at configurable intervals
- Filter by labels, assignees, and reviewers
- Include or exclude closed issues/PRs
- Automatic cleanup of old closed items
- Full support for GitLab Issues and Merge Requests
- Works with self-hosted GitLab instances
- Multiple GitLab instances can be configured simultaneously
- Track GitHub Projects across repositories
- Kanban board view for project visualization
- Custom field support (status, priority, iteration)
- Project-specific filtering and organization
- Track sub-issues for both GitHub and GitLab (parent/child relationships)
- Display sub-issues list with status indicators
- Navigate between parent and child issues
- Progress tracking with completion percentage
- Central configuration for folders, templates, sync behaviour, and filters
- Assign one profile to multiple repositories instead of configuring each one individually
- Create markdown notes for each issue or PR
- Customizable filename templates with variables
- Custom content templates
- YAML frontmatter with metadata
- Preserve user content with persist blocks
- Include comments in notes
- Open Obsidian Settings
- Navigate to Community Plugins
- Click Browse and search for "GitHub Issues"
- Click Install and then Enable
- Download the latest release from GitHub Releases
- Extract to
<vault>/.obsidian/plugins/github-issues/ - Enable the plugin in Community Plugins
- Reload Obsidian
- Create a GitHub token with
repoandread:orgpermissions → GitHub Settings > Developer Settings > Personal access tokens - Paste the token in Settings - Providers - GitHub Token
- Create a GitLab Personal Access Token with
read_apiscope → GitLab → Preferences → Access Tokens - Enable the GitLab provider in Settings - Providers - GitLab Token and paste your token
- Open the plugin settings in Obsidian
- Add repositories by entering the full repository path (e.g.,
lonoxx/obsidian-github-issues), or use the repository browser to select one or multiple repositories - Click Add Repository or Add Selected Repositories
- The plugin will automatically fetch issues from the configured repositories
If you find this plugin useful and would like to support its development, you can star the repository or support me on Ko-fi or GitHub Sponsors:
