obsidian-context

name: obsidian-context description: Bootstrap session context from an Obsidian PARA vault (~/ai-vault). Scans recent projects, active areas, and inbox items to ground the agent in current work. Use at the start of any session, when the user has no explicit context, when the user says "what am I working on", "load my vault", "get context", or when you need to understand the user's current priorities.

Obsidian Context

Load working context from ~/ai-vault (or any PARA-structured Obsidian vault) to orient the agent at session start.

When to Activate

• Session begins with no explicit project context
• User asks "what am I working on?" or "catch me up"
• Agent needs to understand current priorities before making suggestions
• User references vault content without specifying a path

Context Loading Workflow

1. Scan Active Projects

Read ~/ai-vault/01_Projects/README.md for the project index, then scan each project's README.md for its Active Focus section.

# Find recently modified project files (last 7 days)
find ~/ai-vault/01_Projects -name "*.md" -mtime -7 -not -path "*/Chats/*" | sort

For each active project, extract:

• Status (from callouts or frontmatter)
• Active Focus (current work stream)
• Key links (wikilinks to epics, designs, metrics)

2. Check the Inbox

ls -t ~/ai-vault/00_Inbox/*.md 2>/dev/null | head -5

If recent items exist, summarize them — they represent unprocessed thoughts that may inform the session.

3. Check Recent Chats

find ~/ai-vault/01_Projects -path "*/Chats/*.md" -mtime -3 | sort -r

Skim the most recent chat log per project for continuity. Look for Next Steps or Open Questions sections.

4. Scan Areas for Active Threads

Read ~/ai-vault/02_Areas/README.md. Only dive deeper if the user's question touches an area, or if an area file was recently modified.

5. Synthesize & Present

Present a concise context briefing:

## Current Context

### Active Projects
- **[Project A]**: [Status] — [Active Focus]
- **[Project B]**: [Status] — [Active Focus]

### Unprocessed Inbox
- [Item 1] — [one-line summary]

### Recent Sessions
- [Date] — [Project] — [What was discussed]

### Open Questions
- [Question from last session]

PARA Folder Map

Priority Heuristic

When multiple projects are active, rank by:

1. Recency — most recently modified files first
2. Inbox pressure — unprocessed items signal urgency
3. Open questions — unresolved threads from prior sessions

Integration

• Feeds into: obsidian-sync (knows where to write), obsidian-link (knows what to connect)
• Uses: obsidian-markdown for reading frontmatter and callouts