Pensio353 downloadsSync your journal to Pensio for AI-powered journaling insights: emotion and mood tracking, relationship mapping, and weekly reflections on your notes.
Sync your journal to Pensio for AI-powered journaling insights: emotion and mood tracking, relationship mapping, and weekly reflections on your notes.
Available in the Obsidian Community Plugins directory. Install it in a couple of clicks (see Installation). Questions or a bug? Open an issue.
Required disclosures (per Obsidian developer policies):
- Account required — A free Pensio account is needed.
- Network use — This plugin sends journal content from your configured sync folders to Pensio servers (
pensio.app) over HTTPS. Data is used for storage, AI-based emotion analysis, and insight generation. No data leaves your device until you explicitly connect and configure folders.- Privacy — See Pensio Privacy Policy.
Pensio is an AI-powered journaling platform. Write naturally — Pensio automatically extracts 60+ emotions, generates weekly & monthly insights, tracks relationships mentioned in your writing, and provides an AI advisor (Explore) that can answer questions about your entire journal history.
This plugin connects your Obsidian vault to Pensio so you can keep writing in your favorite editor while Pensio adds the intelligence layer on top.

Or open the directory listing and use "Install".
Want the newest build before it reaches the directory? Install BRAT, choose Add beta plugin, and enter gabrielrubens/pensio-obsidian-sync.
main.js, manifest.json, and styles.css from the latest release.obsidian/plugins/pensio-sync/ in your vaultJournal); each row has its own delete buttonAuto-sync is on by default. Entries sync as you write.
Self-hosting or prefer raw tokens? Manual access/refresh token entry lives under Advanced.
Access via Command Palette (Ctrl/Cmd + P):
| Command | Description |
|---|---|
| Sync now | Incremental sync (only changed files) |
| Force sync all files | Re-check all files (still skips unchanged content) |
| Sync current file | Sync only the active file |
| Check sync status | Show server entries and local tracked files |
| Disconnect from Pensio | Stop this vault's connection on Pensio, then clear tokens and sync state here |
The plugin reads YAML front matter to determine entry type, date, and title.
Entry type — recognized keys: type, entry_type. Frontmatter type overrides the default folder type.
| Frontmatter value | Maps to |
|---|---|
daily_journal, daily, journal |
Daily Journal |
prompted_journal, prompted |
Prompted Journal |
deep_dive, deep dive |
Deep Dive |
meeting_note, meeting |
Meeting Note |
other |
Other |
| (anything else) | Other |
Date — recognized keys (in priority order): date, created, created_at, entry_date. Falls back to file modification time if not present.
Title — extracted from the title frontmatter key, falling back to the filename.
Example:
---
type: deep_dive
date: 2025-03-18
title: My reflection on change
---
Frontmatter is metadata, not writing. Pensio keeps it alongside the entry; word counts and Pensio's AI read only what you wrote under it.
An empty note is not an entry. A note with nothing written under its frontmatter (a new blank note, a template that is only properties) stays in your vault and becomes an entry the first time it has words.
Only .md files in your configured sync folders are sent. Everything else stays local.
Besides journal entries, the plugin can sync relationship notes from a dedicated People folder (default: People/).
Create a markdown file per person:
People/
├── Sarah.md
├── David.md
└── Mom.md
Each file becomes a relationship profile on Pensio, named after the file — the same name your [[links]] to it use. A title property is not used for the name; put any other names in aliases. You can add any notes about the person in the file body.
Add a relationship field to categorize the person:
---
relationship: close_friend
birthday: 1990-05-15
aliases:
- Sar
tags:
- college
- roommate
---
Notes about Sarah...
aliases are other names for the person: with the note above, [[Sar]] in a journal entry's text links to Sarah.
Accepted relationship values: partner, family, close_friend, friend, coworker, professional, acquaintance, other. Legacy formats (e.g., 1:👪 Family, Friend) are normalized automatically on sync.
When you mention someone in a journal entry using an Obsidian wiki-link — the person's note name (or one of their aliases) wrapped in double square brackets — Pensio links that mention to their relationship profile. A wiki-link in the text only links someone who already exists. To create a person from an entry, list them under People: in the entry's frontmatter:
---
People:
- "[[Sarah]]"
---
How a note's aliases: behaves on sync:
aliases: Em.aliases: []. Leaving the key out changes nothing, so aliases you added on the web stay.Set the People folder in Settings → Pensio Journaling Sync, just below the journal folders, beside Auto-sync. Leave it empty to turn people sync off.
Once your entries sync, Pensio processes them automatically:
All of this happens on the web — your markdown files in Obsidian stay untouched.
| What | Details |
|---|---|
| Transport | All communication over HTTPS |
| Authentication | Connect to Pensio (approved in your browser, PKCE) or a one-time setup code → per-device JWT family; short-lived access tokens, refresh tokens renewed automatically (sliding reissue) |
| Token storage | Obsidian SecretStorage, write-verified — backed by the OS keychain on desktop; app-local (never inside your vault files, never synced with the vault) on mobile. Each vault keeps its own, under its own name |
| What stays on each device | The vault's device id and its sync history, never in the synced data.json, which holds only your settings |
| Data sent | Markdown content, file paths, timestamps from configured folders only |
| Data NOT sent | Files outside sync folders, .obsidian config, plugin settings, vault structure |
| Max note size | About 2 MB of text per note. A larger note is named on the status card and not synced |
For a full overview of the plugin and Pensio's features, see the Obsidian Sync feature page.
https://