Skip to content

Fastest way to scaffold your LLM powered personal knowledge base - Obsidian, Claude Code, qmd, Github

feat: add csb bin alias for global CLI

jessepinkman9900a2ba7d5cf42c
diff --git a/README.md b/README.md
index bdbafdf..38851df 100644
--- a/README.md
+++ b/README.md
@@ -58,6 +58,13 @@ Everything is pre-configured. You bring the sources.
npx claude-second-brain
```
+Or install globally — `csb` is a shorter alias:
+
+```bash
+npm i -g claude-second-brain
+csb
+```
+
The CLI will ask:
- **Brain name** — what to call this brain (default: `my-brain`)
- **GitHub repo** — optionally create a private repo and push automatically (requires `gh` CLI)
diff --git a/docs/pages/getting-started.mdx b/docs/pages/getting-started.mdx
index d2abfe7..6007443 100644
--- a/docs/pages/getting-started.mdx
+++ b/docs/pages/getting-started.mdx
@@ -12,6 +12,13 @@
npx claude-second-brain
```
+Or install globally for a shorter command (`csb` is an alias):
+
+```bash
+npm i -g claude-second-brain
+csb # same as: claude-second-brain
+```
+
The CLI will ask:
- **Brain name** — what to call this brain (default: `my-brain`)
@@ -48,7 +55,7 @@ Open `~/.claude-second-brain/my-brain/` as a vault in Obsidian — the folder is
## Multiple brains
-Run `npx claude-second-brain` again to create additional brains. Each gets its own folder under `~/.claude-second-brain/` and its own isolated qmd index. The global skills (`/brain-ingest`, `/brain-search`, `/brain-refresh`) always operate on the **default brain** in `~/.claude-second-brain/config.toml`. The first brain created is set as the default automatically.
+Run `npx claude-second-brain` (or `csb` if installed globally) again to create additional brains. Each gets its own folder under `~/.claude-second-brain/` and its own isolated qmd index. The global skills (`/brain-ingest`, `/brain-search`, `/brain-refresh`) always operate on the **default brain** in `~/.claude-second-brain/config.toml`. The first brain created is set as the default automatically.
## Access from anywhere
diff --git a/docs/pages/ship-log.mdx b/docs/pages/ship-log.mdx
index a4d92a5..8382867 100644
--- a/docs/pages/ship-log.mdx
+++ b/docs/pages/ship-log.mdx
@@ -8,6 +8,7 @@ A running record of every released version of `claude-second-brain` on npm. Newe
- Added `claude-second-brain path [--brain N] [--root|--qmd|--config]` and `claude-second-brain qmd [--brain N] -- …` subcommands. The global skills now resolve paths at call time via these commands instead of having absolute paths baked in at scaffold time.
- `config.toml`'s `active` field renamed to `default`. Existing configs with `active = …` are still read transparently and rewritten to `default = …` on the next write.
- Global skills (`brain-ingest`, `brain-search`, `brain-refresh`) now ship with a `.csb-version` sidecar file. Re-running `npx claude-second-brain <name>` detects version mismatches and prompts before overwriting; `CSB_SKIP_SKILL_UPDATES=1` disables the prompt.
+- Added `csb` as a bin alias. After `npm i -g claude-second-brain`, both `claude-second-brain` and `csb` are available globally.
**Refactors:**
- Removed the `__QMD_PATH__` and `__CSB_CONFIG__` placeholder substitutions. `scripts/qmd/{setup,reindex}.ts` now compute the index path from `import.meta.url`; CLAUDE.md and vault-local skills use a relative `.qmd/index.sqlite` path.
diff --git a/package.json b/package.json
index 3abbfba..06bab60 100644
--- a/package.json
+++ b/package.json
@@ -4,7 +4,8 @@
"description": "The fastest way to start your personal knowledge base powered by Obsidian, Claude Code, qmd, and GitHub.",
"type": "module",
"bin": {
- "claude-second-brain": "./bin/create.js"
+ "claude-second-brain": "./bin/create.js",
+ "csb": "./bin/create.js"
},
"scripts": {
"docs:dev": "vocs dev",