GitHub Issues for Obsidian

An Obsidian plugin that integrates with GitHub 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.

Documentation

Check out the documentation for detailed information on setup, configuration, and usage.

Features

Issue & Pull Request Tracking

• Track issues and pull requests from multiple GitHub repositories
• Automatically sync GitHub 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

GitHub Projects v2 Integration

• Track GitHub Projects across repositories
• Kanban board view for project visualization
• Custom field support (status, priority, iteration)
• Project-specific filtering and organization

Sub-Issues Support

• Track GitHub sub-issues (parent/child relationships)
• Display sub-issues list with status indicators
• Navigate between parent and child issues
• Progress tracking with completion percentage

Markdown Notes

• 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

Installation

Via Community Plugins (Recommended)

1. Open Obsidian Settings
2. Navigate to Community Plugins
3. Click Browse and search for "GitHub Issues"
4. Click Install and then Enable

Manual Installation

1. Download the latest release from GitHub Releases
2. Extract to <vault>/.obsidian/plugins/github-issues/
3. Enable the plugin in Community Plugins
4. Reload Obsidian

Configuration

1. Create a new GitHub token with the repo and read:org permissions → GitHub Settings > Developer Settings > Personal access tokens
2. Configure the plugin in Obsidian settings:
   • Paste your GitHub token in the GitHub Token field
   • Adjust additional settings as needed

Adding Repositories

1. Open the plugin settings in Obsidian
2. Add repositories by entering the full GitHub repository path (e.g., lonoxx/obsidian-github-issues), or use the repository browser to select one or multiple repositories
3. Click Add Repository or Add Selected Repositories
4. The plugin will automatically fetch issues from the configured repositories

Support

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: