Skip to content

An Obsidian plugin that integrates with GitHub to track issues and pull requests directly in your vault.

License

Notifications You must be signed in to change notification settings

LonoxX/obsidian-github-issues

Repository files navigation

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.

✨ Features

  • Track issues and pull requests from specific GitHub repositories
  • Automatically sync GitHub data on Obsidian startup (configurable)
  • Filter tracked items by assignee and reviewers
  • Create Markdown notes for each issue or pull request

🚀 Installation

Via Obsidian Community Plugins

  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 the GitHub Releases page.
  2. Extract the contents into your Obsidian plugins folder: <vault>/.obsidian/plugins/github-issues/
  3. Enable the plugin in Obsidian under Community Plugins
  4. Reload or restart 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

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

About

An Obsidian plugin that integrates with GitHub to track issues and pull requests directly in your vault.

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

  •  

Contributors 3

  •  
  •  
  •