musingfox/init

init

Initialise the project's Obsidian Workspace configuration and seed starter templates.

Execution

1. Handle existing config — if .obsidian.yaml exists in the project root, show a one-line summary (vault name + project) and ask whether to overwrite.

2. Pick a vault — list vaults from Obsidian's config and ask the user:

   cat ~/Library/Application\ Support/obsidian/obsidian.json \
     | jq -r '.vaults | to_entries[] | "\(.key)\t\(.value.path)"'
   

   (Linux: ~/.config/obsidian/obsidian.json; Windows: %APPDATA%\obsidian\obsidian.json.) Resolve $VAULT_PATH from the chosen entry.

3. Ask config options (via AskUserQuestion):

   • Project identifier for /obw:pm? (default = current directory basename; allow "skip" to omit the pm section)
   • Default folder for /obw:note? (default Inbox)
   • Filename strategy for /obw:note? options: title / slug / timestamp-title

   Mention: daily note folder / filename / template are configured in Obsidian's Daily Notes core plugin, not here. /obw:cap always prepends HH:MM and writes #tag tokens inline (Obsidian indexes them automatically).

4. Install starter templates — read the Templates folder from $VAULT_PATH/.obsidian/templates.json:

   TF=$(jq -r .folder "$VAULT_PATH/.obsidian/templates.json" 2>/dev/null)
   

   • If .obsidian/templates.json is missing → tell the user to enable the Templates core plugin in Obsidian, then re-run /obw:init. Stop.
   • Empty TF means vault root; otherwise mkdir -p "$VAULT_PATH/$TF".
   • For each of task.md, doc.md, adr.md:

     [ -e "$VAULT_PATH/$TF/task.md" ] || cp "${CLAUDE_PLUGIN_ROOT}/templates/task.md" "$VAULT_PATH/$TF/task.md"
     

     Never overwrite existing templates. Do not read template contents into the conversation — cp is enough.

5. Write .obsidian.yaml using the template below. Omit the pm section if skipped.

6. Offer .gitignore entry — ask whether to add .obsidian.yaml to .gitignore.

Config Template

# Obsidian Workspace configuration
vault: <VAULT_NAME>

note:
  default_folder: Inbox
  filename_strategy: title    # title | slug | timestamp-title

pm:
  project: <PROJECT_NAME>

Confirmation Output

Return a summary in this shape:

.obsidian.yaml created (vault=<NAME>, project=<PROJ>).
Templates installed to <TF>/: task.md, doc.md, adr.md (only the missing ones).

Next:
  /obw:cap <text>        — quick capture to today's daily note
  /obw:note <title>      — create a long-form note
  /obw:pm                — task / doc / ADR management