Home Documentation

Progress Note 2026-03-05

Session with Claude (Sonnet 4.6) covering SSH authentication setup with 1Password, documentation of authentication modes, account strategy planning, and restructuring of the A30 section.

Work Done

Completed and verified SSH authentication architecture using 1Password as the sole key agent across Mac, Raspberry Pi hosts, and GitHub. See the reference doc:

[SSH Authentication Setup](../SSH Authentication Setup.md)

Changes made to the Mac:

  • ~/.zprofile — added SSH_AUTH_SOCK export pointing to 1Password agent socket
  • ~/.ssh/config — added IdentityAgent globally, ForwardAgent yes on all RPi hosts, Host github.com stanza; removed id_rsa from IdentityFile; set AddKeysToAgent no

Documentation restructuring

The A30-Architectural Decisions section is being phased out in favour of plain-language service descriptions in 40-Services. ARD01–06 moved to _system/archive/ for reference until any remaining useful content is migrated. ARD07 (account strategy — still open) moved to A20-MetaDoc/ as a working planning document.

New and updated service pages:

  • 40-Services/Docker.md — created, content from ARD03
  • 40-Services/DropBox.md — filled from ARD05
  • A20-MetaDoc/SSH Authentication Setup.md — expanded to cover all three 1Password auth modes (SSH agent, op CLI interactive, op CLI service account)

Still to do in 40-Services:

  • Github.md — stub, needs content
  • 1Password.md — has content; consider adding a pointer to the auth setup doc
  • Internal services (n8n, Home Assistant, etc.) — stubs exist in index, need pages

Verified Working

  • Mac → RPi (all hosts) via 1Password agent
  • Mac → GitHub SSH auth (sshkey.github)
  • RPi → GitHub via agent forwarding (no keys on the Pi)
  • VSCode git extension (required SSH_AUTH_SOCK fix in ~/.zprofile)

Session 2 — Vault and Quartz improvements

GitHub service page

Wrote 40-Services/Github.md (#27) — what GitHub is, what we use it for, how to access it, troubleshooting the build pipeline. Added links to Cloudflare and 1Password pages.

Markdownlint

Disabled MD045 (alt text requirement) in doc/.markdownlint.json.

Folder note convention — long story

Attempted to switch from FolderName/index.md to FolderName/FolderName.md to improve Obsidian drag-and-drop link display text (which was showing “index” instead of the page title).

Discovered that Quartz only recognises index.md as the content for a folder’s page — FolderName.md gets a different URL and Quartz serves an auto-generated listing instead. Reverted to index.md convention.

Solved the Obsidian display problem with the Front Matter Title community plugin, which makes Obsidian use the title front matter property everywhere, including drag-and-drop link text. Enabled and confirmed working.

In the process, all folder note title values were cleaned up (removed numeric prefixes like "3. Areas" → "Areas").

Quartz Explorer left nav

Configured quartz.layout.ts Explorer component:

  • Custom sortFn sorts by slugSegment (the raw folder name e.g. 40-Services) so numeric prefix ordering is always preserved regardless of display name transformations
  • mapFn strips the prefix from display names (e.g. 40-Services → Services) as a safety net for folders whose index.md title doesn’t already strip it
  • filterFn simplified to just hide the tags folder

Converted many wikilinks to standard Markdown links throughout the vault, and updated all folder note links to use meaningful display text (never “index”).

Graph View