Why Obsidian + AI?
Obsidian is the best journaling environment for people who care about data ownership. Your entries are plain markdown files. No proprietary format. No cloud lock-in. Your data lives on your filesystem.
But Obsidian alone can't analyze your entries for emotional patterns, track relationship dynamics, or surface insights across months of writing. That's where Pensio comes in.
How It Works
Pensio connects to your Obsidian vault through a plugin. Here's the flow:
- You write in Obsidian — same workflow, same files, same folders
- The plugin syncs entries to Pensio (encrypted in transit)
- AI processes each entry — extracting emotions, themes, relationships
- Intelligence flows back — available through the web UI or the Explore chat
Your markdown files never change. Pensio adds a layer of intelligence on top of your existing vault.
Setting Up in 5 Minutes
Step 1: Install the Plugin
In Obsidian, go to Settings → Community Plugins → Browse → search for "Pensio" → Install → Enable.
Step 2: Connect Your Account
Open the plugin settings and enter your Pensio URL and API credentials. The plugin will verify the connection.
Step 3: Configure Your Journal Folder
Tell the plugin which folder contains your journal entries. Most people use Journals/ or Daily Notes/.
Step 4: Initial Sync
Click "Sync Now" to push your existing entries. The plugin will sync all markdown files in your configured folder. Depending on the size of your vault, this may take a few minutes.
Step 5: Start Exploring
Open the Pensio web UI and navigate to Explore. You can now ask questions about your journal:
- "What have I been stressed about this month?"
- "Show me entries where I mention Sarah"
- "What patterns do you see in my emotional state over the last 3 months?"
What Gets Synced
- Entry content: The full markdown text of each entry
- Frontmatter: Any YAML frontmatter (date, tags, mood, etc.)
- @Mentions:
@PersonNamereferences are extracted as relationships
What does NOT get synced:
- Attachments (images, PDFs)
- Non-journal files
- Obsidian settings or plugins
Ongoing Sync
After the initial sync, the plugin monitors your journal folder for changes. New entries and edits sync automatically in the background. You don't need to do anything — just keep writing.
Your Data, Your Control
A few important things about data ownership:
- Your markdown files never change — the plugin only reads from your vault
- You can export anytime — entries synced from Obsidian are standard markdown
- You can delete your data — one click removes everything from Pensio servers
- Self-hosting is on the roadmap — for users who want full infrastructure control
Beyond Basic Sync: People Tracking
Pensio automatically tracks the people in your journal. Write Had lunch with @Sarah and the AI knows Sarah is someone in your life, tracks how often she appears, and can tell you how your emotional state correlates with entries that mention her. Obsidian users can also use [[wikilink]] syntax.
What About Other Obsidian AI Plugins?
There are other Obsidian plugins that add AI capabilities. Most of them work by sending your vault contents to an LLM via RAG (retrieval-augmented generation) — essentially keyword search on text chunks.
Pensio is different. Instead of searching raw text, it extracts structured intelligence: emotions, themes, relationships, intensity scores. The AI navigates this structure to find patterns that text search would miss.
Think of it this way: other plugins give you AI-powered search. Pensio gives you AI-powered understanding.
Already using Obsidian? Install the Pensio plugin and add AI intelligence to your journal in 5 minutes.