workspace-memorylisted
Install: claude install-skill rajbdilip/skills
# Workspace Memory
Memory lives in `memory/` inside a workspace and is committed to Git. Scripts in this skill do all file editing, because they validate input, file each item in the right place, remove duplicates and keep links and indexes consistent; hand edits drift. Your job is to decide **what** is worth remembering and pass it to one command.
Commands below assume the skill is at `~/.claude/skills/workspace-memory`. If the session context shows a different path for `capture.mjs`, use that path instead.
## 1. Setup (only when asked, or when no `.workspace-memory/config.json` exists)
| Situation | Run |
| --- | --- |
| Hooks not installed on this machine yet | `node ~/.claude/skills/workspace-memory/scripts/install.mjs --scope global` |
| New planning or non-coding workspace | `node ~/.claude/skills/workspace-memory/scripts/init.mjs --target <dir>` |
| Link a code repo to a planning hub | `node ~/.claude/skills/workspace-memory/scripts/init.mjs --target <hub> --link <repo> --name <short-name>` |
Add `--dry-run` to preview any of these.
## 2. At session start
If the session context already contains "Workspace memory is active", the files are loaded. Do not read them again.
Otherwise read `memory/PROFILE.md`, `memory/CURRENT.md`, `memory/ACTIVE_THREADS.md` and `memory/INDEX.md`.
Open other memory files only when the task needs them. To find older context, search. Do not open files one by one:
```bash
node ~/.claude/skills/workspace-memory/scripts/search.mjs "caterer