obsidian-vault-bootstrap

# Obsidian Vault Bootstrap Bootstrap reusable Obsidian LLM Wiki vaults for personal or project knowledge bases. This repository contains a single Codex-compatible skill that creates an Obsidian vault scaffold with: - `AGENTS.md`, `index.md`, and `log.md` - a `wiki/` layout for durable knowledge pages - a `raw/` layout for immutable source material - optional `qmd` collection setup - optional copying of the Obsidian Local REST API plugin from another vault The core idea is to treat the vault as markdown-first. Obsidian MCP is optional, not required. ## Requirements Required: - `python3` - permission to create files in the target vault path Optional: - `qmd` if you want search collection setup during bootstrap - Obsidian desktop if you want to open the vault in the app - an existing vault with `obsidian-local-rest-api` installed if you want to copy that plugin with `--copy-rest-plugin-from` - Azure DevOps org/project names if you want those values written into the generated wiki Not required: - Azure DevOps MCP - GitHub MCP - Obsidian MCP `--ado-org` and `--ado-project` only write metadata into markdown pages. They do not connect to Azure DevOps. ## Install Install from GitHub with the `skills` CLI: ```bash npx skills add https://github.com/matheusflc/obsidian-vault-bootstrap -g -a codex -y ``` You can also try: ```bash npx skills add matheusflc/obsidian-vault-bootstrap -g -a codex -y ``` ## Use Ask Codex to use the skill explicitly: ```text Use $obsidian-vault-bootstrap to create an Obsidian LLM Wiki vault for this project. ``` Or run the bundled bootstrap script directly: ```bash python3 ~/.codex/skills/obsidian-vault-bootstrap/scripts/bootstrap_vault.py \ --vault-path "/path/to/new-vault" \ --kind project \ --project-name "Example Project" \ --repo "/path/to/repo-a" \ --repo "/path/to/repo-b" ``` ## What It Creates - root schema files: `AGENTS.md`, `index.md`, `log.md` - `.obsidian/app.json` with attachments under `raw/assets` - source folders under `raw/` - maintained knowledge folders under `wiki/` - initial overview, source, analysis, and operations pages For project vaults, it also creates: - `wiki/overview/System Snapshot.md` - `wiki/overview/Repository Map.md` - one `wiki/systems/*.md` page per supplied repository ## Notes - `qmd` is used when installed locally and can be skipped with `--skip-qmd` - embeddings can be skipped with `--skip-embed` - the Obsidian REST plugin can be copied with `--copy-rest-plugin-from` - the script aborts on non-empty target directories unless `--force` is used ## Repository Layout ```text . ├── README.md ├── SKILL.md ├── agents/ │ └── openai.yaml └── scripts/ └── bootstrap_vault.py ```