session-manager

Session Manager

Manage metadata for the current active session's session.md file via Obsidian CLI.

Deriving the Session Path

The session docs path is injected into your system prompt by the SessionStart hook. It looks like:

Session docs path: {KB_PATH}/_sessions/2026-03-04/abc123-def456/docs/

To get the session.md vault-relative path for Obsidian CLI:

1. Take the injected docs path
2. Find _sessions/ in it — everything from _sessions/ onward is vault-relative
3. Remove the trailing docs/ and append session.md

Example:

• Injected: .../knowledge-bank/_sessions/2026-03-04/abc123-def456/docs/
• Vault-relative session.md: _sessions/2026-03-04/abc123-def456/session.md

If the session docs path is not in your system prompt, ask the user for the session folder path.

Properties You Can Update

Property	Type	Purpose
session_name	text	Session name (auto-synced from /rename customTitle on invocation)
project	text	Project name (auto-set from cwd at session start, customizable)
tags	list	Freeform categorization (e.g., brainstorming, debugging, architecture)
summary	text	One-line description of what the session accomplished

Do NOT modify other frontmatter properties (session_id, date, cwd, etc.) — those are managed by hooks.

Commands

Set a property:

obsidian vault="knowledge-bank" property:set name="<property>" value="<value>" [type="list"] path="<vault-relative-path>"

Read current metadata:

obsidian vault="knowledge-bank" read path="<vault-relative-path>"

Tag Suggestion Workflow

When the user wants to set tags, do NOT set them directly. Instead, suggest existing tags to promote consistency.

Step 1: Load existing tags

Read from ccfind's cache (field 5, comma-separated):

CACHE="${XDG_CACHE_HOME:-$HOME/.cache}/ccfind/sessions.tsv"
cut -f5 "$CACHE" 2>/dev/null | tr ',' '\n' | sed 's/^ *//;s/ *$//' | grep -v '^-$' | grep -v '^$' | sort -u