wiki-setup

1# Obsidian Setup — Vault Initialization
2 
3You are setting up a new Obsidian wiki vault (or repairing an existing one).
4 
5## Step 1: Create .env
6 
7If `.env` doesn't exist, create it from `.env.example`. Ask the user for:
8 
91. **Where should the vault live?** → `OBSIDIAN_VAULT_PATH`
10   - Default: `~/Documents/obsidian-wiki-vault`
11   - Must be an absolute path (after expansion)
12 
132. **Where are your source documents?** → `OBSIDIAN_SOURCES_DIR`
14   - Can be multiple paths, comma-separated
15   - Default: `~/Documents`
16   - Local git repo clones (public or private, any host) can be listed here too — clone
17     the repo locally first, then add its path. See "Ingesting Git Repositories" in
18     `wiki-ingest/SKILL.md` for how repo sources are handled.
19 
203. **Want to import Claude history?** → `CLAUDE_HISTORY_PATH`
21   - Default: auto-discovers from `~/.claude`
22   - Set explicitly if Claude data is elsewhere
23 
244. **Have QMD installed?** → `QMD_WIKI_COLLECTION` / `QMD_PAPERS_COLLECTION` / `QMD_TRANSPORT`
25   - Optional. Enables semantic search in `wiki-query` and source discovery in `wiki-ingest`.
26   - Default to `QMD_TRANSPORT=mcp` unless the user wants the agent to call the local `qmd` CLI directly.
27 
285. **Which timezone should the wiki's timestamps use?** → `timezone:` in `index.md` (not `.env`)
29   - Optional. An IANA name such as `America/Detroit`; blank means UTC in the `Z` spelling.
30   - Lives in the vault so it applies to every writer (CLI, server, Python API) and travels with it.
31…