claude-code-kanban 2.1.0 → 2.2.0-rc.2

package/hooks/agent-spy.sh

@@ -16,6 +16,24 @@ eval "$(echo "$INPUT" | jq -r '
 
 [ -z "$SESSION_ID" ] && exit 0
 
+# Map session to custom task list on session start
+if [ "$EVENT" = "SessionStart" ]; then
+  TASK_LIST_ID="${CLAUDE_CODE_TASK_LIST_ID:-}"
+  if [ -n "$TASK_LIST_ID" ]; then
+    CWD=$(echo "$INPUT" | jq -r '.cwd // ""')
+    MAPS_DIR="$HOME/.claude/agent-activity/_task-maps"
+    mkdir -p "$MAPS_DIR"
+    MAP_FILE="$MAPS_DIR/$TASK_LIST_ID.json"
+    TMP_FILE="$MAP_FILE.$$"
+    TS=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+    EXISTING="{}"
+    [ -f "$MAP_FILE" ] && EXISTING=$(cat "$MAP_FILE")
+    echo "$EXISTING" | jq -c --arg sid "$SESSION_ID" --arg cwd "$CWD" --arg ts "$TS" \
+      '.[$sid] = {project: $cwd, updatedAt: $ts}' > "$TMP_FILE" && mv "$TMP_FILE" "$MAP_FILE"
+  fi
+  exit 0
+fi
+
 # PostToolUse / non-waiting PreToolUse: clear waiting state
 if [ "$EVENT" = "PostToolUse" ] || { [ "$EVENT" = "PreToolUse" ] && [ "$TOOL_NAME" != "AskUserQuestion" ]; }; then
   WFILE="$HOME/.claude/agent-activity/$SESSION_ID/_waiting.json"

package/install.js

@@ -17,6 +17,7 @@ const AGENT_ACTIVITY_DIR = path.join(CLAUDE_DIR, 'agent-activity');
 
 const HOOK_COMMAND = '~/.claude/hooks/agent-spy.sh';
 const HOOK_EVENTS = [
+  { event: 'SessionStart' },
   { event: 'SubagentStart' },
   { event: 'SubagentStop' },
   { event: 'TeammateIdle' },

package/lib/parsers.js

@@ -613,6 +613,41 @@ function findTerminatedTeammates(jsonlPath) {
   return terminated;
 }
 
+function extractPromptFromTranscript(jsonlPath) {
+  const { openSync, readSync, closeSync } = fs;
+  const MAX_READ = 65536;
+  const CHUNK = 4096;
+  const fd = openSync(jsonlPath, 'r');
+  try {
+    let accumulated = '';
+    const buf = Buffer.alloc(CHUNK);
+    while (accumulated.length < MAX_READ) {
+      const bytesRead = readSync(fd, buf, 0, CHUNK, null);
+      if (bytesRead === 0) break;
+      accumulated += buf.toString('utf8', 0, bytesRead);
+      const nlIdx = accumulated.indexOf('\n');
+      if (nlIdx === -1) continue;
+      const firstLine = accumulated.slice(0, nlIdx);
+      try {
+        const obj = JSON.parse(firstLine);
+        if (obj.type === 'user') {
+          const content = obj.message?.content;
+          if (typeof content === 'string') return content.slice(0, 500);
+          if (Array.isArray(content)) {
+            for (const b of content) {
+              if (b.type === 'text' && b.text) return b.text.slice(0, 500);
+            }
+          }
+        }
+      } catch (_) {}
+      break;
+    }
+  } finally {
+    closeSync(fd);
+  }
+  return null;
+}
+
 module.exports = {
   parseTask,
   parseAgent,
@@ -624,5 +659,6 @@ module.exports = {
   readRecentMessages,
   buildAgentProgressMap,
   readCompactSummaries,
-  findTerminatedTeammates
+  findTerminatedTeammates,
+  extractPromptFromTranscript
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-kanban",
-  "version": "2.1.0",
+  "version": "2.2.0-rc.2",
   "description": "A web-based Kanban board for viewing Claude Code tasks with agent teams support",
   "main": "server.js",
   "bin": {

package/public/app.js

@@ -29,6 +29,8 @@ let selectedSessionKbId = null;
 let sessionJustSelected = false;
 let agentLogMode = null;
 let agentLogSSE = null;
+let currentProjectPath = null;
+let currentProjectSessionIds = [];
 
 function getUrlState() {
   const params = new URLSearchParams(window.location.search);
@@ -41,12 +43,14 @@ function getUrlState() {
     owner: params.get('owner'),
     search: params.get('search'),
     messages: params.get('messages') === '1',
+    projectView: params.get('projectView'),
   };
 }
 
 function updateUrl() {
   const params = new URLSearchParams();
   if (viewMode === 'all') params.set('view', 'all');
+  if (viewMode === 'project' && currentProjectPath) params.set('projectView', btoa(currentProjectPath));
   if (currentSessionId) params.set('session', currentSessionId);
   if (sessionFilter !== 'active') params.set('filter', sessionFilter);
   if (sessionLimit !== '20') params.set('limit', sessionLimit);
@@ -70,6 +74,8 @@ function resetState() {
   viewMode = 'all';
   if (agentLogMode) exitAgentLogMode();
   currentSessionId = null;
+  currentProjectPath = null;
+  currentProjectSessionIds = [];
   const searchInput = document.getElementById('search-input');
   if (searchInput) searchInput.value = '';
   document.getElementById('search-clear-btn')?.classList.remove('visible');
@@ -410,6 +416,7 @@ let lastCurrentTasksHash = '';
 async function fetchTasks(sessionId) {
   try {
     viewMode = 'session';
+    document.getElementById('message-toggle')?.style.removeProperty('display');
     const res = await fetch(`/api/sessions/${sessionId}`);
 
     let newTasks;
@@ -483,6 +490,98 @@ async function fetchAgents(sessionId) {
   }
 }
 
+async function fetchProjectView(projectPath) {
+  viewMode = 'project';
+  currentProjectPath = projectPath;
+  currentSessionId = null;
+  currentMessages = [];
+  lastMessagesHash = '';
+  if (messagePanelOpen) toggleMessagePanel();
+  document.getElementById('message-toggle')?.style.setProperty('display', 'none');
+  const msgContent = document.getElementById('message-panel-content');
+  if (msgContent) msgContent.innerHTML = '';
+  const msgPinned = document.getElementById('message-panel-pinned');
+  if (msgPinned) msgPinned.innerHTML = '';
+  const projectSessions = sessions.filter((s) => s.project === projectPath);
+  currentProjectSessionIds = projectSessions.map((s) => s.id);
+  const activeSessionIds = projectSessions.filter(isSessionActive).map((s) => s.id);
+
+  const encoded = btoa(projectPath);
+  const [tasksResult, agentResults] = await Promise.all([
+    fetch(`/api/projects/${encodeURIComponent(encoded)}/tasks`)
+      .then((r) => r.json())
+      .catch((e) => {
+        console.error('[fetchProjectView] tasks:', e);
+        return [];
+      }),
+    Promise.all(
+      activeSessionIds.map((id) =>
+        fetch(`/api/sessions/${id}/agents`)
+          .then((r) => r.json())
+          .catch(() => ({ agents: [] })),
+      ),
+    ),
+  ]);
+  currentTasks = tasksResult;
+  const seen = new Set();
+  currentAgents = [];
+  const mergedColors = {};
+  let mergedWaiting = null;
+  for (let i = 0; i < agentResults.length; i++) {
+    const r = agentResults[i];
+    const sid = activeSessionIds[i];
+    const agents = r.agents || (Array.isArray(r) ? r : []);
+    for (const a of agents) {
+      if (a.agentId && !seen.has(a.agentId)) {
+        seen.add(a.agentId);
+        a._sourceSessionId = sid;
+        currentAgents.push(a);
+      }
+    }
+    if (r.teamColors) Object.assign(mergedColors, r.teamColors);
+    if (r.waitingForUser && !mergedWaiting) mergedWaiting = r.waitingForUser;
+  }
+  currentWaiting = mergedWaiting;
+  Object.assign(teamColorMap, mergedColors);
+
+  renderProjectView();
+  renderAgentFooter();
+  renderKanban();
+  updateUrl();
+}
+
+async function refreshProjectAgents() {
+  if (!currentProjectPath) return;
+  const projectSessions = sessions.filter((s) => s.project === currentProjectPath);
+  const activeSessionIds = projectSessions.filter(isSessionActive).map((s) => s.id);
+  const agentResults = await Promise.all(
+    activeSessionIds.map((id) =>
+      fetch(`/api/sessions/${id}/agents`)
+        .then((r) => r.json())
+        .catch(() => ({ agents: [] })),
+    ),
+  );
+  const seen = new Set();
+  currentAgents = [];
+  let mergedWaiting = null;
+  for (let i = 0; i < agentResults.length; i++) {
+    const r = agentResults[i];
+    const sid = activeSessionIds[i];
+    const agents = r.agents || (Array.isArray(r) ? r : []);
+    for (const a of agents) {
+      if (a.agentId && !seen.has(a.agentId)) {
+        seen.add(a.agentId);
+        a._sourceSessionId = sid;
+        currentAgents.push(a);
+      }
+    }
+    if (r.teamColors) Object.assign(teamColorMap, r.teamColors);
+    if (r.waitingForUser && !mergedWaiting) mergedWaiting = r.waitingForUser;
+  }
+  currentWaiting = mergedWaiting;
+  renderAgentFooter();
+}
+
 //#endregion
 
 //#region MESSAGE_PANEL
@@ -507,8 +606,10 @@ async function viewAgentLog(agentId) {
   }
   if (!agent) return;
   const shortId = agentId.length > 8 ? agentId.slice(0, 8) : agentId;
-  agentLogMode = { agentId, sessionId: currentSessionId, agentType: agent.type || 'unknown' };
+  const agentSessionId = agent._sourceSessionId || currentSessionId;
+  agentLogMode = { agentId, sessionId: agentSessionId, agentType: agent.type || 'unknown' };
   closeAgentModal();
+  document.getElementById('message-toggle')?.style.removeProperty('display');
   if (!messagePanelOpen) toggleMessagePanel();
   const header = document.querySelector('.message-panel-header h3');
   if (header) {
@@ -537,6 +638,11 @@ function exitAgentLogMode() {
     agentLogSSE.close();
     agentLogSSE = null;
   }
+  if (viewMode === 'project') {
+    if (messagePanelOpen) toggleMessagePanel();
+    document.getElementById('message-toggle')?.style.setProperty('display', 'none');
+    return;
+  }
   const header = document.querySelector('.message-panel-header h3');
   if (header) header.textContent = 'Session Log';
   lastMessagesHash = '';
@@ -1784,6 +1890,7 @@ function renderSessions() {
             <div class="session-progress">
               <span class="session-indicators">
                 ${isTeam ? `<span class="team-badge" title="${memberCount} team members"><svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M17 21v-2a4 4 0 0 0-4-4H5a4 4 0 0 0-4 4v2"/><circle cx="9" cy="7" r="4"/><path d="M23 21v-2a4 4 0 0 0-3-3.87"/><path d="M16 3.13a4 4 0 0 1 0 7.75"/></svg>${memberCount}</span>` : ''}
+                ${session.sharedTaskList ? `<span class="shared-tasklist-badge" title="Shared task list: ${escapeHtml(session.sharedTaskList)}"><svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"/><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"/></svg></span>` : ''}
                 ${isTeam || session.project || showCtx ? `<span class="team-info-btn" onclick="event.stopPropagation(); showSessionInfoModal('${session.id}')" title="View session info">ℹ</span>` : ''}
                 ${session.hasPlan ? `<span class="plan-indicator" onclick="event.stopPropagation(); openPlanForSession('${session.id}')" title="View plan"><svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/><polyline points="14 2 14 8 20 8"/><line x1="16" y1="13" x2="8" y2="13"/><line x1="16" y1="17" x2="8" y2="17"/></svg></span>` : ''}
                 ${session.hasRunningAgents ? '<span class="agent-badge" title="Active agents">🤖</span>' : ''}
@@ -1850,8 +1957,8 @@ function renderSessions() {
               <svg class="group-chevron" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><polyline points="6 9 12 15 18 9"/></svg>
               <span class="group-name">${escapeHtml(folderName)}</span>
               <span class="group-count">${projectSessions.length}</span>
-              <span class="group-path-toggle" data-group-action="toggle-path" title="Show full path">
-                <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M22 19a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h5l2 3h9a2 2 0 0 1 2 2z"/></svg>
+              <span class="project-view-btn" data-project-path="${escapedPath}" title="Open project view — combined tasks from all sessions">
+                <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="3" y="3" width="7" height="7"/><rect x="14" y="3" width="7" height="7"/><rect x="3" y="14" width="7" height="7"/><rect x="14" y="14" width="7" height="7"/></svg>
               </span>
             </div>
             <div class="project-group-breadcrumb" data-full-path="${escapedPath}" title="Click to copy path">${breadcrumbHtml}</div>
@@ -1969,12 +2076,37 @@ function renderSession() {
   renderSessions();
 }
 
+function renderProjectView() {
+  noSession.style.display = 'none';
+  sessionView.classList.add('visible');
+
+  const folderName = currentProjectPath ? currentProjectPath.split(/[/\\]/).pop() : 'Project';
+  sessionTitle.textContent = folderName;
+
+  const metaParts = [`${currentProjectSessionIds.length} sessions`, `${currentTasks.length} tasks`];
+  if (currentProjectPath) metaParts.push(currentProjectPath);
+  sessionMeta.textContent = metaParts.join(' · ');
+
+  const completed = currentTasks.filter((t) => t.status === 'completed').length;
+  const percent = currentTasks.length > 0 ? Math.round((completed / currentTasks.length) * 100) : 0;
+
+  progressPercent.textContent = `${percent}%`;
+  progressBar.style.width = `${percent}%`;
+  const hasInProgress = currentTasks.some((t) => t.status === 'in_progress');
+  progressBar.classList.toggle('shimmer', hasInProgress && percent < 100);
+
+  updateOwnerFilter();
+  renderKanban();
+  renderSessions();
+}
+
 function renderTaskCard(task) {
   const isBlocked = task.blockedBy && task.blockedBy.length > 0;
-  const taskId = viewMode === 'all' ? `${task.sessionId?.slice(0, 4)}-${task.id}` : task.id;
+  const useSlug = viewMode === 'all' || viewMode === 'project';
+  const taskId = useSlug ? `${(task._taskDir || task.sessionId || '')?.slice(0, 4)}-${task.id}` : task.id;
   const sessionLabel = viewMode === 'all' && task.sessionName ? task.sessionName : null;
   const statusClass = task.status.replace('_', '-');
-  const actualSessionId = task.sessionId || currentSessionId;
+  const actualSessionId = task._taskDir || task.sessionId || currentSessionId || '';
 
   return `
         <div
@@ -2112,7 +2244,9 @@ async function onColumnDrop(e) {
     return;
   }
   const { taskId, sessionId } = data;
-  const task = currentTasks.find((t) => t.id === taskId && (t.sessionId || currentSessionId) === sessionId);
+  const task = currentTasks.find(
+    (t) => t.id === taskId && (t._taskDir === sessionId || (t.sessionId || currentSessionId) === sessionId),
+  );
   if (!task || task.status === newStatus) return;
   try {
     const res = await fetch(`/api/tasks/${sessionId}/${taskId}`, {
@@ -2150,7 +2284,10 @@ function getSelectedCardInfo() {
   for (let ci = 0; ci < COLUMNS.length; ci++) {
     const cards = Array.from(COLUMNS[ci].el.querySelectorAll('.task-card'));
     for (let i = 0; i < cards.length; i++) {
-      if (cards[i].dataset.taskId === selectedTaskId) {
+      if (
+        cards[i].dataset.taskId === selectedTaskId &&
+        (!selectedSessionId || cards[i].dataset.sessionId === selectedSessionId)
+      ) {
         return { colIndex: ci, cardIndex: i, card: cards[i] };
       }
     }
@@ -2410,7 +2547,9 @@ function getAvailableTasksOptions(currentTaskId = null) {
 
 //#region TASK_DETAIL
 async function showTaskDetail(taskId, sessionId = null) {
-  let task = currentTasks.find((t) => t.id === taskId && (!sessionId || t.sessionId === sessionId));
+  let task = currentTasks.find(
+    (t) => t.id === taskId && (!sessionId || t.sessionId === sessionId || t._taskDir === sessionId),
+  );
 
   // If task not found in currentTasks, fetch it from the session
   if (!task && sessionId && sessionId !== 'undefined') {
@@ -2502,20 +2641,25 @@ async function showTaskDetail(taskId, sessionId = null) {
         </div>
       `;
 
-  // Setup button handlers
+  // Setup button handlers (read-only in project view)
   const deleteBtn = document.getElementById('delete-task-btn');
-  deleteBtn.style.display = '';
-  deleteBtn.onclick = () => deleteTask(task.id, actualSessionId);
+  const isProjectView = viewMode === 'project';
+  deleteBtn.style.display = isProjectView ? 'none' : '';
+  if (!isProjectView) deleteBtn.onclick = () => deleteTask(task.id, actualSessionId);
 
-  // Setup inline editing
-  const titleEl = detailContent.querySelector('.detail-title');
-  if (titleEl) {
-    titleEl.onclick = () => editTitle(titleEl, task, actualSessionId);
-  }
+  const noteSection = detailContent.querySelector('.note-section');
+  if (noteSection && isProjectView) noteSection.style.display = 'none';
+
+  if (!isProjectView) {
+    const titleEl = detailContent.querySelector('.detail-title');
+    if (titleEl) {
+      titleEl.onclick = () => editTitle(titleEl, task, actualSessionId);
+    }
 
-  const descEl = detailContent.querySelector('.detail-desc');
-  if (descEl) {
-    descEl.onclick = () => editDescription(descEl, task, actualSessionId);
+    const descEl = detailContent.querySelector('.detail-desc');
+    if (descEl) {
+      descEl.onclick = () => editDescription(descEl, task, actualSessionId);
+    }
   }
 }
 
@@ -2815,6 +2959,12 @@ const _scratchpadModal = document.getElementById('scratchpad-modal');
 const _scratchpadTextarea = document.getElementById('scratchpad-textarea');
 const _scratchpadCharcount = document.getElementById('scratchpad-charcount');
 
+function _scratchpadKey() {
+  if (currentSessionId) return `scratchpad-${currentSessionId}`;
+  if (currentProjectPath) return `scratchpad-project:${currentProjectPath}`;
+  return null;
+}
+
 function toggleScratchpad() {
   if (_scratchpadModal.classList.contains('visible')) {
     closeScratchpad();
@@ -2824,8 +2974,9 @@ function toggleScratchpad() {
 }
 
 function showScratchpad() {
-  if (!currentSessionId) return;
-  _scratchpadTextarea.value = localStorage.getItem(`scratchpad-${currentSessionId}`) || '';
+  const key = _scratchpadKey();
+  if (!key) return;
+  _scratchpadTextarea.value = localStorage.getItem(key) || '';
   _scratchpadCharcount.textContent = `${_scratchpadTextarea.value.length} chars`;
   _scratchpadModal.classList.add('visible');
   _scratchpadTextarea.focus();
@@ -2841,8 +2992,9 @@ function closeScratchpad() {
 }
 
 function saveScratchpad() {
-  if (!currentSessionId) return;
-  localStorage.setItem(`scratchpad-${currentSessionId}`, _scratchpadTextarea.value);
+  const key = _scratchpadKey();
+  if (!key) return;
+  localStorage.setItem(key, _scratchpadTextarea.value);
 }
 
 _scratchpadTextarea.addEventListener('input', () => {
@@ -3122,6 +3274,9 @@ function setupEventSource() {
             currentTasks = filterProject ? allTasksCache.filter((t) => matchesProjectFilter(t.project)) : allTasksCache;
             renderAllTasks();
             renderLiveUpdatesFromCache();
+          } else if (viewMode === 'project' && currentProjectPath) {
+            const hasUpdate = currentProjectSessionIds.some((id) => pendingTaskSessionIds.has(id));
+            if (hasUpdate) fetchProjectView(currentProjectPath);
           } else if (currentSessionId && pendingTaskSessionIds.has(currentSessionId)) {
             fetchTasks(currentSessionId);
           }
@@ -3144,7 +3299,9 @@ function setupEventSource() {
 
       if (data.type === 'agent-update') {
         fetchSessions().catch((err) => console.error('[SSE] fetchSessions failed:', err));
-        if (currentSessionId && data.sessionId === currentSessionId) {
+        if (viewMode === 'project' && currentProjectSessionIds.includes(data.sessionId)) {
+          refreshProjectAgents();
+        } else if (currentSessionId && data.sessionId === currentSessionId) {
           fetchAgents(currentSessionId);
         }
       }
@@ -3312,6 +3469,10 @@ function renderContextDetail(raw) {
 //#endregion
 
 //#region UTILS
+function isSessionActive(s) {
+  return s.hasRecentLog || s.inProgress > 0 || s.hasActiveAgents || s.hasWaitingForUser;
+}
+
 function formatDate(dateStr) {
   const date = new Date(dateStr);
   const now = new Date();
@@ -3494,6 +3655,14 @@ document.addEventListener('click', (e) => {
     return;
   }
 
+  const projectBtn = e.target.closest('.project-view-btn');
+  if (projectBtn) {
+    e.stopPropagation();
+    const projectPath = projectBtn.dataset.projectPath;
+    if (projectPath) fetchProjectView(projectPath);
+    return;
+  }
+
   const header = e.target.closest('.project-group-header');
   if (header) {
     setGroupCollapsed(header, !collapsedProjectGroups.has(header.dataset.groupPath));
@@ -3804,6 +3973,9 @@ function showInfoModal(session, teamConfig, tasks, planContent) {
   if (session.tasksDir) {
     infoRows.push(['Tasks Dir', session.tasksDir, { openPath: session.tasksDir }]);
   }
+  if (session.sharedTaskList) {
+    infoRows.push(['Shared Tasks', session.sharedTaskList]);
+  }
   if (teamConfig?.configPath) {
     const configDir = teamConfig.configPath.replace(/[/\\][^/\\]+$/, '');
     infoRows.push(['Team Config', teamConfig.configPath, { openPath: configDir, openFile: teamConfig.configPath }]);
@@ -4109,7 +4281,13 @@ if (urlState.search) {
 }
 
 fetchSessions().then(async () => {
-  if (urlState.session) {
+  if (urlState.projectView) {
+    try {
+      await fetchProjectView(atob(urlState.projectView));
+    } catch (_) {
+      showAllTasks();
+    }
+  } else if (urlState.session) {
     await fetchTasks(urlState.session);
   } else {
     showAllTasks();
@@ -4127,7 +4305,13 @@ window.addEventListener('popstate', () => {
   ownerFilter = s.owner || '';
   searchQuery = s.search || '';
   loadPreferences();
-  if (s.session) fetchTasks(s.session);
+  if (s.projectView) {
+    try {
+      fetchProjectView(atob(s.projectView));
+    } catch (_) {
+      showAllTasks();
+    }
+  } else if (s.session) fetchTasks(s.session);
   else showAllTasks();
   if (s.messages !== messagePanelOpen) toggleMessagePanel();
 });

package/public/style.css

@@ -488,13 +488,16 @@ body::before {
   display: block;
   width: 100%;
   padding: 12px 14px;
-  margin-bottom: 2px;
+  margin-bottom: 4px;
   background: transparent;
   border: 1px solid transparent;
   border-radius: 8px;
   text-align: left;
   cursor: pointer;
   transition: all 0.2s cubic-bezier(0.4, 0, 0.2, 1);
+  box-shadow:
+    0 1px 3px rgba(0, 0, 0, 0.12),
+    0 1px 2px rgba(0, 0, 0, 0.08);
 }
 
 .session-item:hover {
@@ -1578,6 +1581,13 @@ body::before {
   font-weight: 600;
 }
 
+.shared-tasklist-badge {
+  display: inline-flex;
+  align-items: center;
+  color: var(--accent);
+  flex-shrink: 0;
+}
+
 .team-info-btn {
   width: 24px;
   height: 24px;
@@ -3002,6 +3012,18 @@ select.form-input option:checked {
   white-space: nowrap;
 }
 
+.project-view-btn {
+  color: var(--text-muted);
+  cursor: pointer;
+  display: flex;
+  align-items: center;
+  transition: color 0.15s;
+}
+
+.project-view-btn:hover {
+  color: var(--accent);
+}
+
 .project-group-header .group-count {
   font-weight: 400;
   color: var(--text-muted);

package/server.js

@@ -15,7 +15,8 @@ const {
   readSessionInfoFromJsonl,
   buildAgentProgressMap,
   readCompactSummaries,
-  findTerminatedTeammates
+  findTerminatedTeammates,
+  extractPromptFromTranscript
 } = require('./lib/parsers');
 
 const isSetupCommand = process.argv.includes('--install') || process.argv.includes('--uninstall');
@@ -189,6 +190,9 @@ const terminatedCache = new Map();
 const compactSummaryCache = new Map();
 const taskCountsCache = new Map();
 const contextStatusCache = new Map();
+const TASK_MAPS_DIR = path.join(AGENT_ACTIVITY_DIR, '_task-maps');
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function isUUID(s) { return UUID_RE.test(s); }
 
 function evictStaleCache(cache) {
   if (cache.size <= MAX_CACHE_ENTRIES) return;
@@ -196,6 +200,47 @@ function evictStaleCache(cache) {
   if (oldest !== undefined) cache.delete(oldest);
 }
 
+let sessionToTaskListCache = null;
+let lastTaskMapScan = 0;
+const TASK_MAP_SCAN_TTL = 5000;
+
+function loadAllTaskMaps() {
+  const now = Date.now();
+  if (sessionToTaskListCache && now - lastTaskMapScan < TASK_MAP_SCAN_TTL) return sessionToTaskListCache;
+
+  const sessionToList = {};
+  const listToSessions = {};
+  if (!existsSync(TASK_MAPS_DIR)) {
+    sessionToTaskListCache = { sessionToList, listToSessions };
+    lastTaskMapScan = now;
+    return sessionToTaskListCache;
+  }
+  try {
+    for (const file of readdirSync(TASK_MAPS_DIR).filter(f => f.endsWith('.json'))) {
+      const taskListName = file.replace(/\.json$/, '');
+      const mapPath = path.join(TASK_MAPS_DIR, file);
+      try {
+        const map = JSON.parse(readFileSync(mapPath, 'utf8'));
+        listToSessions[taskListName] = map;
+        for (const sessionId of Object.keys(map)) {
+          sessionToList[sessionId] = taskListName;
+        }
+      } catch (e) { /* skip invalid */ }
+    }
+  } catch (e) { /* ignore */ }
+  sessionToTaskListCache = { sessionToList, listToSessions };
+  lastTaskMapScan = now;
+  return sessionToTaskListCache;
+}
+
+function getCustomTaskDir(sessionId) {
+  const { sessionToList } = loadAllTaskMaps();
+  const taskListName = sessionToList[sessionId];
+  if (!taskListName) return null;
+  const dir = path.join(TASKS_DIR, taskListName);
+  return existsSync(dir) ? dir : null;
+}
+
 function getTaskCounts(sessionPath) {
   const cached = taskCountsCache.get(sessionPath);
   if (cached) return cached;
@@ -449,7 +494,7 @@ app.get('/api/sessions', async (req, res) => {
       const entries = readdirSync(TASKS_DIR, { withFileTypes: true });
 
       for (const entry of entries) {
-        if (entry.isDirectory()) {
+        if (entry.isDirectory() && isUUID(entry.name)) {
           const sessionPath = path.join(TASKS_DIR, entry.name);
           const stat = statSync(sessionPath);
           const { taskCount, completed, inProgress, pending, newestTaskMtime } = getTaskCounts(sessionPath);
@@ -497,6 +542,44 @@ app.get('/api/sessions', async (req, res) => {
           }));
         }
       }
+
+      // Process custom task lists (non-UUID directories mapped via _task-maps)
+      const { listToSessions } = loadAllTaskMaps();
+      for (const [taskListName, map] of Object.entries(listToSessions)) {
+        const customTaskDir = path.join(TASKS_DIR, taskListName);
+        if (!existsSync(customTaskDir)) continue;
+        const counts = getTaskCounts(customTaskDir);
+
+        for (const [sessionId, info] of Object.entries(map)) {
+          const existing = sessionsMap.get(sessionId);
+          if (existing) {
+            Object.assign(existing, {
+              taskCount: counts.taskCount,
+              completed: counts.completed,
+              inProgress: counts.inProgress,
+              pending: counts.pending,
+              tasksDir: customTaskDir,
+              sharedTaskList: taskListName,
+            });
+            if (counts.newestTaskMtime) {
+              const taskMtime = counts.newestTaskMtime.toISOString();
+              if (taskMtime > existing.modifiedAt) existing.modifiedAt = taskMtime;
+            }
+          } else {
+            const meta = { ...(metadata[sessionId] || {}) };
+            if (!meta.project && info.project) meta.project = info.project;
+            sessionsMap.set(sessionId, buildSessionObject(sessionId, meta, {
+              taskCount: counts.taskCount,
+              completed: counts.completed,
+              inProgress: counts.inProgress,
+              pending: counts.pending,
+              modifiedAt: counts.newestTaskMtime ? counts.newestTaskMtime.toISOString() : (info.updatedAt || new Date(0).toISOString()),
+              tasksDir: customTaskDir,
+              sharedTaskList: taskListName,
+            }));
+          }
+        }
+      }
     }
 
     // Add sessions from metadata that don't have task directories
@@ -645,7 +728,8 @@ app.get('/api/projects', (req, res) => {
 // API: Get tasks for a session
 app.get('/api/sessions/:sessionId', async (req, res) => {
   try {
-    const sessionPath = path.join(TASKS_DIR, req.params.sessionId);
+    const customDir = getCustomTaskDir(req.params.sessionId);
+    const sessionPath = customDir || path.join(TASKS_DIR, req.params.sessionId);
 
     if (!existsSync(sessionPath)) {
       return res.status(404).json({ error: 'Session not found' });
@@ -673,6 +757,52 @@ app.get('/api/sessions/:sessionId', async (req, res) => {
   }
 });
 
+// API: Get combined tasks for a project (all sessions + shared task lists)
+app.get('/api/projects/:encodedPath/tasks', (req, res) => {
+  try {
+    const projectPath = Buffer.from(req.params.encodedPath, 'base64').toString('utf8');
+    const metadata = loadSessionMetadata();
+    const { sessionToList } = loadAllTaskMaps();
+
+    const projectSessionIds = Object.entries(metadata)
+      .filter(([, m]) => m.project === projectPath)
+      .map(([id]) => id);
+
+    const taskDirs = new Set();
+    for (const sid of projectSessionIds) {
+      const listName = sessionToList[sid];
+      if (listName) {
+        const dir = path.join(TASKS_DIR, listName);
+        if (existsSync(dir)) taskDirs.add(dir);
+      } else {
+        const dir = path.join(TASKS_DIR, sid);
+        if (existsSync(dir)) taskDirs.add(dir);
+      }
+    }
+
+    const tasks = [];
+    const seenKeys = new Set();
+    for (const dir of taskDirs) {
+      for (const file of readdirSync(dir).filter(f => f.endsWith('.json'))) {
+        try {
+          const task = JSON.parse(readFileSync(path.join(dir, file), 'utf8'));
+          const key = `${dir}:${task.id}`;
+          if (!seenKeys.has(key)) {
+            seenKeys.add(key);
+            task._taskDir = path.basename(dir);
+            tasks.push(task);
+          }
+        } catch (_) {}
+      }
+    }
+    tasks.sort((a, b) => parseInt(a.id) - parseInt(b.id));
+    res.json(tasks);
+  } catch (error) {
+    console.error('Error getting project tasks:', error);
+    res.status(500).json({ error: 'Failed to get project tasks' });
+  }
+});
+
 // API: Get session plan
 app.get('/api/sessions/:sessionId/plan', async (req, res) => {
   try {
@@ -821,23 +951,26 @@ app.get('/api/sessions/:sessionId/agents', (req, res) => {
       } catch (_) {}
     }
 
+    function persistPrompt(agent, prompt) {
+      agent.prompt = prompt;
+      const agentFile = path.join(agentDir, agent.agentId + '.json');
+      fs.writeFile(agentFile, JSON.stringify(agent), 'utf8').catch(() => {});
+    }
+
     const agentsNeedingPrompt = agents.filter(a => !a.prompt);
     if (agentsNeedingPrompt.length && meta.jsonlPath) {
+      let byAgentId = {};
       try {
         const progressMap = getProgressMap(meta.jsonlPath);
-        const byAgentId = {};
         for (const entry of Object.values(progressMap)) {
           if (entry.prompt && !byAgentId[entry.agentId]) byAgentId[entry.agentId] = entry.prompt;
         }
-        for (const agent of agentsNeedingPrompt) {
-          const prompt = byAgentId[agent.agentId];
-          if (prompt) {
-            agent.prompt = prompt;
-            const agentFile = path.join(agentDir, agent.agentId + '.json');
-            fs.writeFile(agentFile, JSON.stringify(agent), 'utf8').catch(() => {});
-          }
-        }
       } catch (_) {}
+      for (const agent of agentsNeedingPrompt) {
+        const prompt = byAgentId[agent.agentId]
+          || (() => { try { return extractPromptFromTranscript(subagentJsonlPath(meta, agent.agentId)); } catch (_) { return null; } })();
+        if (prompt) persistPrompt(agent, prompt);
+      }
     }
     const teamColors = {};
     if (teamConfig?.members) {
@@ -1066,7 +1199,8 @@ app.post('/api/tasks/:sessionId/:taskId/note', async (req, res) => {
       return res.status(400).json({ error: 'Note cannot be empty' });
     }
 
-    const taskPath = path.join(TASKS_DIR, sessionId, `${taskId}.json`);
+    const sessionDir = getCustomTaskDir(sessionId) || path.join(TASKS_DIR, sessionId);
+    const taskPath = path.join(sessionDir, `${taskId}.json`);
 
     if (!existsSync(taskPath)) {
       return res.status(404).json({ error: 'Task not found' });
@@ -1095,7 +1229,8 @@ app.put('/api/tasks/:sessionId/:taskId', async (req, res) => {
     const { sessionId, taskId } = req.params;
     const { subject, description } = req.body;
 
-    const taskPath = path.join(TASKS_DIR, sessionId, `${taskId}.json`);
+    const sessionDir = getCustomTaskDir(sessionId) || path.join(TASKS_DIR, sessionId);
+    const taskPath = path.join(sessionDir, `${taskId}.json`);
 
     if (!existsSync(taskPath)) {
       return res.status(404).json({ error: 'Task not found' });
@@ -1120,14 +1255,14 @@ app.put('/api/tasks/:sessionId/:taskId', async (req, res) => {
 app.delete('/api/tasks/:sessionId/:taskId', async (req, res) => {
   try {
     const { sessionId, taskId } = req.params;
-    const taskPath = path.join(TASKS_DIR, sessionId, `${taskId}.json`);
+    const sessionPath = getCustomTaskDir(sessionId) || path.join(TASKS_DIR, sessionId);
+    const taskPath = path.join(sessionPath, `${taskId}.json`);
 
     if (!existsSync(taskPath)) {
       return res.status(404).json({ error: 'Task not found' });
     }
 
     // Check if this task blocks other tasks
-    const sessionPath = path.join(TASKS_DIR, sessionId);
     const taskFiles = readdirSync(sessionPath).filter(f => f.endsWith('.json'));
 
     for (const file of taskFiles) {
@@ -1200,21 +1335,44 @@ const watcher = chokidar.watch(TASKS_DIR, {
 watcher.on('all', (event, filePath) => {
   if ((event === 'add' || event === 'change' || event === 'unlink') && filePath.endsWith('.json')) {
     const relativePath = path.relative(TASKS_DIR, filePath);
-    const sessionId = relativePath.split(path.sep)[0];
+    const dirName = relativePath.split(path.sep)[0];
 
-    taskCountsCache.delete(path.join(TASKS_DIR, sessionId));
+    taskCountsCache.delete(path.join(TASKS_DIR, dirName));
 
-    broadcast({
-      type: 'update',
-      event,
-      sessionId,
-      file: path.basename(filePath)
-    });
+    if (isUUID(dirName)) {
+      broadcast({ type: 'update', event, sessionId: dirName, file: path.basename(filePath) });
+    } else {
+      broadcastToMappedSessions(dirName, event, filePath);
+    }
   }
 });
 
+function broadcastToMappedSessions(taskListName, event, filePath) {
+  const { listToSessions } = loadAllTaskMaps();
+  const map = listToSessions[taskListName];
+  if (!map) return;
+  for (const sid of Object.keys(map)) {
+    broadcast({ type: 'update', event, sessionId: sid, file: path.basename(filePath) });
+  }
+}
+
 console.log(`Watching for changes in: ${TASKS_DIR}`);
 
+// Watch task maps directory for session→task-list mapping changes
+const taskMapsWatcher = chokidar.watch(TASK_MAPS_DIR, {
+  persistent: true,
+  ignoreInitial: true,
+  depth: 1
+});
+taskMapsWatcher.on('all', (event, filePath) => {
+  if ((event === 'add' || event === 'change' || event === 'unlink') && filePath.endsWith('.json')) {
+    lastTaskMapScan = 0;
+    const taskListName = path.basename(filePath, '.json');
+    taskCountsCache.delete(path.join(TASKS_DIR, taskListName));
+    broadcastToMappedSessions(taskListName, event, filePath);
+  }
+});
+
 // Watch teams directory for config changes
 const teamsWatcher = chokidar.watch(TEAMS_DIR, {
   persistent: true,