Obsidian Dashboard Manager

A Python tool that creates and maintains intelligent knowledge dashboards within your Obsidian vault. Uses Parallax AI to analyze your notes individually and builds up a contextual understanding over time.

Features

Folder-Specific Dashboards: Creates individual Dashboard.md files for each folder (non-recursive)
AI-Extracted Tasks: Automatically extracts actionable todos from your notes using AI
Task Completion Awareness: Uses existing dashboard context to avoid suggesting completed tasks
Smart Deduplication: Prevents duplicate todos and summaries when reprocessing
Root-Level Isolation: Root directory processing doesn't traverse into subfolders
Fallback Mode: Works even when Parallax AI is unavailable, providing basic file analysis
Obsidian Integration: All summaries and links work natively in Obsidian
Command Line Interface: Simple CLI for processing specific folders

Installation

Install Python dependencies:

pip install -r requirements.txt

Ensure Parallax is running locally or configure remote endpoint

Usage

Basic Commands

# Validate an Obsidian vault
python3 obsidian_dashboard.py validate /path/to/obsidian/vault

# Process specific folder (creates Dashboard.md in that folder)
python3 obsidian_dashboard.py process /path/to/obsidian/vault --folder "Projects"

# Process root folder only (doesn't traverse subfolders)
python3 obsidian_dashboard.py process /path/to/obsidian/vault --folder ""

# Reset dashboard for a specific folder
python3 obsidian_dashboard.py reset /path/to/obsidian/vault --folder "Projects"

# Watch for changes (not yet implemented)
python3 obsidian_dashboard.py watch /path/to/obsidian/vault

Configuration

Copy env-template.txt to .env and update values as needed:

cp env-template.txt .env

Then edit the .env file:

# Parallax server endpoint (defaults to localhost)
PARALLAX_ENDPOINT=http://localhost:3001/v1/chat/completions

# Optional: API keys, timeouts, etc.

How It Works

Folder-Focused Processing: Processes only immediate files in a specified folder (non-recursive)
Per-Folder Dashboards: Creates individual Dashboard.md files for each processed folder
AI-Extracted Tasks: Automatically extracts actionable todos from note content using AI
Context Awareness: Uses existing folder dashboard as context to avoid duplicate/completed tasks
Task Preservation: Existing todos are preserved when reprocessing the same folder
Fallback Mode: When Parallax is unavailable, provides basic file analysis

Dashboard Structure

The system creates individual Dashboard.md files in each processed folder:

# Projects Dashboard

## 📋 AI-Extracted Tasks
- [ ] AI-suggested todos from content analysis
- [ ] Actionable items extracted from folder notes

## 📄 File Summaries
### [[Requirements]]
**Summary:** AI-generated summary of the file
**Key Points:**
- Extracted key points
- Actionable insights

Key Changes from Previous Version:

No manual todo management - todos are AI-extracted only
Per-folder dashboards - each folder gets its own Dashboard.md
Task completion awareness - AI considers existing dashboard context
No recursive processing - only processes immediate files in specified folder

Requirements

Python 3.8+
Access to Parallax AI server (local or remote)
Obsidian vault with markdown files

Development

The system is designed to be:

Privacy-focused: All processing happens locally
Incremental: Only processes changed files
Context-aware: Uses dashboard history for better analysis
User-controlled: Manual todo management influences AI behavior

Troubleshooting

Connection Issues: Ensure Parallax server is running and accessible
File Encoding: All files should be UTF-8 encoded
Large Vaults: Process in smaller folder batches to avoid timeouts
Memory Usage: Monitor for large vault processing

Obsidian_Dashboard