Obsidian Vault Activity

Vault Activity tracks streaks, trends, and click-through note lists to answer one useful question:

"Am I actually revisiting and updating my notes, or just collecting them?"

Vault Activity is an Obsidian plugin that tracks note creation and revision activity, then turns it into a dashboard you can scan in seconds.

Why this plugin exists

The primary goal is to make note capture and maintenance visible. Vault Activity helps you answer whether you are revisiting and refining ideas over time by surfacing:

• Current and longest streaks tied to real note activity
• Most active weekday and rhythm summary to reveal your editing patterns
• Trend charts across weekly, monthly, yearly, and all-time windows
• Drill-down note lists behind each chart point to see which notes are behind the activity

[!NOTE] If you follow Zettelkasten, it is easy to over-indulge on collecting fleeting notes and under-invest in linking and refining existing ideas. Vault Activity helps you keep both sides in balance so your system keeps compounding.

Features

1) Dashboard widgets at a glance

• Streak stats and activity highlights
• Weekly, monthly, yearly, and all-time trends
• Metric toggle between New notes and Modified notes

2) Drill-down details

• Weekly and monthly: click a day to list matching notes
• Yearly and all-time: click a week or month to inspect grouped notes

3) Flexible configuration to suit your vault

• Tune conditions for streaks and summary stats
• Use your note metadata by configuring frontmatter keys for created and modified timestamps
• Set Include and Exclude folder filters to ensure you get the most relevant insights for your workflows

Usage

Commands

• Open Vault Activity
• Refresh Vault Activity data

Obsidian settings

Setting	What it does	Default
Dashboard include folders	Optional allow-list scope for dashboard widgets and note lists	Empty
Dashboard exclude folders	Exclude scope used when include list setting is empty	Templates
Streak calculation mode	Choose what marks a day active	new-and-modified
Created date property	Frontmatter (property) key for new-note timestamps	Date
Modified date property	Frontmatter (property) key for modified-note timestamps	Last modified
Auto-refresh	Recompute on create, modify, delete, and rename events	true
Refresh debounce (ms)	Delay before recomputing after events	400

Important behavior notes

[!IMPORTANT] Obsidian provides the current modified time for files, not a full historical timeline of every edit event. The dashboard represents each note's latest known activity position, not a complete per-edit history.

Privacy

Vault Activity is local-first. 🔒

• No external analytics
• No remote data sync by this plugin
• Data is stored in Obsidian plugin storage for local snapshots and settings

Development

Scripts

npm run dev            # watch/dev build
npm run build          # production build
npm run lint           # eslint
npm run test           # vitest
npm run test:coverage  # vitest with coverage
npm run format         # prettier

Tech stack & tools

Roadmapped improvements

• Handle wider date format compatibility for frontmatter date fields
• Improve determination of 'modified' notes.
• Suggest inactive notes for review, updating or deletion

Author

Built by daniegee with GitHub Copilot

If Vault Activity helps your writing cadence, drop a star and keep the streak alive. 📈