Skip to content

obsidian: support existing vaults and rename Concepts to Knowledge - #21

Merged
krishna-bala merged 2 commits into
mainfrom
krishna.obsidian.existing-vaults-and-knowledge
Sep 24, 2026
Merged

krishna-bala merged 2 commits into
mainfrom
krishna.obsidian.existing-vaults-and-knowledge

Conversation

@krishna-bala

@krishna-bala krishna-bala commented Sep 23, 2026 •

Copy link
Copy Markdown
Owner

Summary

Follow-up to #20, from running seed-vault on an existing vault on a new machine.

  1. Seeding a vault that already had .obsidian/ skipped every settings file, so vim mode, hotkeys and the plugin list never took effect. The pack's settings files (.obsidian/*.json, the snippet, per-plugin data.json, .obsidian.vimrc) are now reset on every run. A file that differs is backed up to ~/.local/state/seed-vault/<vault>-<timestamp>/ first. Settings the pack does not ship (workspace.json, other plugins) are left alone, and AGENTS.md, Home.md and .gitignore are still only added when missing.
  2. The script refuses to run while Obsidian is open, since Obsidian writes its in-memory settings back over the new files.
  3. Folders are capitalized: Projects/, Knowledge/, References/, Archive/, Templates/ and _Inbox/. Concepts/ is renamed to Knowledge/, and attachments/ and references/people/ are gone (attachments go next to the note). Templater, the new-note location, Home.md and AGENTS.md use the new names.
  4. The README says plugins only appear after they are installed from the community browser, which the pack does not do.

Testing

  • Fresh directory: new folder layout created, settings point at _Inbox and Templates.
  • Existing vault with a differing app.json: backed up and replaced.
  • Existing vault with its own workspace.json and AGENTS.md: both left alone.
  • Re-run: only [skip] lines.
  • shellcheck -S warning passes.

🤖 Generated with Claude Code

Seeding a vault that already had an .obsidian/ skipped every settings
file, so vim mode, hotkeys and the plugin list never took effect. The
pack's settings files and .obsidian.vimrc are now reset on every run: a
differing file is backed up under $XDG_STATE_HOME/seed-vault/ and
replaced. Settings the pack does not ship are left alone, and starter
content (AGENTS.md, Home.md, .gitignore) is still only added when
missing. The script refuses to run while Obsidian is open, since
Obsidian would write its in-memory settings back over the new files.

Folders are now Concepts, Projects, References, Archive, Templates and
_Inbox. attachments/ and references/people/ are gone; attachments go
next to the note again.

The README says plugins only appear after they are installed from the
community browser, which the pack does not do.
Knowledge/ reads better than Concepts/ for notes you worked out
yourself (ideas, mental models, lessons), especially outside a theory
vault. References/ stays for information recorded from outside, and
AGENTS.md's filing test now names all three folders.
@krishna-bala
krishna-bala force-pushed the krishna.obsidian.existing-vaults-and-knowledge branch from 4df2989 to a6c3fbf Compare September 23, 2026 21:45
@krishna-bala krishna-bala changed the title obsidian: support existing vaults and simplify the folder layout obsidian: support existing vaults and rename Concepts to Knowledge Sep 23, 2026
@krishna-bala
krishna-bala merged commit 943103c into main Sep 24, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant