Obsidian Stats logoObsidian Stats

Vault Activity

by daniegee
5
4
3
2
1
Score: 35/100
Install Code

Description

This plugin has not been manually reviewed by Obsidian staff. Track your note activity stats with streak highlights and visualisation widgets.

Reviews

No reviews yet.

Stats

stars
41
downloads
0
forks
1
days
NaN
days
NaN
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
0
commits

Latest Version

Invalid date

Changelog

See all version on GitHub

README file from

Github

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.

alt text

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

alt text

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

alt text

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

TypeScript Node.js Obsidian Esbuild Vitest Prettier

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. 📈

Sponsors