myrlin-workbook 0.9.27 → 0.9.29

package/logs/server.pid

@@ -1 +1 @@
-44496
+55976

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "myrlin-workbook",
-  "version": "0.9.27",
+  "version": "0.9.29",
   "description": "Browser-based project manager for Claude Code sessions - session discovery, multi-terminal, cost tracking, docs, and kanban board",
   "main": "src/index.js",
   "bin": {

package/src/core/td-adapter.js

@@ -82,7 +82,8 @@ async function listIssues(cwd, filters = {}, binary = DEFAULT_TD_BINARY) {
   if (filters.status) args.push('--status', filters.status);
   const { stdout } = await runTd(binary, args, cwd);
   const parsed = JSON.parse(stdout);
-  // td --json returns either an array or { issues: [...] }
+  // td --json returns either an array, { issues: [...] }, or null (empty repo)
+  if (!parsed) return [];
   return Array.isArray(parsed) ? parsed : (parsed.issues || []);
 }
 

package/src/web/public/app.js

@@ -3109,10 +3109,16 @@ class CWMApp {
           this.showToast('Select or create a project first', 'warning');
           return;
         }
-        // Use project folder name as friendly default name instead of raw UUID
-        const projectName = projectPath ? projectPath.split('\\').pop() || projectPath.split('/').pop() || sessionName : sessionName;
-        const shortId = sessionName.length > 8 ? sessionName.substring(0, 8) : sessionName;
-        const friendlyName = projectName + ' (' + shortId + ')';
+        // Prefer custom title from Claude session, fall back to folder name + short UUID
+        const customTitle = this.getProjectSessionTitle(sessionName);
+        let friendlyName;
+        if (customTitle) {
+          friendlyName = customTitle;
+        } else {
+          const projectName = projectPath ? projectPath.split('\\').pop() || projectPath.split('/').pop() || sessionName : sessionName;
+          const shortId = sessionName.length > 8 ? sessionName.substring(0, 8) : sessionName;
+          friendlyName = projectName + ' (' + shortId + ')';
+        }
         this.api('POST', '/api/sessions', {
           name: friendlyName,
           workspaceId: this.state.activeWorkspace.id,
@@ -4763,13 +4769,83 @@ class CWMApp {
     if (name === 'files') this.renderTasksFilesPanel();
   }
 
-  async renderTasksTdPanel() {
-    const panel = document.getElementById('tasks-td-panel');
+  /**
+   * Render the project switcher toolbar inside a td panel toolbar element.
+   * Populates a <select> from this._tdProjects (loaded async).
+   * @param {HTMLElement} toolbar
+   * @param {string} currentDir - the currently shown repo dir
+   */
+  _renderTdToolbar(toolbar, currentDir) {
+    toolbar.textContent = '';
+    const label = document.createElement('span');
+    label.className = 'tasks-td-toolbar-label';
+    label.textContent = 'Project';
+    toolbar.appendChild(label);
+
+    const sel = document.createElement('select');
+    sel.className = 'tasks-td-project-select';
+
+    const projects = this._tdProjects || [];
+
+    // Always include the current dir even if not yet in projects list
+    const allDirs = new Map();
+    allDirs.set(currentDir, this._tdProjectName(currentDir));
+    for (const p of projects) allDirs.set(p.repoDir, p.name || this._tdProjectName(p.repoDir));
+
+    for (const [dir, name] of allDirs) {
+      const opt = document.createElement('option');
+      opt.value = dir;
+      opt.textContent = name;
+      opt.selected = dir === currentDir;
+      sel.appendChild(opt);
+    }
+
+    sel.addEventListener('change', () => {
+      this._tdPanelDir = sel.value;
+      // Mark as manually pinned so pane focus changes don't override the selection
+      this._tdPanelDirPinned = (sel.value !== this._getTdPanelDir());
+      this.renderTasksTdPanel();
+    });
+
+    toolbar.appendChild(sel);
+
+    // Refresh button
+    const refreshBtn = document.createElement('button');
+    refreshBtn.className = 'btn btn-ghost btn-icon btn-sm tasks-td-refresh';
+    refreshBtn.title = 'Refresh';
+    refreshBtn.innerHTML = '&#8635;';
+    refreshBtn.addEventListener('click', () => this.renderTasksTdPanel());
+    toolbar.appendChild(refreshBtn);
+  }
+
+  /** Extract a short project name from a directory path */
+  _tdProjectName(dir) {
+    if (!dir) return '(unknown)';
+    return dir.split('/').filter(Boolean).pop() || dir;
+  }
+
+  /**
+   * Resolve the td repo dir for the currently focused terminal pane.
+   * Falls back to the active workspace's resolved dir.
+   * Returns null if nothing useful found.
+   */
+  _getTdPanelDir() {
+    // 1. Prefer the focused terminal pane's working dir
+    const slot = this._activeTerminalSlot;
+    const tp = slot !== null ? this.terminalPanes[slot] : null;
+    if (tp && tp.spawnOpts && tp.spawnOpts.cwd) return tp.spawnOpts.cwd;
+    // 2. Fall back to any open pane's cwd
+    for (const p of this.terminalPanes) {
+      if (p && p.spawnOpts && p.spawnOpts.cwd) return p.spawnOpts.cwd;
+    }
+    return null;
+  }
+
+  async renderTasksTdPanel(container = null) {
+    const panel = container || document.getElementById('tasks-td-panel');
     if (!panel) return;
     if (!this.getSetting('enableTd')) return;
 
-    const ws = this.state.activeWorkspace;
-
     const showPlaceholder = (msg, isError) => {
       panel.textContent = '';
       const el = document.createElement('div');
@@ -4778,24 +4854,44 @@ class CWMApp {
       panel.appendChild(el);
     };
 
-    if (!ws) {
-      showPlaceholder('No active project selected', false);
+    // Determine which dir to show: manually selected > active pane > nothing
+    const autoDir = this._getTdPanelDir();
+    if (!this._tdPanelDir && autoDir) this._tdPanelDir = autoDir;
+    const dir = this._tdPanelDir;
+
+    if (!dir) {
+      showPlaceholder('Open a project in a terminal pane to see its td issues', false);
       return;
     }
 
     showPlaceholder('Loading td issues\u2026', false);
 
+    // Load projects list for dropdown (non-blocking, updates after issues load)
+    this.api('GET', '/api/td/projects').then(projectsData => {
+      this._tdProjects = projectsData.projects || [];
+      // Re-render toolbar if panel is still showing the td view
+      const toolbar = panel.querySelector('.tasks-td-toolbar');
+      if (toolbar) this._renderTdToolbar(toolbar, dir);
+    }).catch(() => {});
+
     try {
-      const data = await this.api('GET', `/api/workspaces/${ws.id}/td/issues`);
+      const data = await this.api('GET', `/api/td/issues?dir=${encodeURIComponent(dir)}`);
       const issues = data.issues || [];
 
+      panel.textContent = '';
+      const toolbar = document.createElement('div');
+      toolbar.className = 'tasks-td-toolbar';
+      this._renderTdToolbar(toolbar, dir);
+      panel.appendChild(toolbar);
+
       if (issues.length === 0) {
-        showPlaceholder('No open td issues for this project', false);
+        const empty = document.createElement('div');
+        empty.className = 'tasks-placeholder';
+        empty.textContent = 'No open td issues for this project';
+        panel.appendChild(empty);
         return;
       }
 
-      panel.textContent = '';
-
       // Group by status in display order
       const STATUS_ORDER = ['in_progress', 'in_review', 'blocked', 'open'];
       const STATUS_LABELS = {
@@ -4869,6 +4965,10 @@ class CWMApp {
       if (msg.includes('not initialized')) {
         // td isn't initialized — show a helpful prompt rather than a raw error
         panel.textContent = '';
+        const toolbar = document.createElement('div');
+        toolbar.className = 'tasks-td-toolbar';
+        this._renderTdToolbar(toolbar, dir);
+        panel.appendChild(toolbar);
         const wrap = document.createElement('div');
         wrap.style.cssText = 'display:flex;flex-direction:column;align-items:center;gap:12px;padding:32px 24px;';
         const info = document.createElement('div');
@@ -4877,7 +4977,7 @@ class CWMApp {
         info.textContent = 'td is not initialized for this project.';
         const hint = document.createElement('div');
         hint.style.cssText = 'font-size:12px;color:var(--subtext0);text-align:center;';
-        hint.textContent = 'Run td init in the project root to enable task tracking. If this repo uses a git worktree, td should be initialized in the main repo.';
+        hint.textContent = 'Run td init in the project root to enable task tracking.';
         const initBtn = document.createElement('button');
         initBtn.className = 'btn btn-primary btn-sm';
         initBtn.textContent = 'Run td init';
@@ -4885,7 +4985,14 @@ class CWMApp {
           initBtn.disabled = true;
           initBtn.textContent = 'Initializing\u2026';
           try {
-            await this.api('POST', `/api/workspaces/${ws.id}/td/init`, {});
+            // Use the workspace-scoped init if we can find the ws, otherwise use the dir directly
+            const ws = this.state.activeWorkspace;
+            if (ws) {
+              await this.api('POST', `/api/workspaces/${ws.id}/td/init`, { repoDir: dir });
+            } else {
+              // Fallback: run td init via a generic endpoint if workspace isn't known
+              throw new Error('No active workspace to run td init against. Run `td init` manually in ' + dir);
+            }
             this.renderTasksTdPanel();
           } catch (e) {
             initBtn.disabled = false;
@@ -7129,8 +7236,10 @@ class CWMApp {
           !p.dirExists ? '<span class="discover-badge discover-badge-missing">missing</span>' : '',
         ].filter(Boolean).join(' ');
 
-        const latestSessionId = p.sessions && p.sessions.length > 0 ? p.sessions[0].name : '';
-        return `<div class="discover-row" data-path="${this.escapeHtml(p.realPath)}" data-name="${this.escapeHtml(name)}" data-session-id="${this.escapeHtml(latestSessionId)}">
+        const latestSession = p.sessions && p.sessions.length > 0 ? p.sessions[0] : null;
+        const latestSessionId = latestSession ? latestSession.name : '';
+        const latestSessionTitle = latestSession ? (latestSession.title || '') : '';
+        return `<div class="discover-row" data-path="${this.escapeHtml(p.realPath)}" data-name="${this.escapeHtml(name)}" data-session-id="${this.escapeHtml(latestSessionId)}" data-session-title="${this.escapeHtml(latestSessionTitle)}">
           <div class="discover-check">
             <input type="checkbox" class="discover-cb" ${p.dirExists ? 'checked' : ''} ${!p.dirExists ? 'disabled' : ''}>
           </div>
@@ -7192,7 +7301,7 @@ class CWMApp {
         const cb = row.querySelector('.discover-cb');
         if (cb && cb.checked) {
           selected.push({
-            name: row.dataset.name,
+            name: row.dataset.sessionTitle || row.dataset.name,
             path: row.dataset.path,
             sessionId: row.dataset.sessionId || '',
           });
@@ -9445,9 +9554,9 @@ class CWMApp {
         const path = p.realPath || '';
         // Match against project name, encoded name, or path
         if (name.toLowerCase().includes(query) || encoded.toLowerCase().includes(query) || path.toLowerCase().includes(query)) return true;
-        // Match against any session ID/name within this project
+        // Match against any session ID, title, or Claude custom-title within this project
         const allSessions = p.sessions || [];
-        return allSessions.some(s => (s.name || '').toLowerCase().includes(query));
+        return allSessions.some(s => (s.name || '').toLowerCase().includes(query) || (s.title || '').toLowerCase().includes(query));
       });
     }
 
@@ -9478,8 +9587,9 @@ class CWMApp {
         if (!projectMatches) {
           sessions = sessions.filter(s => {
             const sName = (s.name || '').toLowerCase();
+            const sClaudeTitle = (s.title || '').toLowerCase();
             const sTitle = (this.getProjectSessionTitle(s.name) || '').toLowerCase();
-            return sName.includes(query) || sTitle.includes(query);
+            return sName.includes(query) || sClaudeTitle.includes(query) || sTitle.includes(query);
           });
         }
       }
@@ -9487,13 +9597,19 @@ class CWMApp {
       // Build session sub-items
       const sessionItems = sessions.map(s => {
         const sessName = s.name || 'unnamed';
+        const claudeTitle = s.title || null;
+        if (claudeTitle && !this.getProjectSessionTitle(sessName)) {
+          const titles = JSON.parse(localStorage.getItem('cwm_projectSessionTitles') || '{}');
+          titles[sessName] = claudeTitle;
+          localStorage.setItem('cwm_projectSessionTitles', JSON.stringify(titles));
+        }
         const storedTitle = this.getProjectSessionTitle(sessName);
-        const displayName = storedTitle || (sessName.length > 24 ? sessName.substring(0, 24) + '...' : sessName);
+        const displayName = storedTitle || claudeTitle || (sessName.length > 24 ? sessName.substring(0, 24) + '...' : sessName);
         const sessSize = s.size ? this.formatSize(s.size) : '';
         const sessTime = s.modified ? this.relativeTime(s.modified) : '';
-        // Tooltip: show title + session ID so user sees both on hover
-        const tooltip = storedTitle
-          ? `${storedTitle}\n\nSession: ${sessName}`
+        const effectiveTitle = storedTitle || claudeTitle;
+        const tooltip = effectiveTitle
+          ? `${effectiveTitle}\n\nSession: ${sessName}`
           : sessName;
         return `<div class="project-session-item" draggable="true" data-session-name="${this.escapeHtml(sessName)}" data-project-path="${this.escapeHtml(p.realPath || '')}" data-project-encoded="${this.escapeHtml(encoded)}" title="${this.escapeHtml(tooltip)}">
           <span class="project-session-name">${this.escapeHtml(displayName)}</span>
@@ -9978,6 +10094,24 @@ class CWMApp {
           });
         }
 
+        // Pinned notes (bookmark) button — shows modal of all pinned notes for this pane's session
+        const pinDocBtn = pane.querySelector('.terminal-pane-pinnedoc');
+        if (pinDocBtn) {
+          pinDocBtn.addEventListener('click', (e) => {
+            e.stopPropagation();
+            this._showPinnedNotesModal(slotIdx);
+          });
+        }
+
+        // Pane view back button — restores terminal after a non-terminal view (E003)
+        const backBtn = pane.querySelector('.pane-view-back');
+        if (backBtn) {
+          backBtn.addEventListener('click', (e) => {
+            e.stopPropagation();
+            if (this.restoreTerminalInPane) this.restoreTerminalInPane(slotIdx);
+          });
+        }
+
         // Drag-to-reposition: make pane header draggable to swap panes
         const header = pane.querySelector('.terminal-pane-header');
         if (header) {
@@ -10166,6 +10300,9 @@ class CWMApp {
     if (this.state.settings.paneColorHighlights) {
       this.renderWorkspaces();
     }
+
+    // Refresh pinned-notes badge for this pane now that a session is loaded
+    this._refreshPanePin(slotIdx);
   }
 
   /**
@@ -10206,6 +10343,31 @@ class CWMApp {
     el.innerHTML = `<span class="activity-dot ${dotClass}"></span>${label}${detail}`;
   }
 
+  /**
+   * Show a modal listing all pinned notes for the session currently open in the given pane slot.
+   * Fetches notes from the backend and displays them with timestamps.
+   * If there are no pinned notes, shows an info toast instead.
+   * @param {number} slotIdx - The terminal pane slot index
+   */
+  async _showPinnedNotesModal(slotIdx) {
+    const tp = this.terminalPanes[slotIdx];
+    if (!tp || !tp.sessionId) return;
+    const ws = this.state.activeWorkspace;
+    if (!ws) return;
+    const data = await this.api('GET', `/api/workspaces/${ws.id}/pinned-notes/${tp.sessionId}`);
+    const notes = data.notes || [];
+    if (notes.length === 0) {
+      this.showToast('No pinned notes for this session', 'info');
+      return;
+    }
+    const body = notes.map(n => `[${n.timestamp}]\n${n.text}`).join('\n\n---\n\n');
+    await this.showPromptModal({
+      title: 'Pinned Notes',
+      fields: [{ key: 'body', type: 'textarea', value: body }],
+      confirmText: 'Close',
+    });
+  }
+
   showTerminalContextMenu(slotIdx, x, y) {
     const tp = this.terminalPanes[slotIdx];
     if (!tp) return;
@@ -10227,6 +10389,26 @@ class CWMApp {
       });
     }
 
+    // Save to Notes (only show when there's a selection)
+    if (tp.term && tp.term.hasSelection()) {
+      items.push({
+        label: 'Save to Notes', icon: '&#128221;', action: async () => {
+          const selected = tp.term.getSelection();
+          const ws = this.state.activeWorkspace;
+          if (!ws) { this.showToast('No active workspace', 'error'); return; }
+          const result = await this.showPromptModal({
+            title: 'Save to Notes',
+            fields: [{ key: 'text', type: 'textarea', value: selected }],
+            confirmText: 'Save Note'
+          });
+          if (!result) return;
+          await this.api('POST', '/api/workspaces/' + ws.id + '/docs/notes', { text: result.text.trim() });
+          this.loadDocs();
+          this.showToast('Saved to Notes', 'success');
+        },
+      });
+    }
+
     // Paste from clipboard
     items.push({
       label: 'Paste', icon: '&#128203;', action: () => {
@@ -10992,6 +11174,15 @@ class CWMApp {
       tp.setFocused(true);
       tp.focus();
     }
+
+    // If Tasks > td tab is visible and not manually pinned, update to this pane's project
+    if (this._activeTasksTab === 'td' && !this._tdPanelDirPinned) {
+      const newDir = tp && tp.spawnOpts && tp.spawnOpts.cwd ? tp.spawnOpts.cwd : null;
+      if (newDir && newDir !== this._tdPanelDir) {
+        this._tdPanelDir = newDir;
+        this.renderTasksTdPanel();
+      }
+    }
   }
 
   /**
@@ -11810,16 +12001,54 @@ class CWMApp {
     if (this.els.docsRoadmapCount) this.els.docsRoadmapCount.textContent = (docs.roadmap || []).length;
     if (this.els.docsRulesCount) this.els.docsRulesCount.textContent = (docs.rules || []).length;
 
-    // Notes
+    // Notes — built with DOM APIs to support pin buttons safely (no user HTML injected)
     if (this.els.docsNotesList) {
-      this.els.docsNotesList.innerHTML = (docs.notes || []).length > 0
-        ? (docs.notes || []).map((n, i) => `
-          <div class="docs-item" data-index="${i}">
-            <span class="docs-note-time">${this.escapeHtml(n.timestamp || '')}</span>
-            <span class="docs-note-text">${this.escapeHtml(n.text)}</span>
-            <button class="docs-item-delete btn btn-ghost btn-icon btn-sm" data-section="notes" data-index="${i}" title="Remove">&times;</button>
-          </div>`).join('')
-        : '<div class="docs-empty">No notes yet. Click + to add one.</div>';
+      const notes = docs.notes || [];
+      while (this.els.docsNotesList.firstChild) {
+        this.els.docsNotesList.removeChild(this.els.docsNotesList.firstChild);
+      }
+      if (notes.length === 0) {
+        const empty = document.createElement('div');
+        empty.className = 'docs-empty';
+        empty.textContent = 'No notes yet. Click + to add one.';
+        this.els.docsNotesList.appendChild(empty);
+      } else {
+        notes.forEach((n, noteIndex) => {
+          const noteRow = document.createElement('div');
+          noteRow.className = 'docs-item';
+          noteRow.dataset.index = noteIndex;
+
+          const timeSpan = document.createElement('span');
+          timeSpan.className = 'docs-note-time';
+          timeSpan.textContent = n.timestamp || '';
+          noteRow.appendChild(timeSpan);
+
+          const textSpan = document.createElement('span');
+          textSpan.className = 'docs-note-text';
+          textSpan.textContent = n.text;
+          noteRow.appendChild(textSpan);
+
+          const pinBtn = document.createElement('button');
+          pinBtn.className = 'doc-pin-btn btn btn-ghost btn-icon btn-sm';
+          pinBtn.textContent = '📌';
+          pinBtn.title = 'Pin to focused terminal session';
+          pinBtn.addEventListener('click', (e) => {
+            e.stopPropagation();
+            this._toggleNotePin(noteIndex, pinBtn);
+          });
+          noteRow.appendChild(pinBtn);
+
+          const delBtn = document.createElement('button');
+          delBtn.className = 'docs-item-delete btn btn-ghost btn-icon btn-sm';
+          delBtn.dataset.section = 'notes';
+          delBtn.dataset.index = noteIndex;
+          delBtn.title = 'Remove';
+          delBtn.textContent = '×';
+          noteRow.appendChild(delBtn);
+
+          this.els.docsNotesList.appendChild(noteRow);
+        });
+      }
     }
 
     // Goals
@@ -11971,6 +12200,52 @@ class CWMApp {
     }
   }
 
+  /**
+   * Toggle a pinned note on the currently focused terminal pane session.
+   * @param {number} noteIndex - 0-based index of the note in the workspace docs.notes array
+   * @param {HTMLButtonElement} buttonEl - The pin button element to update visually
+   */
+  async _toggleNotePin(noteIndex, buttonEl) {
+    const slot = this._activeTerminalSlot;
+    const tp = (slot !== null && slot !== undefined) ? this.terminalPanes[slot] : null;
+    if (!tp || !tp.sessionId) {
+      this.showToast('Focus a terminal pane first', 'error');
+      return;
+    }
+    const ws = this.state.activeWorkspace;
+    if (!ws) return;
+    const isPinned = buttonEl.classList.contains('pinned');
+    const action = isPinned ? 'unpin' : 'pin';
+    await this.api('POST', `/api/workspaces/${ws.id}/pinned-notes`, {
+      sessionId: tp.sessionId,
+      noteIndex,
+      action
+    });
+    buttonEl.classList.toggle('pinned', !isPinned);
+    await this._refreshPanePin(slot);
+  }
+
+  /**
+   * Refresh the pinned-notes badge on a terminal pane header.
+   * Shows/hides the badge button and updates the count label.
+   * @param {number} slotIdx - Terminal pane slot index (0-based)
+   */
+  async _refreshPanePin(slotIdx) {
+    const tp = this.terminalPanes[slotIdx];
+    if (!tp || !tp.sessionId) return;
+    const ws = this.state.activeWorkspace;
+    if (!ws) return;
+    const data = await this.api('GET', `/api/workspaces/${ws.id}/pinned-notes`);
+    const pins = data[tp.sessionId] || [];
+    const paneEl = document.getElementById(`term-pane-${slotIdx}`);
+    if (!paneEl) return;
+    const pinDocBtn = paneEl.querySelector('.terminal-pane-pinnedoc');
+    if (!pinDocBtn) return;
+    pinDocBtn.hidden = pins.length === 0;
+    const countEl = pinDocBtn.querySelector('.pane-pin-count');
+    if (countEl) countEl.textContent = pins.length > 0 ? pins.length : '';
+  }
+
 
   /* ═══════════════════════════════════════════════════════════
      TD ISSUES — docs panel integration

package/src/web/public/index.html

@@ -558,6 +558,7 @@
                   <path d="M5.5 0a.5.5 0 0 1 .5.5v4A1.5 1.5 0 0 1 4.5 6h-4a.5.5 0 0 1 0-1h4a.5.5 0 0 0 .5-.5v-4a.5.5 0 0 1 .5-.5zm5 0a.5.5 0 0 1 .5.5v4a.5.5 0 0 0 .5.5h4a.5.5 0 0 1 0 1h-4A1.5 1.5 0 0 1 10 4.5v-4a.5.5 0 0 1 .5-.5zM0 10.5a.5.5 0 0 1 .5-.5h4A1.5 1.5 0 0 1 6 11.5v4a.5.5 0 0 1-1 0v-4a.5.5 0 0 0-.5-.5h-4a.5.5 0 0 1-.5-.5zm10 1a1.5 1.5 0 0 1 1.5-1.5h4a.5.5 0 0 1 0 1h-4a.5.5 0 0 0-.5.5v4a.5.5 0 0 1-1 0v-4z"/>
                 </svg>
               </button>
+              <button class="terminal-pane-pinnedoc btn btn-ghost btn-icon btn-sm" title="Pinned notes" hidden>📌<span class="pane-pin-count"></span></button>
               <button class="terminal-pane-close btn btn-ghost btn-icon btn-sm" hidden>
                 <svg width="14" height="14" viewBox="0 0 16 16" fill="currentColor"><path d="M4.646 4.646a.5.5 0 0 1 .708 0L8 7.293l2.646-2.647a.5.5 0 0 1 .708.708L8.707 8l2.647 2.646a.5.5 0 0 1-.708.708L8 8.707l-2.646 2.647a.5.5 0 0 1-.708-.708L7.293 8 4.646 5.354a.5.5 0 0 1 0-.708z"/></svg>
               </button>
@@ -604,6 +605,7 @@
                   <path d="M5.5 0a.5.5 0 0 1 .5.5v4A1.5 1.5 0 0 1 4.5 6h-4a.5.5 0 0 1 0-1h4a.5.5 0 0 0 .5-.5v-4a.5.5 0 0 1 .5-.5zm5 0a.5.5 0 0 1 .5.5v4a.5.5 0 0 0 .5.5h4a.5.5 0 0 1 0 1h-4A1.5 1.5 0 0 1 10 4.5v-4a.5.5 0 0 1 .5-.5zM0 10.5a.5.5 0 0 1 .5-.5h4A1.5 1.5 0 0 1 6 11.5v4a.5.5 0 0 1-1 0v-4a.5.5 0 0 0-.5-.5h-4a.5.5 0 0 1-.5-.5zm10 1a1.5 1.5 0 0 1 1.5-1.5h4a.5.5 0 0 1 0 1h-4a.5.5 0 0 0-.5.5v4a.5.5 0 0 1-1 0v-4z"/>
                 </svg>
               </button>
+              <button class="terminal-pane-pinnedoc btn btn-ghost btn-icon btn-sm" title="Pinned notes" hidden>📌<span class="pane-pin-count"></span></button>
               <button class="terminal-pane-close btn btn-ghost btn-icon btn-sm" hidden>
                 <svg width="14" height="14" viewBox="0 0 16 16" fill="currentColor"><path d="M4.646 4.646a.5.5 0 0 1 .708 0L8 7.293l2.646-2.647a.5.5 0 0 1 .708.708L8.707 8l2.647 2.646a.5.5 0 0 1-.708.708L8 8.707l-2.646 2.647a.5.5 0 0 1-.708-.708L7.293 8 4.646 5.354a.5.5 0 0 1 0-.708z"/></svg>
               </button>
@@ -650,6 +652,7 @@
                   <path d="M5.5 0a.5.5 0 0 1 .5.5v4A1.5 1.5 0 0 1 4.5 6h-4a.5.5 0 0 1 0-1h4a.5.5 0 0 0 .5-.5v-4a.5.5 0 0 1 .5-.5zm5 0a.5.5 0 0 1 .5.5v4a.5.5 0 0 0 .5.5h4a.5.5 0 0 1 0 1h-4A1.5 1.5 0 0 1 10 4.5v-4a.5.5 0 0 1 .5-.5zM0 10.5a.5.5 0 0 1 .5-.5h4A1.5 1.5 0 0 1 6 11.5v4a.5.5 0 0 1-1 0v-4a.5.5 0 0 0-.5-.5h-4a.5.5 0 0 1-.5-.5zm10 1a1.5 1.5 0 0 1 1.5-1.5h4a.5.5 0 0 1 0 1h-4a.5.5 0 0 0-.5.5v4a.5.5 0 0 1-1 0v-4z"/>
                 </svg>
               </button>
+              <button class="terminal-pane-pinnedoc btn btn-ghost btn-icon btn-sm" title="Pinned notes" hidden>📌<span class="pane-pin-count"></span></button>
               <button class="terminal-pane-close btn btn-ghost btn-icon btn-sm" hidden>
                 <svg width="14" height="14" viewBox="0 0 16 16" fill="currentColor"><path d="M4.646 4.646a.5.5 0 0 1 .708 0L8 7.293l2.646-2.647a.5.5 0 0 1 .708.708L8.707 8l2.647 2.646a.5.5 0 0 1-.708.708L8 8.707l-2.646 2.647a.5.5 0 0 1-.708-.708L7.293 8 4.646 5.354a.5.5 0 0 1 0-.708z"/></svg>
               </button>
@@ -696,6 +699,7 @@
                   <path d="M5.5 0a.5.5 0 0 1 .5.5v4A1.5 1.5 0 0 1 4.5 6h-4a.5.5 0 0 1 0-1h4a.5.5 0 0 0 .5-.5v-4a.5.5 0 0 1 .5-.5zm5 0a.5.5 0 0 1 .5.5v4a.5.5 0 0 0 .5.5h4a.5.5 0 0 1 0 1h-4A1.5 1.5 0 0 1 10 4.5v-4a.5.5 0 0 1 .5-.5zM0 10.5a.5.5 0 0 1 .5-.5h4A1.5 1.5 0 0 1 6 11.5v4a.5.5 0 0 1-1 0v-4a.5.5 0 0 0-.5-.5h-4a.5.5 0 0 1-.5-.5zm10 1a1.5 1.5 0 0 1 1.5-1.5h4a.5.5 0 0 1 0 1h-4a.5.5 0 0 0-.5.5v4a.5.5 0 0 1-1 0v-4z"/>
                 </svg>
               </button>
+              <button class="terminal-pane-pinnedoc btn btn-ghost btn-icon btn-sm" title="Pinned notes" hidden>📌<span class="pane-pin-count"></span></button>
               <button class="terminal-pane-close btn btn-ghost btn-icon btn-sm" hidden>
                 <svg width="14" height="14" viewBox="0 0 16 16" fill="currentColor"><path d="M4.646 4.646a.5.5 0 0 1 .708 0L8 7.293l2.646-2.647a.5.5 0 0 1 .708.708L8.707 8l2.647 2.646a.5.5 0 0 1-.708.708L8 8.707l-2.646 2.647a.5.5 0 0 1-.708-.708L7.293 8 4.646 5.354a.5.5 0 0 1 0-.708z"/></svg>
               </button>
@@ -742,6 +746,7 @@
                   <path d="M5.5 0a.5.5 0 0 1 .5.5v4A1.5 1.5 0 0 1 4.5 6h-4a.5.5 0 0 1 0-1h4a.5.5 0 0 0 .5-.5v-4a.5.5 0 0 1 .5-.5zm5 0a.5.5 0 0 1 .5.5v4a.5.5 0 0 0 .5.5h4a.5.5 0 0 1 0 1h-4A1.5 1.5 0 0 1 10 4.5v-4a.5.5 0 0 1 .5-.5zM0 10.5a.5.5 0 0 1 .5-.5h4A1.5 1.5 0 0 1 6 11.5v4a.5.5 0 0 1-1 0v-4a.5.5 0 0 0-.5-.5h-4a.5.5 0 0 1-.5-.5zm10 1a1.5 1.5 0 0 1 1.5-1.5h4a.5.5 0 0 1 0 1h-4a.5.5 0 0 0-.5.5v4a.5.5 0 0 1-1 0v-4z"/>
                 </svg>
               </button>
+              <button class="terminal-pane-pinnedoc btn btn-ghost btn-icon btn-sm" title="Pinned notes" hidden>📌<span class="pane-pin-count"></span></button>
               <button class="terminal-pane-close btn btn-ghost btn-icon btn-sm" hidden>
                 <svg width="14" height="14" viewBox="0 0 16 16" fill="currentColor"><path d="M4.646 4.646a.5.5 0 0 1 .708 0L8 7.293l2.646-2.647a.5.5 0 0 1 .708.708L8.707 8l2.647 2.646a.5.5 0 0 1-.708.708L8 8.707l-2.646 2.647a.5.5 0 0 1-.708-.708L7.293 8 4.646 5.354a.5.5 0 0 1 0-.708z"/></svg>
               </button>
@@ -788,6 +793,7 @@
                   <path d="M5.5 0a.5.5 0 0 1 .5.5v4A1.5 1.5 0 0 1 4.5 6h-4a.5.5 0 0 1 0-1h4a.5.5 0 0 0 .5-.5v-4a.5.5 0 0 1 .5-.5zm5 0a.5.5 0 0 1 .5.5v4a.5.5 0 0 0 .5.5h4a.5.5 0 0 1 0 1h-4A1.5 1.5 0 0 1 10 4.5v-4a.5.5 0 0 1 .5-.5zM0 10.5a.5.5 0 0 1 .5-.5h4A1.5 1.5 0 0 1 6 11.5v4a.5.5 0 0 1-1 0v-4a.5.5 0 0 0-.5-.5h-4a.5.5 0 0 1-.5-.5zm10 1a1.5 1.5 0 0 1 1.5-1.5h4a.5.5 0 0 1 0 1h-4a.5.5 0 0 0-.5.5v4a.5.5 0 0 1-1 0v-4z"/>
                 </svg>
               </button>
+              <button class="terminal-pane-pinnedoc btn btn-ghost btn-icon btn-sm" title="Pinned notes" hidden>📌<span class="pane-pin-count"></span></button>
               <button class="terminal-pane-close btn btn-ghost btn-icon btn-sm" hidden>
                 <svg width="14" height="14" viewBox="0 0 16 16" fill="currentColor"><path d="M4.646 4.646a.5.5 0 0 1 .708 0L8 7.293l2.646-2.647a.5.5 0 0 1 .708.708L8.707 8l2.647 2.646a.5.5 0 0 1-.708.708L8 8.707l-2.646 2.647a.5.5 0 0 1-.708-.708L7.293 8 4.646 5.354a.5.5 0 0 1 0-.708z"/></svg>
               </button>

package/src/web/public/styles.css

@@ -4313,6 +4313,19 @@ textarea.input {
   color: var(--red);
 }
 
+.doc-pin-btn {
+  opacity: 0.4;
+  transition: opacity 0.15s;
+  flex-shrink: 0;
+  cursor: pointer;
+}
+
+.doc-pin-btn:hover,
+.doc-pin-btn.pinned {
+  opacity: 1;
+  color: var(--mauve);
+}
+
 /* Roadmap items */
 .roadmap-status-dot {
   background: none;
@@ -5031,6 +5044,15 @@ textarea.input {
 @media (prefers-reduced-motion: reduce) {
   .terminal-pane-mic.mic-active { animation: none; }
 }
+.pane-pin-count {
+  font-size: 10px;
+  background: var(--mauve);
+  color: var(--base);
+  border-radius: 8px;
+  padding: 0 4px;
+  margin-left: 2px;
+  font-weight: 600;
+}
 /* Voice interim transcript overlay - shown at bottom of terminal pane during recording */
 .voice-interim-overlay {
   position: absolute;
@@ -6321,6 +6343,20 @@ html.activity-indicators-disabled .terminal-pane-activity {
   flex: 1;
   overflow-y: auto;
   min-height: 0;
+  display: flex;
+  flex-direction: column;
+}
+/* td panel needs its toolbar fixed at top, list scrolls below */
+#tasks-td-panel {
+  display: flex;
+  flex-direction: column;
+  overflow: hidden;
+}
+#tasks-td-panel .tasks-td-toolbar { flex-shrink: 0; }
+#tasks-td-panel .tasks-td-group-header,
+#tasks-td-panel .tasks-td-row,
+#tasks-td-panel .tasks-placeholder {
+  flex-shrink: 0;
 }
 
 /* ── Placeholder / empty states ──────────────────────── */
@@ -6394,6 +6430,40 @@ html.activity-indicators-disabled .terminal-pane-activity {
 .td-priority-badge.priority-p2 { background: var(--yellow); color: var(--base); }
 .td-priority-badge.priority-p3 { background: var(--surface2); color: var(--text); }
 
+/* ── td panel project switcher toolbar ───────────────── */
+.tasks-td-toolbar {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 6px 12px;
+  border-bottom: 1px solid var(--surface1);
+  background: var(--mantle);
+  flex-shrink: 0;
+}
+.tasks-td-toolbar-label {
+  font-size: 11px;
+  color: var(--subtext0);
+  font-weight: 600;
+  white-space: nowrap;
+}
+.tasks-td-project-select {
+  flex: 1;
+  font-size: 12px;
+  background: var(--surface0);
+  color: var(--text);
+  border: 1px solid var(--surface2);
+  border-radius: 4px;
+  padding: 2px 6px;
+  min-width: 0;
+  cursor: pointer;
+}
+.tasks-td-project-select:focus { outline: none; border-color: var(--mauve); }
+.tasks-td-refresh {
+  font-size: 14px;
+  padding: 2px 6px;
+  flex-shrink: 0;
+}
+
 /* ─── New Task Dialog form elements ──────────────────── */
 .form-group {
   margin-bottom: 14px;

package/src/web/server.js

@@ -750,6 +750,151 @@ app.delete('/api/workspaces/:id/docs/:section/:index', requireAuth, (req, res) =
   return res.json({ success: true });
 });
 
+// ──────────────────────────────────────────────────────────
+//  PINNED NOTES
+//  Per-session pinned note indices, persisted as JSON files
+//  under ~/.myrlin/pinned-notes/{workspaceId}.json
+//  Format: { [sessionId]: [noteIndex, ...] }
+// ──────────────────────────────────────────────────────────
+
+/**
+ * Return the directory used to store pinned-note files.
+ * Creates it if it does not already exist.
+ * @returns {string}
+ */
+function getPinnedNotesDir() {
+  const dir = path.join(getDataDir(), 'pinned-notes');
+  require('fs').mkdirSync(dir, { recursive: true });
+  return dir;
+}
+
+/**
+ * Read the pinned-notes map for a workspace from disk.
+ * Returns {} if the file does not exist or cannot be parsed.
+ * @param {string} workspaceId
+ * @returns {{ [sessionId: string]: number[] }}
+ */
+function getPinnedNotes(workspaceId) {
+  const file = path.join(getPinnedNotesDir(), `${workspaceId}.json`);
+  try {
+    const raw = require('fs').readFileSync(file, 'utf-8');
+    return JSON.parse(raw);
+  } catch (_) {
+    return {};
+  }
+}
+
+/**
+ * Atomically write the pinned-notes map for a workspace.
+ * Writes to a temp file then renames to ensure no partial reads.
+ * @param {string} workspaceId
+ * @param {{ [sessionId: string]: number[] }} data
+ */
+function savePinnedNotes(workspaceId, data) {
+  const fs = require('fs');
+  const dir = getPinnedNotesDir();
+  const file = path.join(dir, `${workspaceId}.json`);
+  const tmp = path.join(dir, `.tmp.${Date.now()}.${workspaceId}.json`);
+  fs.writeFileSync(tmp, JSON.stringify(data, null, 2), 'utf-8');
+  fs.renameSync(tmp, file);
+}
+
+/**
+ * Add noteIndex to the pinned list for sessionId, deduplicating.
+ * @param {string} wsId
+ * @param {string} sessionId
+ * @param {number} noteIndex
+ */
+function pin(wsId, sessionId, noteIndex) {
+  const data = getPinnedNotes(wsId);
+  const existing = data[sessionId] || [];
+  if (!existing.includes(noteIndex)) {
+    existing.push(noteIndex);
+  }
+  data[sessionId] = existing;
+  savePinnedNotes(wsId, data);
+}
+
+/**
+ * Remove noteIndex from the pinned list for sessionId.
+ * @param {string} wsId
+ * @param {string} sessionId
+ * @param {number} noteIndex
+ */
+function unpin(wsId, sessionId, noteIndex) {
+  const data = getPinnedNotes(wsId);
+  if (!data[sessionId]) return;
+  data[sessionId] = data[sessionId].filter(i => i !== noteIndex);
+  savePinnedNotes(wsId, data);
+}
+
+/**
+ * GET /api/workspaces/:id/pinned-notes
+ * Returns the full pinned-notes map: { [sessionId]: [noteIndex, ...] }
+ */
+app.get('/api/workspaces/:id/pinned-notes', requireAuth, (req, res) => {
+  const store = getStore();
+  const ws = store.getWorkspace(req.params.id);
+  if (!ws) return res.status(404).json({ error: 'Workspace not found.' });
+
+  const data = getPinnedNotes(req.params.id);
+  return res.json(data);
+});
+
+/**
+ * POST /api/workspaces/:id/pinned-notes
+ * Body: { sessionId, noteIndex, action: 'pin' | 'unpin' }
+ * Pins or unpins a note index for a session.
+ */
+app.post('/api/workspaces/:id/pinned-notes', requireAuth, (req, res) => {
+  const store = getStore();
+  const ws = store.getWorkspace(req.params.id);
+  if (!ws) return res.status(404).json({ error: 'Workspace not found.' });
+
+  const { sessionId, noteIndex, action } = req.body || {};
+  if (!sessionId || noteIndex === undefined || noteIndex === null) {
+    return res.status(400).json({ error: 'sessionId and noteIndex are required.' });
+  }
+  const idx = parseInt(noteIndex, 10);
+  if (isNaN(idx) || idx < 0) {
+    return res.status(400).json({ error: 'noteIndex must be a non-negative integer.' });
+  }
+
+  if (action === 'unpin') {
+    unpin(req.params.id, sessionId, idx);
+  } else {
+    pin(req.params.id, sessionId, idx);
+  }
+  return res.json({ success: true });
+});
+
+/**
+ * GET /api/workspaces/:id/pinned-notes/:sessionId
+ * Returns resolved note objects for the session's pinned indices.
+ * Response: { notes: [{ text, timestamp }, ...] }
+ * Returns empty array (not 404) if the session has no pins.
+ */
+app.get('/api/workspaces/:id/pinned-notes/:sessionId', requireAuth, (req, res) => {
+  const store = getStore();
+  const ws = store.getWorkspace(req.params.id);
+  if (!ws) return res.status(404).json({ error: 'Workspace not found.' });
+
+  const data = getPinnedNotes(req.params.id);
+  const indices = data[req.params.sessionId] || [];
+
+  if (indices.length === 0) {
+    return res.json({ notes: [] });
+  }
+
+  const docs = store.getWorkspaceDocs(req.params.id);
+  const allNotes = (docs && docs.notes) ? docs.notes : [];
+  const notes = indices
+    .filter(i => i >= 0 && i < allNotes.length)
+    .map(i => ({ text: allNotes[i].text, timestamp: allNotes[i].timestamp }));
+
+  return res.json({ notes });
+});
+
 // ──────────────────────────────────────────────────────────
 //  TD TASK INTEGRATION
 //  These endpoints bridge myrlin's docs panel to the `td` CLI
@@ -858,6 +1003,39 @@ app.put('/api/workspaces/:id/td/repodir', requireAuth, (req, res) => {
   return res.json({ success: true, repoDir });
 });
 
+/**
+ * GET /api/td/projects
+ * Return all workspaces that have td initialized, with their resolved repo dirs.
+ * Used by the Tasks > td panel dropdown.
+ */
+app.get('/api/td/projects', requireAuth, (req, res) => {
+  const store = getStore();
+  const allWorkspaces = store.getAllWorkspacesList();
+  const projects = [];
+  for (const ws of allWorkspaces) {
+    const repoDir = resolveTdRepoDir(store, ws.id);
+    if (repoDir && td.isInitialized(repoDir)) {
+      projects.push({ name: ws.name, repoDir, workspaceId: ws.id });
+    }
+  }
+  return res.json({ projects });
+});
+
+/**
+ * GET /api/td/issues?dir=<path>
+ * List td issues for an explicit repo directory (not workspace-scoped).
+ * Allows the Tasks panel to show issues for whatever dir is focused.
+ * Query: ?dir=<absolute-path>, ?status=open|in_progress|...
+ */
+app.get('/api/td/issues', requireAuth, async (req, res) => {
+  const dir = req.query.dir ? decodeURIComponent(req.query.dir) : null;
+  if (!dir) return res.status(400).json({ error: 'dir query parameter required.' });
+  if (!td.isInitialized(dir)) return res.status(400).json({ error: 'td is not initialized in this directory.' });
+  const filters = req.query.status ? { status: req.query.status } : {};
+  const issues = await td.listIssues(dir, filters, getTdBinary());
+  return res.json({ issues, repoDir: dir });
+});
+
 /**
  * GET /api/workspaces/:id/td/issues
  * List td issues for this workspace's repo.
@@ -1468,6 +1646,13 @@ app.get('/api/discover', requireAuth, (req, res) => {
         // skip if can't read
       }
 
+      // Extract the last custom-title from each JSONL file
+      const sessionTitles = {};
+      for (const sf of sessionFiles) {
+        const title = extractCustomTitle(path.join(projectDir, sf.name + '.jsonl'));
+        if (title) sessionTitles[sf.name] = title;
+      }
+
       // Check for CLAUDE.md
       let hasClaudeMd = false;
       try {
@@ -1494,7 +1679,7 @@ app.get('/api/discover', requireAuth, (req, res) => {
         sessionCount: sessionFiles.length,
         totalSize,
         lastActive: sessionFiles.length > 0 ? sessionFiles[0].modified : null,
-        sessions: sessionFiles.map(s => ({ name: s.name, modified: s.modified, size: s.size })),
+        sessions: sessionFiles.map(s => ({ name: s.name, modified: s.modified, size: s.size, title: sessionTitles[s.name] || null })),
       });
     }
 
@@ -1623,48 +1808,34 @@ function greedyFsWalk(root, tokens) {
  */
 function getOriginalPathFromJsonl(projectDir) {
   try {
-    const files = fs.readdirSync(projectDir);
-    // Find the first .jsonl file (skip subdirectories)
-    const jsonlFile = files.find(f => {
+    const jsonlFiles = fs.readdirSync(projectDir).filter(f => {
       if (!f.endsWith('.jsonl')) return false;
-      try {
-        return !fs.statSync(path.join(projectDir, f)).isDirectory();
-      } catch (_) {
-        return false;
-      }
+      try { return !fs.statSync(path.join(projectDir, f)).isDirectory(); } catch (_) { return false; }
     });
-    if (!jsonlFile) return null;
-
-    const jsonlPath = path.join(projectDir, jsonlFile);
-
-    // Only read first 4KB to find cwd field (avoids loading large files)
-    const fd = fs.openSync(jsonlPath, 'r');
-    const buffer = Buffer.alloc(4096);
-    let content;
-    try {
-      const bytesRead = fs.readSync(fd, buffer, 0, 4096, 0);
-      content = buffer.toString('utf-8', 0, bytesRead);
-    } finally {
-      fs.closeSync(fd);
-    }
 
-    // Parse first 3 lines to find cwd field
-    const lines = content.split('\n').slice(0, 3);
-    for (const line of lines) {
-      if (!line.trim()) continue;
+    // Try each file until one yields a cwd — stub sessions may lack it
+    for (const jsonlFile of jsonlFiles) {
       try {
-        const record = JSON.parse(line);
-        if (record.cwd && typeof record.cwd === 'string') {
-          return record.cwd;
+        const fd = fs.openSync(path.join(projectDir, jsonlFile), 'r');
+        let content;
+        try {
+          const buffer = Buffer.alloc(16384);
+          const bytesRead = fs.readSync(fd, buffer, 0, 16384, 0);
+          content = buffer.toString('utf-8', 0, bytesRead);
+        } finally {
+          fs.closeSync(fd);
         }
-      } catch (_) {
-        // Skip invalid JSON lines
-        continue;
-      }
+
+        for (const line of content.split('\n')) {
+          if (!line.includes('"cwd"')) continue;
+          try {
+            const record = JSON.parse(line);
+            if (record.cwd && typeof record.cwd === 'string') return record.cwd;
+          } catch (_) { continue; }
+        }
+      } catch (_) { continue; }
     }
-  } catch (_) {
-    // Silently fail and return null
-  }
+  } catch (_) {}
   return null;
 }
 
@@ -2346,7 +2517,7 @@ app.post('/api/search-conversations', requireAuth, async (req, res) => {
  */
 app.get('/api/keys/anthropic', requireAuth, (req, res) => {
   const store = getStore();
-  const key = (store.getState().settings || {}).anthropicApiKey || '';
+  const key = (store.state.settings || {}).anthropicApiKey || '';
   if (!key) return res.json({ configured: false, masked: null });
   const masked = '...' + key.slice(-8);
   return res.json({ configured: true, masked });
@@ -2382,7 +2553,7 @@ app.post('/api/ai/punctuate', requireAuth, async (req, res) => {
   }
 
   const store = getStore();
-  const apiKey = (store.getState().settings || {}).anthropicApiKey || '';
+  const apiKey = (store.state.settings || {}).anthropicApiKey || '';
   if (!apiKey) {
     return res.status(400).json({ error: 'No Anthropic API key configured' });
   }
@@ -2434,7 +2605,7 @@ app.post('/api/ai/find-session', requireAuth, async (req, res) => {
   }
 
   const store = getStore();
-  const apiKey = (store.getState().settings || {}).anthropicApiKey || '';
+  const apiKey = (store.state.settings || {}).anthropicApiKey || '';
 
   // Gather all metadata
   const workspaces = store.getAllWorkspacesList();
@@ -2453,6 +2624,7 @@ app.post('/api/ai/find-session', requireAuth, async (req, res) => {
         const name = getProjectDisplayName(d.name, realPath);
         let sessionCount = 0;
         let lastActive = null;
+        const sessionTitles = [];
         try {
           const files = fs.readdirSync(projectDir).filter(f => f.endsWith('.jsonl'));
           sessionCount = files.length;
@@ -2461,9 +2633,11 @@ app.post('/api/ai/find-session', requireAuth, async (req, res) => {
               const stat = fs.statSync(path.join(projectDir, f));
               if (!lastActive || stat.mtime > new Date(lastActive)) lastActive = stat.mtime;
             } catch (_) {}
+            const title = extractCustomTitle(path.join(projectDir, f));
+            if (title) sessionTitles.push(title);
           }
         } catch (_) {}
-        return { encodedName: d.name, name, path: realPath, sessionCount, lastActive };
+        return { encodedName: d.name, name, path: realPath, sessionCount, lastActive, sessionTitles };
       });
     } catch (_) {}
   }
@@ -2480,7 +2654,8 @@ app.post('/api/ai/find-session', requireAuth, async (req, res) => {
     })),
     discoveredProjects: discoveredProjects.map(p => ({
       encodedName: p.encodedName, name: p.name, path: p.path,
-      sessionCount: p.sessionCount, lastActive: p.lastActive
+      sessionCount: p.sessionCount, lastActive: p.lastActive,
+      sessionTitles: p.sessionTitles
     }))
   };
 
@@ -2544,9 +2719,9 @@ app.post('/api/ai/find-session', requireAuth, async (req, res) => {
       if (score > 0.2) scored.push({ type: 'session', id: s.id, confidence: score, summary: 'Matched by name, topic, or path' });
     }
     for (const p of discoveredProjects) {
-      const text = `${p.name} ${p.path}`.toLowerCase();
+      const text = `${p.name} ${p.path} ${(p.sessionTitles || []).join(' ')}`.toLowerCase();
       const score = terms.filter(t => text.includes(t)).length / terms.length;
-      if (score > 0.2) scored.push({ type: 'project', id: p.encodedName, confidence: score, summary: 'Matched by project name or path' });
+      if (score > 0.2) scored.push({ type: 'project', id: p.encodedName, confidence: score, summary: 'Matched by project name, path, or session title' });
     }
 
     scored.sort((a, b) => b.confidence - a.confidence);
@@ -7065,6 +7240,30 @@ function getSearchableFiles() {
  * @param {string} sessionId - Fallback UUID
  * @returns {string} A human-readable session name
  */
+function extractCustomTitle(jsonlPath) {
+  try {
+    const fd = fs.openSync(jsonlPath, 'r');
+    try {
+      const size = fs.fstatSync(fd).size;
+      const tailSize = Math.min(131072, size);
+      const buf = Buffer.alloc(tailSize);
+      fs.readSync(fd, buf, 0, tailSize, size - tailSize);
+      const lines = buf.toString('utf8').split('\n');
+      for (let i = lines.length - 1; i >= 0; i--) {
+        if (lines[i].includes('"custom-title"')) {
+          try {
+            const obj = JSON.parse(lines[i]);
+            if (obj.customTitle) return obj.customTitle;
+          } catch (_) {}
+        }
+      }
+    } finally {
+      fs.closeSync(fd);
+    }
+  } catch (_) {}
+  return null;
+}
+
 function extractSessionName(filePath, sessionId) {
   try {
     // Read just the first 10KB to find the first meaningful message
@@ -7876,4 +8075,5 @@ module.exports = {
   startServer,
   getPtyManager,
   structuredError,
+  extractCustomTitle,
 };