Fastest way to scaffold your LLM powered personal knowledge base - Obsidian, Claude Code, qmd, Github
JavaScript aiampclaude-codecodexcursorgithubknowledge-baseknowledge-graphknowledge-managementllmobsidianobsidian-vaultqmdsecond-brain
release: v0.3.0 (#7)
jessepinkman99000d9e75a0722f
diff --git a/.claude/skills/pack-test/SKILL.md b/.claude/skills/pack-test/SKILL.mdindex fd3402d..ac18bf7 100644--- a/.claude/skills/pack-test/SKILL.md+++ b/.claude/skills/pack-test/SKILL.md@@ -1,12 +1,12 @@---name: pack-test-description: "Test the obsidian-agent-wiki npm package by packing it into a tarball and running it via npx. This is the definitive test — it catches npm's .gitignore stripping behavior and validates the full scaffold. Trigger phrases: /pack-test, test the package, test the CLI, test the tarball."+description: "Test the claude-second-brain npm package by packing it into a tarball and running it via npx. This is the definitive test — it catches npm's .gitignore stripping behavior and validates the full scaffold. Trigger phrases: /pack-test, test the package, test the CLI, test the tarball."argument-hint: "No arguments needed"---# Pack Test-Tests the npm package as it behaves when published. Uses `npx` to run from the local tarball — `bunx` doesn't support local tarball paths (it tries to resolve them as scoped package names). After publishing, `bunx obsidian-agent-wiki` from the registry works fine. Runs all steps, reports a checklist, then cleans up.+Tests the npm package as it behaves when published. Uses `npx` to run from the local tarball — `bunx` doesn't support local tarball paths (it tries to resolve them as scoped package names). After publishing, `bunx claude-second-brain` from the registry works fine. Runs all steps, reports a checklist, then cleans up.## Steps@@ -18,12 +18,12 @@ Run each command in order. Stop and report if any step fails.npm pack```-Produces `obsidian-agent-wiki-<version>.tgz` in the repo root, where `<version>` comes from `package.json`. Verify the tarball appears before continuing.+Produces `claude-second-brain-<version>.tgz` in the repo root, where `<version>` comes from `package.json`. Verify the tarball appears before continuing.**Step 2 — Scaffold via npx**```bash-npx -y obsidian-agent-wiki-$(node -p "require('./package.json').version").tgz test-vault+npx -y claude-second-brain-$(node -p "require('./package.json').version").tgz test-vault```Use `npx` with the `file:` prefix — without it, npx tries to execute the tarball as a shell script and fails with "Permission denied". Pass `test-vault` as the target dir argument to skip the interactive prompt. The vault is created in the repo root and cleaned up in Step 4.@@ -68,7 +68,7 @@ Report results against this checklist:```bashrm -rf test-vault-rm obsidian-agent-wiki-$(node -p "require('./package.json').version").tgz+rm claude-second-brain-$(node -p "require('./package.json').version").tgz```## What failure means@@ -76,4 +76,4 @@ rm obsidian-agent-wiki-$(node -p "require('./package.json').version").tgz- **`.gitignore.template` present instead of `.gitignore`** — npm stripped `.gitignore` from the tarball but the rename in `bin/create.js` didn't fire; check the `try/catch` rename block- **Missing skill dirs** — template copy failed or `.claude/` hidden dir wasn't included; check `npm pack --dry-run` output- **`npx` fails to run the bin** — shebang or `bin` field in `package.json` is wrong; check `#!/usr/bin/env node` on line 1 of `bin/create.js`-- **Note:** `bunx` cannot run local tarballs — use `npx` for this test. After publishing, `bunx obsidian-agent-wiki` from the registry works fine.+- **Note:** `bunx` cannot run local tarballs — use `npx` for this test. After publishing, `bunx claude-second-brain` from the registry works fine.diff --git a/.claude/skills/release/SKILL.md b/.claude/skills/release/SKILL.mdindex 99c7f82..b0743a3 100644--- a/.claude/skills/release/SKILL.md+++ b/.claude/skills/release/SKILL.md@@ -1,12 +1,12 @@---name: release-description: "Prepare and open a release PR for the obsidian-agent-wiki npm package. Analyzes changes vs main, suggests a semver version bump, updates package.json, commits, pushes, and opens a PR. Trigger phrases: /release, prepare a release, bump the version, publish a new version, open a release PR."+description: "Prepare and open a release PR for the claude-second-brain npm package. Analyzes changes vs main, suggests a semver version bump, updates package.json, commits, pushes, and opens a PR. Trigger phrases: /release, prepare a release, bump the version, publish a new version, open a release PR."argument-hint: "Optional: patch | minor | major | exact version (e.g. 0.2.0). Leave blank for auto-suggestion."---# /release-Prepares and opens a release PR for the `obsidian-agent-wiki` npm package. Does **not** publish to npm directly — publishing happens automatically via GitHub Actions after the PR is merged.+Prepares and opens a release PR for the `claude-second-brain` npm package. Does **not** publish to npm directly — publishing happens automatically via GitHub Actions after the PR is merged.## When to use@@ -101,11 +101,11 @@ cat package.json | grep '"version"'### Step 5 — Update pack-test skill-The `pack-test` skill hardcodes the tarball filename (e.g., `obsidian-agent-wiki-0.1.0.tgz`). Update every occurrence of the old version string in `.claude/skills/pack-test/SKILL.md` to the new version using the Edit tool with `replace_all: true`.+The `pack-test` skill hardcodes the tarball filename (e.g., `claude-second-brain-0.1.0.tgz`). Update every occurrence of the old version string in `.claude/skills/pack-test/SKILL.md` to the new version using the Edit tool with `replace_all: true`.Verify:```bash-grep "obsidian-agent-wiki-" .claude/skills/pack-test/SKILL.md+grep "claude-second-brain-" .claude/skills/pack-test/SKILL.md```### Step 6 — Commit the version bump@@ -140,7 +140,7 @@ gh pr create \### What happens after merge1. GitHub Action creates tag `vX.Y.Z` and a GitHub Release with auto-generated notes-2. GitHub Action publishes `[email protected]` to npm automatically+2. GitHub Action publishes `[email protected]` to npm automatically### Checklist@@ -159,9 +159,9 @@ After the PR is created, tell the user:> **PR opened:** [url]>> **Pipeline after merge:**-> 1. `release-publish.yml` creates tag `vX.Y.Z`, a GitHub Release, and publishes `[email protected]` to npm+> 1. `release-publish.yml` creates tag `vX.Y.Z`, a GitHub Release, and publishes `[email protected]` to npm>-> **To verify after merge:** https://www.npmjs.com/package/obsidian-agent-wiki+> **To verify after merge:** https://www.npmjs.com/package/claude-second-brain## What can go wrongdiff --git a/.github/workflows/pack-test.yml b/.github/workflows/pack-test.ymlindex 519871a..ce58a44 100644--- a/.github/workflows/pack-test.yml+++ b/.github/workflows/pack-test.yml@@ -28,7 +28,7 @@ jobs:- name: Scaffold via npxrun: |VERSION=$(node -p "require('./package.json').version")- npx -y "obsidian-agent-wiki-${VERSION}.tgz" test-vault+ npx -y "claude-second-brain-${VERSION}.tgz" test-vault- name: Verify scaffoldrun: |@@ -80,4 +80,4 @@ jobs:run: |rm -rf test-vaultVERSION=$(node -p "require('./package.json').version")- rm -f "obsidian-agent-wiki-${VERSION}.tgz"+ rm -f "claude-second-brain-${VERSION}.tgz"diff --git a/CLAUDE.md b/CLAUDE.mdindex ae8591f..6642412 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -16,7 +16,7 @@ Claude is responsible for: summarizing, cross-referencing, filing, and maintaini## Directory Layout```-obsidian-agent-wiki/+claude-second-brain/├── CLAUDE.md ← This file. The schema.├── sources/ ← Raw source material. IMMUTABLE — Claude never modifies these.│ ├── articles/ ← Web articles saved as markdowndiff --git a/README.md b/README.mdindex 4b80bce..e7d08de 100644--- a/README.md+++ b/README.md@@ -1,15 +1,16 @@-# :classical_building: obsidian-agent-wiki+# :classical_building: claude-second-brain**Your notes don't compound. This wiki does.**-[](https://www.npmjs.com/package/obsidian-agent-wiki) [](https://opensource.org/licenses/MIT)+[](https://www.npmjs.com/package/claude-second-brain) [](https://opensource.org/licenses/MIT) [](https://deepwiki.com/jessepinkman9900/claude-second-brain)+The fastest way to start your personal knowledge base powered by Obsidian, Claude Code, qmd, and GitHub.```-npx obsidian-agent-wiki+npx claude-second-brain```One command gives you a fully wired knowledge system:@@ -54,7 +55,7 @@ Everything is pre-configured. You bring the sources.**Step 1 — Scaffold**```bash-npx obsidian-agent-wiki+npx claude-second-brain```Creates your vault (the folder itself is the Obsidian vault), installs `mise` + `bun`, and runs `git init` with an initial commit.diff --git a/package.json b/package.jsonindex 6e7c382..2b8c774 100644--- a/package.json+++ b/package.json@@ -1,10 +1,10 @@{- "name": "obsidian-agent-wiki",- "version": "0.2.3",+ "name": "claude-second-brain",+ "version": "0.3.0","description": "Scaffold an LLM-maintained Obsidian knowledge wiki","type": "module","bin": {- "obsidian-agent-wiki": "./bin/create.js"+ "claude-second-brain": "./bin/create.js"},"files": ["bin/",@@ -17,6 +17,6 @@"license": "MIT","repository": {"type": "git",- "url": "https://github.com/jessepinkman9900/obsidian-agent-wiki"+ "url": "https://github.com/jessepinkman9900/claude-second-brain"}}diff --git a/template/CLAUDE.md b/template/CLAUDE.mdindex ae8591f..6642412 100644--- a/template/CLAUDE.md+++ b/template/CLAUDE.md@@ -16,7 +16,7 @@ Claude is responsible for: summarizing, cross-referencing, filing, and maintaini## Directory Layout```-obsidian-agent-wiki/+claude-second-brain/├── CLAUDE.md ← This file. The schema.├── sources/ ← Raw source material. IMMUTABLE — Claude never modifies these.│ ├── articles/ ← Web articles saved as markdowndiff --git a/template/README.md b/template/README.mdindex 4a54942..361ab3f 100644--- a/template/README.md+++ b/template/README.md@@ -1,4 +1,4 @@-# obsidian-agent-wiki+# claude-second-brain**Your notes don't compound. This wiki does.**@@ -65,7 +65,7 @@ All pages cross-link with Obsidian `[[wikilinks]]`. Contradictions are flagged w## Directory layout```-obsidian-agent-wiki/+claude-second-brain/├── CLAUDE.md ← The schema. Claude reads this every session.├── sources/ ← Your raw inputs. Claude never modifies these.│ ├── articles/ ← Web articles saved as markdown