Issue Tracking

Issue & Pull Request Tracking

Track GitHub issues and pull requests directly in your Obsidian vault. Each issue and PR becomes a markdown note with metadata, making it easy to link, search, and organize your development work.

Overview

• Track multiple repositories simultaneously
• Automatic sync on startup and in the background
• Filter by labels, assignees, and status
• Custom filename and content templates
• Include comments in your notes

Getting Started

1. Add a Repository

1. Open plugin settings
2. Click Load Repositories to browse your GitHub repos
3. Select one or more repositories
4. Click Add Selected Repositories

Or add manually by entering owner/repo (e.g., LonoxX/obsidian-github-issues).

2. Configure Tracking

For each repository, you can enable:

Option	Description
Track Issues	Create notes for issues
Track Pull Requests	Create notes for PRs
Include Closed	Also track closed items
Include Comments	Add comments to notes

3. Sync

Click the GitHub sync icon in the ribbon or use the command palette:

• Sync GitHub issues & pull requests

Filtering

Label Filters

Only track issues/PRs with specific labels:

Mode	Behavior
Include	Only items with these labels
Exclude	All items except those with these labels

Example: Track only bugs and features:

• Enable label filter
• Mode: Include
• Labels: bug, enhancement

Assignee Filters

Filter by who the item is assigned to:

Mode	Behavior
Assigned to me	Items assigned to the token owner
Assigned to specific	Items assigned to specific users
Unassigned	Only unassigned items
Any assigned	All items with any assignee

Update Modes

Control how existing notes are updated when the GitHub item changes:

Mode	Behavior
None	Never update existing files
Update	Replace content (preserves Persist-Blocks)
Append	Add new content to the end

Automatic Cleanup

When enabled, closed items are automatically deleted after a configurable period (default: 30 days).

• Set the cleanup period in Sync-Settings
• Override per-file with allowDelete: false in frontmatter

Example Workflow

1. Morning: Open Obsidian, automatic sync fetches latest issues
2. During work: Link issues to your daily notes using [[Issue - 123]]
3. Add notes: Write your own content in Persist-Blocks
4. Evening: Background sync keeps everything current

Related

• Repository-Settings - Detailed configuration options
• Sync-Settings - Sync intervals and cleanup
• Markdown-Notes - Note templates and formatting