Life Log
Sahil A23 downloadsRecord atomic life events as Markdown files. A personal timeline of your life.
- Overview
- Scorecard
- Updates1
A fast, minimal Obsidian plugin for recording life events as Markdown files. Not a journal. Not a habit tracker. A timeline of things that happened to you.
What is Life Log?
Life Log lets you capture atomic life events — trivial and significant — as individual Markdown files with YAML frontmatter. Think of it as a personal Git history of your life.
Examples:
- Went for a morning walk
- Finished reading a book
- Had a strange dream last night
- Tried a new recipe
- Found a new favorite song
- Finished a book
- Started a new job
Every event is an independent Markdown file. Everything is portable, future-proof, and Git-friendly.
Features
- Instant capture — Open the command palette, type, press Enter. Event saved in ~3 seconds.
- Timeline view — Year → Month → Day grouping, newest first, in the sidebar.
- Search — Case-insensitive instant filtering by title.
- Today in history — See what happened on this day in past years.
- Event types — Health, Dream, Travel, Career, Purchase, Food, Exercise, Book, Movie, Relationship, Other.
- Markdown-first — Every event is a
.mdfile with YAML frontmatter. No databases, no lock-in.
Installation
From GitHub Releases (recommended)
- Download
main.js,manifest.json, andstyles.cssfrom the latest release. - Create a folder
life-loginside your vault's.obsidian/plugins/directory. - Copy the three files into that folder.
- Enable Life log in Settings → Community plugins.
Manual
Copy main.js, manifest.json, and styles.css to:
<Vault>/.obsidian/plugins/life-log/
Usage
Creating an event
- Open the Command Palette (
Ctrl/Cmd + P). - Run New event.
- Type what happened.
- Press Enter.
That's it. A permanent Markdown file exists in your vault.
Optional details
Click Optional details in the modal to set:
- Occurred — When it actually happened (defaults to now).
- Type — Category of the event.
- Tags — Comma-separated tags.
- Notes — Additional context.
Timeline
The Life Log Timeline sidebar shows all events grouped by year, month, and day. Click any event to open its file.
Today in history
If enabled in settings, the sidebar shows events from this calendar day in past years.
Settings
| Setting | Description | Default |
|---|---|---|
| Storage folder | Where event files are stored | Life Log |
| Default event type | Type assigned to new events | Other |
| Today in history | Show historical events in sidebar | On |
File structure
Events are stored as:
Life Log/
2026/
2026-07-22-153501-first-coffee-of-the-day.md
2026-07-22-190210-went-for-a-morning-walk.md
Each file contains YAML frontmatter:
---
id: 01HXM7S4C8N9
title: First coffee of the day
occurred: 2026-07-22T08:15:00+05:30
created: 2026-07-22T21:04:13+05:30
type: Travel
tags: []
---
Development
Prerequisites
- Node.js 18+
- npm
Setup
git clone https://github.com/sahilium/obsidian-life-log.git
cd obsidian-life-log
npm install
Commands
| Command | Description |
|---|---|
npm run dev |
Start watch mode (rebuilds on file changes) |
npm run build |
Production build |
npm run test |
Run tests with Vitest |
npm run test:coverage |
Run tests with coverage report |
npm run lint |
Lint with ESLint |
Testing
npm run test
Tests cover utility functions, search logic, and file serialization. Run with coverage:
npm run test:coverage
Coverage reports are uploaded to Codecov on CI.
Contributing
See CONTRIBUTING.md for guidelines.
Security
See SECURITY.md for reporting vulnerabilities.
Changelog
See CHANGELOG.md.