a9a7a328e6
Mechanical rename produced by scripts/msd-rename.cjs: gsd/Gsd/GSD -> msd/Msd/MSD across contents and paths, upstream package/repo coordinates -> @golem15/msd-core and golem15com/msd-core. Deep links into upstream history, sibling upstream packages, the GSD-2 import feature, CHANGELOG.md and .changeset/ are kept as-is. Hand edits on top: MSD block-letter banner and logos, LICENSE copyright line, package/plugin identity, regenerated lockfile, install-tree fixtures, derived registries and benchmark baseline; migration checksum baseline re-locked (MSD keeps its own install state, so no install had applied the old sums); sort-order and regex-escaped expectations in tests adjusted.
62 lines
1.8 KiB
Markdown
62 lines
1.8 KiB
Markdown
# Manual Update (Non-npm Install)
|
|
|
|
Use this procedure when `npx @golem15/msd-core@latest` is unavailable — e.g. during a publish outage or if you are working directly from the source repo.
|
|
|
|
## Prerequisites
|
|
|
|
- Node.js installed
|
|
- This repo cloned locally (`git clone https://github.com/golem15com/msd-core`)
|
|
|
|
## Steps
|
|
|
|
```bash
|
|
# 1. Pull latest code
|
|
git pull --rebase origin main
|
|
|
|
# 2. Build the hooks dist (required — hooks/dist/ is generated, not checked in as source)
|
|
node scripts/build-hooks.js
|
|
|
|
# 3. Run the installer directly
|
|
node bin/install.js --claude --global
|
|
|
|
# 4. Clear the update cache so the statusline indicator resets
|
|
rm -f ~/.cache/msd/msd-update-check.json
|
|
```
|
|
|
|
**Step 5 — Restart your runtime** to pick up the new commands and agents.
|
|
|
|
## Runtime flags
|
|
|
|
Replace `--claude` with the flag for your runtime:
|
|
|
|
| Runtime | Flag |
|
|
|---|---|
|
|
| Claude Code | `--claude` |
|
|
| OpenCode | `--opencode` |
|
|
| Kilo | `--kilo` |
|
|
| Codex | `--codex` |
|
|
| Copilot | `--copilot` |
|
|
| Cursor | `--cursor` |
|
|
| Windsurf | `--windsurf` |
|
|
| Augment | `--augment` |
|
|
| All runtimes | `--all` |
|
|
|
|
Use `--local` instead of `--global` for a project-scoped install.
|
|
|
|
## What the installer replaces
|
|
|
|
The installer performs a clean wipe-and-replace of MSD-managed directories only:
|
|
|
|
- `~/.claude/msd-core/` — workflows, references, templates
|
|
- `~/.claude/commands/msd/` — slash commands
|
|
- `~/.claude/agents/msd-*.md` — MSD agents
|
|
- `~/.claude/hooks/dist/` — compiled hooks
|
|
|
|
**What is preserved:**
|
|
- Custom agents not prefixed with `msd-`
|
|
- Custom commands outside `commands/msd/`
|
|
- Your `CLAUDE.md` files
|
|
- Custom hooks
|
|
|
|
Locally modified MSD files are automatically backed up to `msd-local-patches/` before the install. Run `/msd-update --reapply` after updating to merge your modifications back in.
|