dsh-workspace-memories 1.1.3 → 1.2.1

package/README.md

@@ -16,19 +16,23 @@ This plugin closes that gap with a small, explicit memory loop whose default sto
 
 1. **Every workspace gets a memory directory** — by default under the DSH data directory (`~/.dsh/workspace-memory/<workspace>/`), never inside the repo. Plain Markdown you can read, diff, and back up. (An opt-in `workspace` storage mode keeps memories in `<workspace>/.dsh/memory/` for teams who *want* them versioned alongside the code.)
 2. **Memories are injected automatically** — each session created in a workspace carries that workspace's memory files in its system prompt, alongside `AGENTS.md`, so a fresh session starts already "remembering".
-3. **The agent can write memories itself** — a global `save_workspace_memory` tool lets any session persist a decision, server detail, convention, or preference the moment you say "remember this".
+3. **The agent can write memories itself** — a global `save_workspace_memory` tool lets any session persist a decision, server detail, convention, or preference the moment you say "remember this" (pass `scope: "global"` for cross-project preferences).
 4. **You stay in control** — a sidebar panel lists, creates, edits, and deletes memory files per workspace, so memory stays inspectable and correctable instead of hidden in a database.
 
 ## Features
 
 | Capability | Where |
 |---|---|
-| Browse / create / edit / delete memory files | **Workspace Memory** sidebar panel (switch workspaces via the selector) |
+| Browse / create / edit / delete memory files | **Workspace Memory** sidebar panel (switch workspaces or the global scope via the selector) |
 | Ask the agent to remember something | Any session: "remember: …" → the agent calls `save_workspace_memory` |
-| Automatic recall | Every session in the workspace gets its memory files injected into its system prompt |
+| Automatic recall | Every session gets the **global** memory (all workspaces) followed by its **workspace** memory injected into its system prompt |
 
 Works in every built-in agent preset (Standard, PTC, Minimal, Creator): the tool is registered in the root composition, and global tools are visible to all presets unless a custom preset opts out with a `tools.restrict` allow list — add `save_workspace_memory` to that list if so.
 
+### Global memory
+
+The panel selector's top entry, **🌐 Global — every workspace**, addresses one cross-project memory directory at `~/.dsh/workspace-memory/_global/`. It is seeded once with a blank `preferences.md` template (persona, style, communication, formatting) and never overwritten after that. Global memory sorts **before** workspace memory in the prompt, so project notes read as overrides of personal preferences.
+
 ## Installation
 
 The package is plain JavaScript with no build step, so every install channel works:
@@ -73,7 +77,9 @@ Two storage modes, chosen by the plugin's `storage` config:
 | `workspace` | `<workspace>/.dsh/memory/` — inside the project | Team-shared memories meant to be committed alongside the code |
 
 ```
-~/.dsh/workspace-memory/     # default memory store, one subdirectory per workspace
+~/.dsh/workspace-memory/     # default memory store
+├── <workspace-key>/         #   one subdirectory per workspace
+└── _global/                 #   the cross-workspace global memory (panel: 🌐 Global)
 dsh-workspace-memories/        # this plugin
 ├── package.json             #   bundle manifest (dsh.bundle.patch + dsh.client)
 ├── cordis.patch.yml         #   plugin row declaration

package/README.zh.md

@@ -16,19 +16,23 @@ DSH 的 Agent 跨会话是无状态的：一个会话"学到"的东西——项
 
 1. **每个工作区一个记忆目录**——默认在 DSH 数据目录下（`~/.dsh/workspace-memory/<工作区>/`），不进仓库；纯 Markdown，可读、可 diff、可备份。（另提供 `workspace` 存储模式，把记忆放在 `<工作区>/.dsh/memory/`，适合想随代码一起版本化的团队共享记忆。）
 2. **记忆自动注入**——在该工作区创建的每个会话，系统提示都会携带这些记忆文件（与 `AGENTS.md` 并存），新会话一开始就"记得"。
-3. **Agent 可以自己记**——全局工具 `save_workspace_memory` 让任意会话在你说"记住这个"的当下就把决策、服务器细节、约定、偏好落成文件。
+3. **Agent 可以自己记**——全局工具 `save_workspace_memory` 让任意会话在你说"记住这个"的当下就把决策、服务器细节、约定、偏好落成文件（跨项目的个人偏好可传 `scope: "global"`）。
 4. **你始终可控**——侧栏面板按工作区列出、新建、编辑、删除记忆文件，记忆摊在阳光下，而不是藏进数据库。
 
 ## 功能
 
 | 能力 | 入口 |
 |---|---|
-| 浏览 / 新建 / 编辑 / 删除记忆文件 | 侧栏「工作区记忆」面板（可切换工作区） |
+| 浏览 / 新建 / 编辑 / 删除记忆文件 | 侧栏「工作区记忆」面板（可切换工作区或全局范围） |
 | 让 Agent 记住事情 | 任意会话直接说「记住：…」→ Agent 调用 `save_workspace_memory` |
-| 记忆自动生效 | 该工作区每个会话的系统提示自动携带其记忆文件 |
+| 记忆自动生效 | 每个会话的系统提示先携带**全局**记忆（所有工作区通用），再携带**工作区**记忆 |
 
 所有内置 Agent 预设（标准、PTC、极简、创造）均可用：工具注册在根组合，全局工具默认对所有预设可见。唯一例外是自定义预设使用 `tools.restrict` 白名单（`allow: [...]`）的情况——把 `save_workspace_memory` 加进白名单即可。
 
+### 全局记忆
+
+面板下拉里第一项「🌐 全局（所有工作区通用）」对应跨项目记忆目录 `~/.dsh/workspace-memory/_global/`。首次使用时自动种入一份空白模板 `preferences.md`（人格、风格、沟通、格式四节，带注释提示），此后绝不覆盖用户修改。注入顺序上全局记忆排在工作区记忆**前面**，工作区里的项目笔记即是对个人偏好的覆盖。
+
 ## 安装
 
 本包为纯 JavaScript、无构建步骤，所有安装渠道都可用：

package/client.js

@@ -16,12 +16,15 @@ window.__ModuleLoader__.load({
 
     const NS = 'workspaceMemory'
     const PANEL_ID = 'workspace-memory'
+    /** Selector value that addresses the cross-workspace global scope. */
+    const GLOBAL_ID = '__global__'
 
     const en = {
       'panel.title': 'Workspace Memory',
       'panel.subtitle': 'Per-workspace memory files, stored in the DSH data directory by default — outside the project folder, so server configs and other machine-local notes never get committed. Injected into every session of the workspace.',
-      'workspace.label': 'Workspace',
+      'workspace.label': 'Memory scope',
       'workspace.none': 'No workspace is registered yet.',
+      'workspace.global': '🌐 Global — every workspace',
       'action.refresh': 'Refresh',
       'action.new': 'New file',
       'action.save': 'Save',
@@ -49,8 +52,9 @@ window.__ModuleLoader__.load({
     const zh = {
       'panel.title': '工作区记忆',
       'panel.subtitle': '每个工作区独立的记忆文件，默认保存在 DSH 数据目录、不进入项目文件夹——服务器配置等本机敏感信息不会被误提交。自动注入该工作区每个会话的上下文。',
-      'workspace.label': '工作区',
+      'workspace.label': '记忆范围',
       'workspace.none': '尚未注册任何工作区。',
+      'workspace.global': '🌐 全局（所有工作区通用）',
       'action.refresh': '刷新',
       'action.new': '新建文件',
       'action.save': '保存',
@@ -256,8 +260,10 @@ window.__ModuleLoader__.load({
       const [busy, setBusy] = useState(false)
 
       // Default the selector to the Workspace of the Session the main view
-      // retains, falling back to the first listed Workspace.
+      // retains, falling back to the first listed Workspace. The reserved
+      // global scope always stays selected once chosen.
       useEffect(() => {
+        if (workspaceId === GLOBAL_ID) return
         if (workspaces.length === 0) {
           if (workspaceId !== null) setWorkspaceId(null)
           return
@@ -284,7 +290,9 @@ window.__ModuleLoader__.load({
         }
         if (!options.quiet) setFilesState((previous) => ({ ...previous, status: 'loading' }))
         try {
-          const value = await api('list', { query: { workspaceId: id } })
+          const query = { workspaceId: id }
+          if (id === GLOBAL_ID) query.scope = 'global'
+          const value = await api('list', { query })
           const files = Array.isArray(value.files) ? value.files : []
           setFilesState({ status: 'ready', files })
           return files
@@ -300,7 +308,9 @@ window.__ModuleLoader__.load({
         setNotice(null)
         setConfirmingDelete(false)
         try {
-          const value = await api('read', { query: { workspaceId, name } })
+          const query = { workspaceId, name }
+          if (workspaceId === GLOBAL_ID) query.scope = 'global'
+          const value = await api('read', { query })
           setSelected(name)
           setContent(value.content)
           setSavedContent(value.content)
@@ -330,7 +340,9 @@ window.__ModuleLoader__.load({
         setBusy(true)
         setNotice(null)
         try {
-          await api('write', { body: { workspaceId, name: selected, content } })
+          const body = { workspaceId, name: selected, content }
+          if (workspaceId === GLOBAL_ID) body.scope = 'global'
+          await api('write', { body })
           setSavedContent(content)
           setNotice({ kind: 'ok', text: t('notice.saved') })
           await refresh(workspaceId, { quiet: true })
@@ -352,7 +364,9 @@ window.__ModuleLoader__.load({
         setBusy(true)
         setNotice(null)
         try {
-          await api('write', { body: { workspaceId, name, content: '' } })
+          const body = { workspaceId, name, content: '' }
+          if (workspaceId === GLOBAL_ID) body.scope = 'global'
+          await api('write', { body })
           setCreating(false)
           setNewName('')
           setNotice({ kind: 'ok', text: t('notice.created') })
@@ -374,7 +388,9 @@ window.__ModuleLoader__.load({
         setBusy(true)
         setNotice(null)
         try {
-          await api('delete', { body: { workspaceId, name: selected } })
+          const body = { workspaceId, name: selected }
+          if (workspaceId === GLOBAL_ID) body.scope = 'global'
+          await api('delete', { body })
           setSelected(null)
           setContent('')
           setSavedContent('')
@@ -493,9 +509,10 @@ window.__ModuleLoader__.load({
               id: 'dwm-workspace',
               className: 'dwm-select',
               value: workspaceId || '',
-              disabled: workspaces.length === 0,
+              disabled: workspaces.length === 0 && workspaceId !== GLOBAL_ID,
               onChange: (event) => setWorkspaceId(event.target.value || null),
             },
+              h('option', { value: GLOBAL_ID }, t('workspace.global')),
               workspaces.length === 0 && h('option', { value: '' }, t('workspace.none')),
               workspaces.map((item) => h('option', { key: item.workspaceId, value: item.workspaceId },
                 item.title && item.title.trim() !== '' ? `${item.title} — ${item.path}` : item.path)),

package/index.js

@@ -14,16 +14,18 @@
  * Three contributions make the memory real:
  *
  * 1. Panel API — exact Fetch routes on Connection's shared `/api` channel so
- *    the browser panel can list, read, create, update, and delete the files:
- *      GET  /api/workspace-memory/list?workspaceId=<id>
- *      GET  /api/workspace-memory/read?workspaceId=<id>&name=<file>
- *      POST /api/workspace-memory/write   { workspaceId, name, content }
- *      POST /api/workspace-memory/delete  { workspaceId, name }
- * 2. Prompt injection — an `agent/created` listener registers a per-agent
- *    system-prompt section that renders the workspace's current memory files
- *    into every session running in that directory.
+ *    the browser panel can list, read, create, update, and delete the files.
+ *    Every route accepts an optional `scope=global` field addressing the
+ *    cross-workspace memory directory (`<storageDir>/_global/`):
+ *      GET  /api/workspace-memory/list?workspaceId=<id>[&scope=global]
+ *      GET  /api/workspace-memory/read?workspaceId=<id>[&scope=global]&name=<file>
+ *      POST /api/workspace-memory/write   { workspaceId, [scope], name, content }
+ *      POST /api/workspace-memory/delete  { workspaceId, [scope], name }
+ * 2. Prompt injection — an `agent/created` listener registers two per-agent
+ *    system-prompt sections: `global-memory` (every workspace) followed by
+ *    `workspace-memory` (this directory).
  * 3. Agent tool — `save_workspace_memory` lets the model persist a memory
- *    file itself when the user asks it to remember something.
+ *    file itself, scoped to the workspace or globally.
  *
  * Route responses use one envelope: `{ ok: true, value }` or
  * `{ ok: false, error: { code, message } }`. The panel addresses memory only
@@ -47,6 +49,30 @@ const MAX_CONTENT_BYTES = 1024 * 1024
 const PROMPT_MAX_FILES = 20
 const PROMPT_MAX_FILE_CHARS = 32768
 const PROMPT_SECTION_ORDER = 9800
+const GLOBAL_SECTION_ORDER = 9700
+/** Selector value the panel uses for the cross-workspace scope. */
+const GLOBAL_WORKSPACE_ID = '__global__'
+/** Reserved directory name under the storage root; workspace keys always carry a `-<hash>` suffix, so this cannot collide. */
+const GLOBAL_DIR_NAME = '_global'
+const GLOBAL_SEED_FILE = 'preferences.md'
+/** Starter template for the global scope: persona, style, communication, and formatting hints in one file. */
+export const GLOBAL_SEED_CONTENT = `# 全局偏好 / Global Preferences
+<!-- 全局记忆对每一个工作区生效，适合放人格、风格、沟通、格式这类跨项目的个人偏好。
+     工作区记忆优先于本文件；只填你在乎的项，其余留空即可。
+     懒得自己填？在任意会话对 Agent 说「帮我配置全局偏好」，它会逐个问你几个问题并自动写好。 -->
+
+## 人格 / Persona
+<!-- 你是谁、希望 AI 以什么身份/视角与你交流（例如：资深搭档、严格评审、耐心的老师） -->
+
+## 风格 / Style
+<!-- 语言风格：正式还是口语、中文还是英文优先、技术深度、是否允许玩笑 -->
+
+## 沟通 / Communication
+<!-- 亲切程度、热情程度、emoji 使用、回复详细还是简洁 -->
+
+## 格式 / Formatting
+<!-- 回答格式：要不要标题和小标题、列表、表格、代码块、可视化/图示 -->
+`
 const INVALID_NAME_CHARS = /[\s/\\:*?"<>|]/
 const CONTROL_CHARS = /[\x00-\x1f\x7f]/
 
@@ -81,6 +107,30 @@ export function apply(ctx, config = {}) {
     ? path.resolve(config.storageDir.trim())
     : path.join(os.homedir(), '.dsh', 'workspace-memory')
 
+  /** Absolute directory holding the cross-workspace global memory files. */
+  const globalDir = path.join(storageDir, GLOBAL_DIR_NAME)
+
+  /**
+   * Seed the global memory directory with one starter template. Runs only
+   * while the directory does not exist yet; an existing directory (even an
+   * emptied one) is never rewritten, so user edits always win. Concurrent
+   * callers share one attempt, so an activation-time seed and a first list
+   * cannot race each other into a half-seeded state.
+   */
+  let globalSeed = null
+  async function seedGlobalMemory() {
+    globalSeed ??= (async () => {
+      try {
+        await fs.mkdir(globalDir, { recursive: false })
+      } catch {
+        return // already exists — seeding is one-shot
+      }
+      await fs.writeFile(path.join(globalDir, GLOBAL_SEED_FILE), GLOBAL_SEED_CONTENT, 'utf8')
+    })().catch(() => { /* seeding must never break the caller */ })
+    return globalSeed
+  }
+  void seedGlobalMemory()
+
   // ---------------------------------------------------------------------------
   // Shared memory-file helpers
   // ---------------------------------------------------------------------------
@@ -199,15 +249,15 @@ export function apply(ctx, config = {}) {
   const memoryCaches = new Map()
 
   /**
-   * Render the workspace memory section for one memory directory, re-reading
-   * file contents only when the directory signature (names, sizes, mtimes)
-   * changed. Runs synchronously because prompt-section providers are
-   * synchronous; the stat round-trip over a handful of small files is
-   * negligible per model step.
+   * Render one memory section for a memory directory, re-reading file contents
+   * only when the directory signature (names, sizes, mtimes) changed. Runs
+   * synchronously because prompt-section providers are synchronous; the stat
+   * round-trip over a handful of small files is negligible per model step.
    * @param {string} dir - absolute memory directory.
+   * @param {'workspace' | 'global'} kind - which scope this section renders.
    * @returns {string} section text, empty when no memory exists.
    */
-  function buildMemoryText(dir) {
+  function buildMemoryText(dir, kind) {
     let signature = 'missing'
     const files = []
     try {
@@ -224,14 +274,11 @@ export function apply(ctx, config = {}) {
 
     let text = ''
     if (files.length > 0) {
-      const parts = [
-        '## Workspace Memory',
-        '',
-        'This workspace has durable memory files, one Markdown file per topic, managed from the "Workspace Memory" sidebar panel. '
-          + 'By default they live in the DSH data directory OUTSIDE the project tree, so machine-local details (server configurations, environment quirks, personal conventions) never land in the repository. '
-          + 'Treat them as trusted project memory alongside AGENTS.md. When the user asks you to remember a project decision, convention, server detail, or preference, persist it with the save_workspace_memory tool.',
-        '',
-      ]
+      const heading = kind === 'global' ? '## Global Memory' : '## Workspace Memory'
+      const intro = kind === 'global'
+        ? 'These global memory files apply to EVERY workspace — cross-project persona, style, and preferences. They are managed from the "Workspace Memory" sidebar panel (the 全局/Global scope) and stored in the DSH data directory. Workspace memory, when present, takes precedence over these global notes for project-specific matters. When the user asks you to remember a personal preference that should follow them across projects, persist it here with the save_workspace_memory tool and scope "global".'
+        : 'This workspace has durable memory files, one Markdown file per topic, managed from the "Workspace Memory" sidebar panel. By default they live in the DSH data directory OUTSIDE the project tree, so machine-local details (server configurations, environment quirks, personal conventions) never land in the repository. Treat them as trusted project memory alongside AGENTS.md. When the user asks you to remember a project decision, convention, server detail, or preference, persist it with the save_workspace_memory tool.'
+      const parts = [heading, '', intro, '']
       for (const file of files.slice(0, PROMPT_MAX_FILES)) {
         let content
         try {
@@ -258,11 +305,17 @@ export function apply(ctx, config = {}) {
   // ---------------------------------------------------------------------------
 
   /**
-   * Resolve the fenced memory directory for one registered workspace.
-   * @param {string | null} workspaceId - registry workspace id from the client.
-   * @returns {{ dir: string, display: string } | { error: Response }}
+   * Resolve the fenced memory directory for one scope.
+   * @param {string | null} workspaceId - registry workspace id from the client
+   *   (ignored for the global scope).
+   * @param {unknown} scope - 'global' for the cross-workspace scope; anything
+   *   else (including undefined) keeps the original per-workspace behavior.
+   * @returns {{ dir: string, display: string, scope: 'workspace' | 'global' } | { error: Response }}
    */
-  function resolveMemoryDir(workspaceId) {
+  function resolveMemoryDir(workspaceId, scope) {
+    if (scope === 'global' || workspaceId === GLOBAL_WORKSPACE_ID) {
+      return { dir: globalDir, display: globalDir, scope: 'global' }
+    }
     if (typeof workspaceId !== 'string' || workspaceId === '') {
       return { error: fail(400, 'workspace-memory/workspace-required', 'A workspaceId query or body field is required.') }
     }
@@ -270,19 +323,22 @@ export function apply(ctx, config = {}) {
     if (workspace === undefined) {
       return { error: fail(404, 'workspace-memory/unknown-workspace', `Unknown workspace: ${workspaceId}`) }
     }
-    return memoryDirFor(path.resolve(workspace.path))
+    const resolved = memoryDirFor(path.resolve(workspace.path))
+    if (resolved.error) return resolved
+    return { ...resolved, scope: 'workspace' }
   }
 
   async function handleList(request) {
-    const workspaceId = new URL(request.url).searchParams.get('workspaceId')
-    const resolved = resolveMemoryDir(workspaceId)
+    const params = new URL(request.url).searchParams
+    const resolved = resolveMemoryDir(params.get('workspaceId'), params.get('scope'))
     if (resolved.error) return resolved.error
-    return ok({ directory: resolved.display, storage, files: await listFiles(resolved.dir) })
+    if (resolved.scope === 'global') await seedGlobalMemory().catch(() => {})
+    return ok({ directory: resolved.display, storage, scope: resolved.scope, files: await listFiles(resolved.dir) })
   }
 
   async function handleRead(request) {
     const params = new URL(request.url).searchParams
-    const resolved = resolveMemoryDir(params.get('workspaceId'))
+    const resolved = resolveMemoryDir(params.get('workspaceId'), params.get('scope'))
     if (resolved.error) return resolved.error
     const named = validateName(params.get('name'))
     if (named.error) return named.error
@@ -303,7 +359,7 @@ export function apply(ctx, config = {}) {
     if (typeof body !== 'object' || body === null) {
       return fail(400, 'workspace-memory/bad-request', 'A JSON body is required.')
     }
-    const resolved = resolveMemoryDir(body.workspaceId)
+    const resolved = resolveMemoryDir(body.workspaceId, body.scope)
     if (resolved.error) return resolved.error
     const named = validateName(body.name)
     if (named.error) return named.error
@@ -324,7 +380,7 @@ export function apply(ctx, config = {}) {
     if (typeof body !== 'object' || body === null) {
       return fail(400, 'workspace-memory/bad-request', 'A JSON body is required.')
     }
-    const resolved = resolveMemoryDir(body.workspaceId)
+    const resolved = resolveMemoryDir(body.workspaceId, body.scope)
     if (resolved.error) return resolved.error
     const named = validateName(body.name)
     if (named.error) return named.error
@@ -386,6 +442,18 @@ export function apply(ctx, config = {}) {
 
   ctx.on('agent/created', ({ agent }) => {
     // This listener runs inside agent creation; it must never reject.
+    try {
+      // Global memory follows the user into every workspace and sorts before
+      // the workspace section, so project-specific notes read as overrides.
+      const globalDispose = agent.ctx.systemPrompt.section({
+        name: 'global-memory',
+        order: GLOBAL_SECTION_ORDER,
+        // Same rationale as the workspace section: user prose stays literal.
+        interpolate: false,
+        text: () => buildMemoryText(globalDir, 'global'),
+      })
+      agentRegistrations.add(globalDispose)
+    } catch { /* the agent may already be disposed; its context rejects registration */ }
     try {
       const cwd = agentCwd(agent)
       if (typeof cwd !== 'string' || cwd === '') return
@@ -402,7 +470,7 @@ export function apply(ctx, config = {}) {
             // literal text, not a prompt variable reference. Opting this section out of
             // interpolation keeps such notes from failing prompt assembly.
             interpolate: false,
-            text: () => buildMemoryText(dir),
+            text: () => buildMemoryText(dir, 'workspace'),
           })
           agentRegistrations.add(dispose)
         } catch { /* the agent may already be disposed; its context rejects registration */ }
@@ -417,10 +485,11 @@ export function apply(ctx, config = {}) {
   ctx.effect(() => ctx.tools.register({
     name: 'save_workspace_memory',
     description:
-      'Save durable memory for this workspace as a Markdown file. '
+      'Save durable memory as a Markdown file. '
+      + 'By default the memory is scoped to this workspace and injected into every session working in it; with scope "global" it applies to every workspace instead (persona, style, and cross-project preferences belong there). '
       + 'Memories are stored outside the project directory by default (in the DSH data directory), so machine-local details such as server configurations never enter the repository. '
       + 'Use it when the user asks you to remember a project decision, convention, server detail, preference, or fact across sessions. '
-      + 'Memory files are injected into every session working in this workspace and can be reviewed in the Workspace Memory sidebar panel.',
+      + 'Memory files can be reviewed in the Workspace Memory sidebar panel.',
     parameters: {
       type: 'object',
       properties: {
@@ -432,6 +501,11 @@ export function apply(ctx, config = {}) {
           type: 'string',
           description: 'Complete Markdown content to store; overwrites the existing file of the same name.',
         },
+        scope: {
+          type: 'string',
+          enum: ['workspace', 'global'],
+          description: 'Which memory scope to write: "workspace" (default, this workspace only) or "global" (every workspace).',
+        },
       },
       required: ['name', 'content'],
       additionalProperties: false,
@@ -441,10 +515,7 @@ export function apply(ctx, config = {}) {
       render: (_args, value) => [{ type: 'text', text: String(value) }],
     },
     async execute(args, exec) {
-      const cwd = agentCwd(exec.agent)
-      if (typeof cwd !== 'string' || cwd === '') {
-        throw new Error('This session has no working directory, so there is no workspace to remember for.')
-      }
+      const scope = args?.scope === 'global' ? 'global' : 'workspace'
       const name = normalizeToolName(args?.name)
       if (name === null) {
         throw new Error(`Invalid memory file name ${JSON.stringify(args?.name)}: use letters, digits, dot, underscore or hyphen.`)
@@ -455,12 +526,25 @@ export function apply(ctx, config = {}) {
       if (Buffer.byteLength(args.content, 'utf8') > MAX_CONTENT_BYTES) {
         throw new Error(`Memory content exceeds ${MAX_CONTENT_BYTES} bytes.`)
       }
-      const root = await resolveRoot(cwd)
-      const memory = memoryDirFor(root)
-      if (memory.error) throw new Error('The configured memory directory escapes the workspace.')
-      await fs.mkdir(memory.dir, { recursive: true })
-      await fs.writeFile(path.join(memory.dir, name), args.content, 'utf8')
-      return `Saved workspace memory "${name}"; every session in this workspace now sees it.`
+      let dir
+      if (scope === 'global') {
+        await seedGlobalMemory().catch(() => {})
+        dir = globalDir
+      } else {
+        const cwd = agentCwd(exec.agent)
+        if (typeof cwd !== 'string' || cwd === '') {
+          throw new Error('This session has no working directory, so there is no workspace to remember for.')
+        }
+        const root = await resolveRoot(cwd)
+        const memory = memoryDirFor(root)
+        if (memory.error) throw new Error('The configured memory directory escapes the workspace.')
+        dir = memory.dir
+      }
+      await fs.mkdir(dir, { recursive: true })
+      await fs.writeFile(path.join(dir, name), args.content, 'utf8')
+      return scope === 'global'
+        ? `Saved global memory "${name}"; every session in every workspace now sees it.`
+        : `Saved workspace memory "${name}"; every session in this workspace now sees it.`
     },
   }), 'workspace-memory: save tool')
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-workspace-memories",
-  "version": "1.1.3",
+  "version": "1.2.1",
   "description": "Per-workspace persistent memory for DeepSeek Harness: a sidebar panel to manage Markdown memory files, automatic injection into every session of the workspace, and an agent tool to save new memories",
   "type": "module",
   "license": "MIT",