Files
msd-core/docs/manual-update.md
Jakub Zych a9a7a328e6 refactor: hard-fork GSD -> MSD (Make Software Done)
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.
2026-10-06 01:47:40 +02:00

1.8 KiB

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

# 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.