Incident.io Periodic Note Sync
jamesjarvis14 downloadsSync on-call status and active incidents from incident.io to your periodic notes.
- Overview
- Scorecard
- Updates5
Sync on-call status and incidents from incident.io to Obsidian daily notes.
Features
- On-call schedule status in daily notes
- Active incidents you're leading or assigned to
- Individual incident note files with full details:
- Summary, overview table, timestamps
- Roles and custom fields
- Full timeline with status/severity changes
- Actions and follow-ups with checkboxes
- Attachments (GitHub PRs, Datadog dashboards, etc.)
- Auto-sync at configurable intervals (1/5/10/30/60 min)
- Historical backfill support (up to 90 days)
- Wikilinks from daily notes to incident files
- Secure API key storage using Obsidian's SecretStorage API
Installation
Manual Installation
- Download the latest release (
main.js,manifest.json,styles.css) - Create folder:
.obsidian/plugins/incident-io-sync/ - Copy files into the folder
- Enable the plugin in Obsidian settings
BRAT (Beta Reviewers Auto-update Tester)
- Install the BRAT plugin
- Add this repository:
jamesjarvis/obsidian-incident-io-periodic-sync - Enable the plugin
Setup
- Get your API key from incident.io settings
- Enter the API key in the plugin settings
- Enter your user identifier (email substring or name to match your user)
- Click "Test Connection" to verify
Daily Note Format
The plugin adds an Incidents section to your daily notes:
## Incidents
### On-Call
- On-call for: Primary, Secondary
### Active Incidents
- [[Incidents/INC-123|INC-123: Database outage]]
Incident Note Format
Creates individual files like Incidents/INC-123.md with:
- YAML frontmatter (id, reference, status, severity, dates)
- Overview table (status, severity, lead, created, resolved)
- Timestamps (detected, acknowledged, mitigated, resolved)
- Roles and custom fields
- Full timeline of updates
- Actions with completion checkboxes
- Follow-ups with completion status
- Attachments as links
Settings
| Setting | Description | Default |
|---|---|---|
| API Key | Your incident.io API key | - |
| User Identifier | Email/name substring to match your user | - |
| Section Header | Markdown header for incidents | ## Incidents |
| Incident Notes Folder | Where to create incident files | Incidents |
| Show On-Call Status | Include on-call status section | true |
| Show Incidents | Include incidents section | true |
| Omit Empty Sections | Hide sections when empty | false |
| Auto-Sync Enabled | Enable background syncing | true |
| Sync Frequency | How often to auto-sync | 5 minutes |
| Historical Sync Days | Sync incidents from past N days | 0 |
| Update Previous Daily Notes | Backfill historical daily notes | false |
Development
Building from Source
npm install
npm run build
Running Tests
npm run test # Run tests once
npm run test:watch # Run tests in watch mode
Running Lints
npm run lint
License
MIT License - see LICENSE for details.
HealthExcellent
ReviewRisks
About
Sync on-call status and active incidents from incident.io into Obsidian daily notes, showing who's on call and linking incidents you're leading or assigned. Create detailed incident files with metadata, overview table, timestamps, full timeline, actions/follow-ups with checkboxes, attachments, auto-sync and historical backfill.Details
Current version
1.0.4
Last updated
6 months ago
Created
6 months ago
Updates
5 releases
Downloads
14
Compatible with
Obsidian 1.10.0+
Platforms
Desktop only
License
MIT