@geminilight/mindos 0.6.22 → 0.6.25

package/README.md

@@ -15,7 +15,6 @@
 <p align="center">
   <a href="https://tianfuwang.tech/MindOS"><img src="https://img.shields.io/badge/Website-MindOS-0ea5e9.svg?style=for-the-badge" alt="Website"></a>
   <a href="https://www.npmjs.com/package/@geminilight/mindos"><img src="https://img.shields.io/npm/v/@geminilight/mindos.svg?style=for-the-badge&color=f59e0b" alt="npm version"></a>
-  <a href="https://www.npmjs.com/package/@geminilight/mindos"><img src="https://img.shields.io/npm/dw/@geminilight/mindos.svg?style=for-the-badge&color=10b981" alt="npm downloads"></a>
   <a href="#wechat"><img src="https://img.shields.io/badge/WeChat-Group-07C160.svg?style=for-the-badge&logo=wechat&logoColor=white" alt="WeChat"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-6366f1.svg?style=for-the-badge" alt="MIT License"></a>
 </p>
@@ -32,6 +31,25 @@ MindOS is where you think, and where your AI agents act — a local-first knowle
   </picture>
 </p>
 
+<table>
+  <tr>
+    <td width="50%"><img src="assets/images/mindos-home.png" alt="MindOS Home" /></td>
+    <td width="50%"><img src="assets/images/mindos-chat.png" alt="MindOS AI Chat" /></td>
+  </tr>
+  <tr>
+    <td align="center"><em>Home — Knowledge base overview</em></td>
+    <td align="center"><em>AI Chat — Converse with your knowledge in context</em></td>
+  </tr>
+  <tr>
+    <td width="50%"><img src="assets/images/mindos-dashboard.png" alt="MindOS Agents Dashboard" /></td>
+    <td width="50%"><img src="assets/images/mindos-echo.png" alt="MindOS Echo" /></td>
+  </tr>
+  <tr>
+    <td align="center"><em>Agents — Manage all connected AI agents</em></td>
+    <td align="center"><em>Echo — Reflect and distill cognitive growth</em></td>
+  </tr>
+</table>
+
 > [!IMPORTANT]
 > **⭐ One-click install:** Send this to your Agent (Claude Code, Cursor, etc.) to set up everything automatically:
 > ```
@@ -67,37 +85,6 @@ You express preferences but the next chat starts from zero, leaving your thinkin
 
 > **Foundation:** Local-first by default — all data stays in local plain text for privacy, ownership, and speed.
 
-## ✨ Features
-
-**For Humans**
-
-- **GUI Workbench**: browse, edit, search notes with unified search + AI entry (`⌘K` / `⌘/`), designed for human-AI co-creation.
-- **Built-in Agent Assistant**: converse with the knowledge base in context; edits seamlessly capture human-curated knowledge.
-- **Plugin Extensions**: multiple built-in renderer plugins — TODO Board, CSV Views, Wiki Graph, Timeline, Agent Inspector, and more.
-
-**For Agents**
-
-- **MCP Server + Skills**: stdio + HTTP dual transport, full-lineup Agent compatible (OpenClaw, Claude Code, Cursor, etc.). Zero-config access.
-- **Structured Templates**: pre-set directory structures for Profiles, Workflows, Configurations, etc., to jumpstart personal context.
-- **Agent-Ready Docs**: everyday notes naturally double as high-quality executable Agent commands — no format conversion needed, write and dispatch.
-
-**Infrastructure**
-
-- **Security**: Bearer Token auth, path sandboxing, INSTRUCTION.md write-protection, atomic writes.
-- **Knowledge Graph**: dynamically parses and visualizes inter-file references and dependencies.
-- **Backlinks View**: displays all files that reference the current file, helping you understand how a note fits into the knowledge network.
-- **Git Time Machine**: Git auto-sync (commit/push/pull), records every edit by both humans and Agents. One-click rollback, cross-device sync.
-- **Desktop App**: native macOS/Windows/Linux app with system tray, auto-start, and local process management.
-
-<details>
-<summary><strong>Coming Soon</strong></summary>
-
-- [ ] ACP (Agent Communication Protocol): connect external Agents (e.g., Claude Code, Cursor) and turn the knowledge base into a multi-Agent collaboration hub
-- [ ] Deep RAG integration: retrieval-augmented generation grounded in your knowledge base for more accurate, context-aware AI responses
-- [ ] Agent Inspector: render Agent operation logs as a filterable timeline to audit every tool call in detail
-
-</details>
-
 ---
 
 ## 🚀 Getting Started
@@ -150,9 +137,6 @@ mindos open
 2. Upload your resume or any personal/project material.
 3. Send this prompt: `Help me sync this information into my MindOS knowledge base.`
 
-<p align="center">
-  <img src="assets/images/gui-sync-cv.png" alt="Sync CV Example" width="800" />
-</p>
 
 ### 4. Make Any Agent Ready (MCP + Skills)
 
@@ -172,6 +156,37 @@ npx skills add https://github.com/GeminiLight/MindOS --skill mindos-zh -g -y   #
 
 > For remote access, manual JSON config, and common pitfalls, see **[docs/en/supported-agents.md](docs/en/supported-agents.md)**.
 
+## ✨ Features
+
+**For Humans**
+
+- **GUI Workbench**: browse, edit, search notes with unified search + AI entry (`⌘K` / `⌘/`), designed for human-AI co-creation.
+- **Built-in Agent Assistant**: converse with the knowledge base in context; edits seamlessly capture human-curated knowledge.
+- **Plugin Extensions**: multiple built-in renderer plugins — TODO Board, CSV Views, Wiki Graph, Timeline, Agent Inspector, and more.
+
+**For Agents**
+
+- **MCP Server + Skills**: stdio + HTTP dual transport, full-lineup Agent compatible (OpenClaw, Claude Code, Cursor, etc.). Zero-config access.
+- **Structured Templates**: pre-set directory structures for Profiles, Workflows, Configurations, etc., to jumpstart personal context.
+- **Agent-Ready Docs**: everyday notes naturally double as high-quality executable Agent commands — no format conversion needed, write and dispatch.
+
+**Infrastructure**
+
+- **Security**: Bearer Token auth, path sandboxing, INSTRUCTION.md write-protection, atomic writes.
+- **Knowledge Graph**: dynamically parses and visualizes inter-file references and dependencies.
+- **Backlinks View**: displays all files that reference the current file, helping you understand how a note fits into the knowledge network.
+- **Git Time Machine**: Git auto-sync (commit/push/pull), records every edit by both humans and Agents. One-click rollback, cross-device sync.
+- **Desktop App**: native macOS/Windows/Linux app with system tray, auto-start, and local process management.
+
+<details>
+<summary><strong>Coming Soon</strong></summary>
+
+- [ ] ACP (Agent Communication Protocol): connect external Agents (e.g., Claude Code, Cursor) and turn the knowledge base into a multi-Agent collaboration hub
+- [ ] Deep RAG integration: retrieval-augmented generation grounded in your knowledge base for more accurate, context-aware AI responses
+- [ ] Agent Inspector: render Agent operation logs as a filterable timeline to audit every tool call in detail
+
+</details>
+
 ## ⚙️ How It Works
 
 ```mermaid
@@ -203,22 +218,21 @@ graph LR
 
 | Agent | MCP | Skills |
 |:------|:---:|:------:|
-| MindOS Agent | ✅ | ✅ |
 | OpenClaw | ✅ | ✅ |
-| Claude Desktop / Code | ✅ | ✅ |
-| CodeBuddy | ✅ | ✅ |
+| Claude Code | ✅ | ✅ |
 | Cursor | ✅ | ✅ |
-| Windsurf | ✅ | ✅ |
-| Cline | ✅ | ✅ |
-| Trae | ✅ | ✅ |
+| Codex | ✅ | ✅ |
 | Gemini CLI | ✅ | ✅ |
 | GitHub Copilot | ✅ | ✅ |
-| iFlow | ✅ | ✅ |
+| Trae | ✅ | ✅ |
+| CodeBuddy | ✅ | ✅ |
+| Qoder | ✅ | ✅ |
+| Cline | ✅ | ✅ |
+| Windsurf | ✅ | ✅ |
 
 ---
 
-<details>
-<summary><strong>📁 Project Structure</strong></summary>
+## 📁 Project Structure
 
 ```bash
 MindOS/
@@ -236,8 +250,6 @@ MindOS/
 └── mind/             # Your private knowledge base (default: ~/MindOS/mind, customizable on onboard)
 ```
 
-</details>
-
 ## ⌨️ CLI Commands
 
 > Full command reference: **[docs/en/cli-commands.md](docs/en/cli-commands.md)**

package/README_zh.md

@@ -15,7 +15,6 @@
 <p align="center">
   <a href="https://tianfuwang.tech/MindOS"><img src="https://img.shields.io/badge/Website-MindOS-0ea5e9.svg?style=for-the-badge" alt="Website"></a>
   <a href="https://www.npmjs.com/package/@geminilight/mindos"><img src="https://img.shields.io/npm/v/@geminilight/mindos.svg?style=for-the-badge&color=f59e0b" alt="npm version"></a>
-  <a href="https://www.npmjs.com/package/@geminilight/mindos"><img src="https://img.shields.io/npm/dw/@geminilight/mindos.svg?style=for-the-badge&color=10b981" alt="npm downloads"></a>
   <a href="#wechat"><img src="https://img.shields.io/badge/WeChat-群聊-07C160.svg?style=for-the-badge&logo=wechat&logoColor=white" alt="WeChat"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-6366f1.svg?style=for-the-badge" alt="MIT License"></a>
 </p>
@@ -32,6 +31,25 @@ MindOS 是你思考的地方，也是 AI Agent 行动的起点——一个你和
   </picture>
 </p>
 
+<table>
+  <tr>
+    <td width="50%"><img src="assets/images/mindos-home.png" alt="MindOS 首页" /></td>
+    <td width="50%"><img src="assets/images/mindos-chat.png" alt="MindOS AI 对话" /></td>
+  </tr>
+  <tr>
+    <td align="center"><em>首页 — 知识库概览</em></td>
+    <td align="center"><em>AI 对话 — 在上下文中与知识库对话</em></td>
+  </tr>
+  <tr>
+    <td width="50%"><img src="assets/images/mindos-dashboard.png" alt="MindOS Agent 工作台" /></td>
+    <td width="50%"><img src="assets/images/mindos-echo.png" alt="MindOS Echo" /></td>
+  </tr>
+  <tr>
+    <td align="center"><em>Agent 工作台 — 管理所有已连接的 AI Agent</em></td>
+    <td align="center"><em>Echo — 复盘与认知沉淀</em></td>
+  </tr>
+</table>
+
 > [!IMPORTANT]
 > **⭐ 一键安装：** 把这句话发给你的 Agent（Claude Code、Cursor 等），自动完成全部安装：
 > ```
@@ -67,37 +85,6 @@ Agent 记忆锁在黑箱中，推理无法审查，错误极难纠正且幻觉
 
 > **底层原则：** 默认本地优先，全部数据以本地纯文本保存，兼顾隐私、主权与性能。
 
-## ✨ 功能特性
-
-**人类侧**
-
-- **GUI 工作台**：浏览、编辑、搜索笔记，统一搜索 + AI 入口（`⌘K` / `⌘/`），专为人机共创设计。
-- **内置 Agent 助手**：在上下文中与知识库对话，编辑无缝沉淀为可管理知识。
-- **插件扩展**：多种内置渲染器插件——TODO Board、CSV Views、Wiki Graph、Timeline、Agent Inspector 等。
-
-**Agent 侧**
-
-- **MCP Server + Skills**：stdio + HTTP 双传输，全阵容 Agent 兼容（OpenClaw, Claude Code, Cursor 等），零配置接入。
-- **结构化模板**：预置 Profile、Workflows、Configurations 等目录骨架，快速冷启动个人 Context。
-- **笔记即指令**：日常笔记天然就是 Agent 可直接执行的高质量指令——无需额外格式转换，写下即可调度。
-
-**基础设施**
-
-- **安全防线**：Bearer Token 认证、路径沙箱、INSTRUCTION.md 写保护、原子写入。
-- **知识图谱**：动态解析并可视化文件间的引用与依赖关系。
-- **反向链接视图**：展示所有引用当前文件的反向链接，理解笔记在知识网络中的位置。
-- **Git 时光机**：Git 自动同步（commit/push/pull），记录人类与 Agent 的每次编辑历史，一键回滚，跨设备同步。
-- **桌面客户端**：原生 macOS/Windows/Linux 应用，系统托盘、开机自启、本地进程管理。
-
-<details>
-<summary><strong>即将到来</strong></summary>
-
-- [ ] ACP（Agent Communication Protocol）：连接外部 Agent（如 Claude Code、Cursor），让知识库成为多 Agent 协作的中枢
-- [ ] RAG 深度集成：基于知识库内容的检索增强生成，让 AI 回答更精准、更有上下文
-- [ ] Agent 审计面板（Agent Inspector）：将 Agent 操作日志渲染为可筛选的时间线，审查每次工具调用的详情
-
-</details>
-
 ---
 
 ## 🚀 快速开始
@@ -150,9 +137,6 @@ mindos open
 2. 上传你的简历或任意个人/项目资料。
 3. 发送指令：`帮我把这些信息同步到我的 MindOS 知识库。`
 
-<p align="center">
-  <img src="assets/images/gui-sync-cv.png" alt="同步简历示例" width="800" />
-</p>
 
 ### 4. 让任意 Agent 可用（MCP + Skills）
 
@@ -172,6 +156,37 @@ npx skills add https://github.com/GeminiLight/MindOS --skill mindos-zh -g -y   #
 
 > 远程配置、手动 JSON 片段、常见误区等详见 **[docs/zh/supported-agents.md](docs/zh/supported-agents.md)**。
 
+## ✨ 功能特性
+
+**人类侧**
+
+- **GUI 工作台**：浏览、编辑、搜索笔记，统一搜索 + AI 入口（`⌘K` / `⌘/`），专为人机共创设计。
+- **内置 Agent 助手**：在上下文中与知识库对话，编辑无缝沉淀为可管理知识。
+- **插件扩展**：多种内置渲染器插件——TODO Board、CSV Views、Wiki Graph、Timeline、Agent Inspector 等。
+
+**Agent 侧**
+
+- **MCP Server + Skills**：stdio + HTTP 双传输，全阵容 Agent 兼容（OpenClaw, Claude Code, Cursor 等），零配置接入。
+- **结构化模板**：预置 Profile、Workflows、Configurations 等目录骨架，快速冷启动个人 Context。
+- **笔记即指令**：日常笔记天然就是 Agent 可直接执行的高质量指令——无需额外格式转换，写下即可调度。
+
+**基础设施**
+
+- **安全防线**：Bearer Token 认证、路径沙箱、INSTRUCTION.md 写保护、原子写入。
+- **知识图谱**：动态解析并可视化文件间的引用与依赖关系。
+- **反向链接视图**：展示所有引用当前文件的反向链接，理解笔记在知识网络中的位置。
+- **Git 时光机**：Git 自动同步（commit/push/pull），记录人类与 Agent 的每次编辑历史，一键回滚，跨设备同步。
+- **桌面客户端**：原生 macOS/Windows/Linux 应用，系统托盘、开机自启、本地进程管理。
+
+<details>
+<summary><strong>即将到来</strong></summary>
+
+- [ ] ACP（Agent Communication Protocol）：连接外部 Agent（如 Claude Code、Cursor），让知识库成为多 Agent 协作的中枢
+- [ ] RAG 深度集成：基于知识库内容的检索增强生成，让 AI 回答更精准、更有上下文
+- [ ] Agent 审计面板（Agent Inspector）：将 Agent 操作日志渲染为可筛选的时间线，审查每次工具调用的详情
+
+</details>
+
 ## ⚙️ 运作机制
 
 ```mermaid
@@ -203,22 +218,21 @@ graph LR
 
 | Agent | MCP | Skills |
 |:------|:---:|:------:|
-| MindOS Agent | ✅ | ✅ |
 | OpenClaw | ✅ | ✅ |
-| Claude Desktop / Code | ✅ | ✅ |
-| CodeBuddy | ✅ | ✅ |
+| Claude Code | ✅ | ✅ |
 | Cursor | ✅ | ✅ |
-| Windsurf | ✅ | ✅ |
-| Cline | ✅ | ✅ |
-| Trae | ✅ | ✅ |
+| Codex | ✅ | ✅ |
 | Gemini CLI | ✅ | ✅ |
 | GitHub Copilot | ✅ | ✅ |
-| iFlow | ✅ | ✅ |
+| Trae | ✅ | ✅ |
+| CodeBuddy | ✅ | ✅ |
+| Qoder | ✅ | ✅ |
+| Cline | ✅ | ✅ |
+| Windsurf | ✅ | ✅ |
 
 ---
 
-<details>
-<summary><strong>📁 项目架构</strong></summary>
+## 📁 项目架构
 
 ```bash
 MindOS/
@@ -236,8 +250,6 @@ MindOS/
 └── my-mind/          # 你的私有知识库（默认路径，onboard 时可自定义）
 ```
 
-</details>
-
 ## ⌨️ CLI 命令
 
 > 完整命令参考：**[docs/zh/cli-commands.md](docs/zh/cli-commands.md)**

package/app/app/.well-known/agent-card.json/route.ts

@@ -0,0 +1,34 @@
+export const dynamic = 'force-dynamic';
+
+import { NextRequest, NextResponse } from 'next/server';
+import { buildAgentCard } from '@/lib/a2a/agent-card';
+
+const CORS_HEADERS: Record<string, string> = {
+  'Access-Control-Allow-Origin': '*',
+  'Access-Control-Allow-Methods': 'GET, OPTIONS',
+  'Access-Control-Allow-Headers': 'Content-Type, Authorization',
+  'Cache-Control': 'public, max-age=300',
+};
+
+export async function GET(req: NextRequest) {
+  // Prefer explicit config; fall back to request headers
+  const configuredUrl = process.env.MINDOS_BASE_URL;
+  let baseUrl: string;
+  if (configuredUrl) {
+    baseUrl = configuredUrl.replace(/\/+$/, '');
+  } else {
+    const proto = req.headers.get('x-forwarded-proto') ?? 'http';
+    const host = req.headers.get('host') ?? `localhost:${process.env.PORT || 3456}`;
+    baseUrl = `${proto}://${host}`;
+  }
+
+  const card = buildAgentCard(baseUrl);
+
+  const res = NextResponse.json(card);
+  for (const [k, v] of Object.entries(CORS_HEADERS)) res.headers.set(k, v);
+  return res;
+}
+
+export async function OPTIONS() {
+  return new Response(null, { status: 204, headers: CORS_HEADERS });
+}

package/app/app/api/a2a/route.ts

@@ -0,0 +1,100 @@
+export const dynamic = 'force-dynamic';
+
+import { NextRequest, NextResponse } from 'next/server';
+import type { JsonRpcRequest, JsonRpcResponse, SendMessageParams, GetTaskParams, CancelTaskParams } from '@/lib/a2a/types';
+import { A2A_ERRORS } from '@/lib/a2a/types';
+import { handleSendMessage, handleGetTask, handleCancelTask } from '@/lib/a2a/task-handler';
+
+const CORS_HEADERS: Record<string, string> = {
+  'Access-Control-Allow-Origin': '*',
+  'Access-Control-Allow-Methods': 'POST, OPTIONS',
+  'Access-Control-Allow-Headers': 'Content-Type, Authorization, A2A-Version',
+};
+
+function jsonRpcOk(id: string | number | null, result: unknown): JsonRpcResponse {
+  return { jsonrpc: '2.0', id, result };
+}
+
+function jsonRpcError(id: string | number | null, error: { code: number; message: string; data?: unknown }): JsonRpcResponse {
+  return { jsonrpc: '2.0', id, error };
+}
+
+function respond(body: JsonRpcResponse, status = 200) {
+  const res = NextResponse.json(body, { status });
+  for (const [k, v] of Object.entries(CORS_HEADERS)) res.headers.set(k, v);
+  return res;
+}
+
+const MAX_REQUEST_BYTES = 100_000; // 100KB max request body
+
+export async function POST(req: NextRequest) {
+  // Check content length to prevent OOM from oversized payloads
+  const contentLength = Number(req.headers.get('content-length') || 0);
+  if (contentLength > MAX_REQUEST_BYTES) {
+    return respond(jsonRpcError(null, { code: -32600, message: `Request too large (max ${MAX_REQUEST_BYTES} bytes)` }), 413);
+  }
+
+  // Parse JSON-RPC request
+  let rpc: JsonRpcRequest;
+  try {
+    rpc = await req.json();
+  } catch {
+    return respond(jsonRpcError(null, A2A_ERRORS.PARSE_ERROR), 400);
+  }
+
+  if (rpc.jsonrpc !== '2.0' || typeof rpc.method !== 'string') {
+    return respond(jsonRpcError(rpc.id ?? null, A2A_ERRORS.INVALID_REQUEST), 400);
+  }
+
+  try {
+    switch (rpc.method) {
+      case 'SendMessage': {
+        const params = rpc.params as unknown as SendMessageParams;
+        if (!params?.message?.parts?.length) {
+          return respond(jsonRpcError(rpc.id, A2A_ERRORS.INVALID_PARAMS));
+        }
+        const task = await handleSendMessage(params);
+        return respond(jsonRpcOk(rpc.id, task));
+      }
+
+      case 'GetTask': {
+        const params = rpc.params as unknown as GetTaskParams;
+        if (!params?.id) {
+          return respond(jsonRpcError(rpc.id, A2A_ERRORS.INVALID_PARAMS));
+        }
+        const task = handleGetTask(params);
+        if (!task) {
+          return respond(jsonRpcError(rpc.id, A2A_ERRORS.TASK_NOT_FOUND));
+        }
+        return respond(jsonRpcOk(rpc.id, task));
+      }
+
+      case 'CancelTask': {
+        const params = rpc.params as unknown as CancelTaskParams;
+        if (!params?.id) {
+          return respond(jsonRpcError(rpc.id, A2A_ERRORS.INVALID_PARAMS));
+        }
+        const task = handleCancelTask(params);
+        if (!task) {
+          return respond(jsonRpcError(rpc.id, {
+            ...A2A_ERRORS.TASK_NOT_FOUND,
+            message: 'Task not found or not cancelable',
+          }));
+        }
+        return respond(jsonRpcOk(rpc.id, task));
+      }
+
+      default:
+        return respond(jsonRpcError(rpc.id, A2A_ERRORS.METHOD_NOT_FOUND));
+    }
+  } catch (err) {
+    return respond(jsonRpcError(rpc.id, {
+      ...A2A_ERRORS.INTERNAL_ERROR,
+      data: (err as Error).message,
+    }), 500);
+  }
+}
+
+export async function OPTIONS() {
+  return new Response(null, { status: 204, headers: CORS_HEADERS });
+}

package/app/app/api/file/import/route.ts

@@ -7,7 +7,6 @@ import { NextRequest, NextResponse } from 'next/server';
 import { revalidatePath } from 'next/cache';
 import { sanitizeFileName, convertToMarkdown } from '@/lib/core/file-convert';
 import { resolveSafe } from '@/lib/core/security';
-import { scaffoldIfNewSpace } from '@/lib/core/space-scaffold';
 import { organizeAfterImport } from '@/lib/core/organize';
 import { invalidateSearchIndex } from '@/lib/core/search';
 import { effectiveSopRoot } from '@/lib/settings';
@@ -157,7 +156,6 @@ export async function POST(req: NextRequest) {
 
       fs.mkdirSync(path.dirname(resolved), { recursive: true });
       fs.writeFileSync(resolved, convertResult.content, 'utf-8');
-      scaffoldIfNewSpace(mindRoot, finalRel);
 
       created.push({ original: entry.name, path: finalRel });
       createdPaths.push(finalRel);

package/app/app/api/setup/route.ts

@@ -172,6 +172,8 @@ export async function PATCH(req: NextRequest) {
     if (typeof patch.askedAI === 'boolean') updated.askedAI = patch.askedAI;
     if (typeof patch.nextStepIndex === 'number' && patch.nextStepIndex >= 0) updated.nextStepIndex = patch.nextStepIndex;
     if (typeof patch.active === 'boolean') updated.active = patch.active;
+    if (typeof patch.walkthroughStep === 'number' && patch.walkthroughStep >= 0) updated.walkthroughStep = patch.walkthroughStep;
+    if (typeof patch.walkthroughDismissed === 'boolean') updated.walkthroughDismissed = patch.walkthroughDismissed;
 
     writeSettings({ ...current, guideState: updated });
     return NextResponse.json({ ok: true, guideState: updated });

package/app/components/Backlinks.tsx

@@ -58,10 +58,10 @@ export default function Backlinks({ filePath }: { filePath: string }) {
                   <FileText size={14} className="text-muted-foreground group-hover:text-[var(--amber)]" />
                 </div>
                 <div className="min-w-0 flex-1">
-                  <div className="font-medium text-sm text-foreground group-hover:text-[var(--amber)] transition-colors truncate mb-1">
+                  <div className="font-medium text-sm text-foreground group-hover:text-[var(--amber)] transition-colors truncate mb-1" title={link.filePath}>
                     {link.filePath}
                   </div>
-                  <div className="text-xs text-muted-foreground line-clamp-2 leading-relaxed italic opacity-80 group-hover:opacity-100 transition-opacity">
+                  <div className="text-xs text-muted-foreground line-clamp-2 leading-relaxed italic opacity-80 group-hover:opacity-100 transition-opacity" title={link.snippets[0] || ''}>
                     {link.snippets[0] || ''}
                   </div>
                 </div>

package/app/components/Breadcrumb.tsx

@@ -29,7 +29,7 @@ export default function Breadcrumb({ filePath }: { filePath: string }) {
                 <span suppressHydrationWarning>{part}</span>
               </span>
             ) : (
-              <Link href={href} className="hover:text-foreground transition-colors truncate max-w-[200px]">
+              <Link href={href} className="px-2 py-0.5 rounded-md hover:bg-muted/50 transition-colors truncate max-w-[200px]" title={part}>
                 <span suppressHydrationWarning>{part}</span>
               </Link>
             )}

package/app/components/CsvView.tsx

@@ -2,7 +2,7 @@
 
 import { useMemo, useState, useRef, useCallback, useEffect } from 'react';
 import Papa from 'papaparse';
-import { ChevronUp, ChevronDown, ChevronsUpDown, Plus, Trash2 } from 'lucide-react';
+import { ChevronUp, ChevronDown, ChevronsUpDown, Plus, Trash2, Loader2 } from 'lucide-react';
 
 interface CsvViewProps {
   content: string;
@@ -135,6 +135,7 @@ export default function CsvView({ content: initialContent, appendAction, saveAct
   const [sortCol, setSortCol] = useState<number | null>(null);
   const [sortDir, setSortDir] = useState<SortDir>(null);
   const [showAdd, setShowAdd] = useState(false);
+  const [saving, setSaving] = useState(false);
 
   const parsed = useMemo(() => {
     const result = Papa.parse<string[]>(content, { skipEmptyLines: true });
@@ -163,38 +164,57 @@ export default function CsvView({ content: initialContent, appendAction, saveAct
   // Update a single cell and persist
   const handleCellCommit = useCallback(async (rowIdx: number, colIdx: number, newVal: string) => {
     if (!saveAction) return;
-    // rowIdx here is index into sortedRows — need to map back to original rows
-    const updatedRows = rows.map((r, i) => {
-      // find which original row matches this sorted row
+    const updatedRows = rows.map((r) => {
       const sorted = sortedRows[rowIdx];
       if (r === sorted) return r.map((cell, ci) => ci === colIdx ? newVal : cell);
       return r;
     });
     const newContent = serializeRows(headers, updatedRows);
     setContent(newContent);
-    await saveAction(newContent);
+    setSaving(true);
+    try {
+      await saveAction(newContent);
+    } catch (err) {
+      console.error('[CsvView] Cell save failed:', err);
+    } finally {
+      setSaving(false);
+    }
   }, [saveAction, rows, sortedRows, headers]);
 
   // Delete a row and persist
   const handleDeleteRow = useCallback(async (rowIdx: number) => {
-    if (!saveAction) return;
+    if (!saveAction || saving) return;
     const sorted = sortedRows[rowIdx];
     const updatedRows = rows.filter(r => r !== sorted);
     const newContent = serializeRows(headers, updatedRows);
     setContent(newContent);
-    await saveAction(newContent);
-  }, [saveAction, rows, sortedRows, headers]);
+    setSaving(true);
+    try {
+      await saveAction(newContent);
+    } catch (err) {
+      console.error('[CsvView] Row delete failed:', err);
+    } finally {
+      setSaving(false);
+    }
+  }, [saveAction, rows, sortedRows, headers, saving]);
 
   // Append a new row
   const handleAddRow = useCallback(async (newRow: string[]) => {
-    setShowAdd(false);
-    if (appendAction) {
-      const result = await appendAction(newRow);
-      setContent(result.newContent);
-    } else if (saveAction) {
-      const newContent = serializeRows(headers, [...rows, newRow]);
-      setContent(newContent);
-      await saveAction(newContent);
+    setSaving(true);
+    try {
+      if (appendAction) {
+        const result = await appendAction(newRow);
+        setContent(result.newContent);
+      } else if (saveAction) {
+        const newContent = serializeRows(headers, [...rows, newRow]);
+        setContent(newContent);
+        await saveAction(newContent);
+      }
+      setShowAdd(false);
+    } catch (err) {
+      console.error('[CsvView] Add row failed:', err);
+    } finally {
+      setSaving(false);
     }
   }, [appendAction, saveAction, headers, rows]);
 
@@ -266,9 +286,10 @@ export default function CsvView({ content: initialContent, appendAction, saveAct
                     {saveAction && (
                       <button
                         onClick={() => handleDeleteRow(rowIdx)}
-                        className="opacity-0 group-hover:opacity-100 transition-opacity p-1 rounded hover:bg-destructive/10"
+                        disabled={saving}
+                        className="opacity-0 group-hover:opacity-100 transition-opacity p-1 rounded hover:bg-destructive/10 disabled:opacity-30"
                         style={{ color: 'var(--muted-foreground)' }}
-                        title="Delete row"
+                        title={saving ? 'Saving...' : 'Delete row'}
                       >
                         <Trash2 size={12} />
                       </button>
@@ -295,8 +316,9 @@ export default function CsvView({ content: initialContent, appendAction, saveAct
         className="px-4 py-2 flex items-center justify-between"
         style={{ background: 'var(--muted)', borderTop: '1px solid var(--border)' }}
       >
-        <span className="text-xs font-display" style={{ color: 'var(--muted-foreground)' }}>
+        <span className="text-xs font-display flex items-center gap-1.5" style={{ color: 'var(--muted-foreground)' }}>
           {rows.length} rows · {headers.length} cols
+          {saving && <Loader2 size={10} className="animate-spin" style={{ color: 'var(--amber)' }} />}
         </span>
 
         {canEdit && !showAdd && (

package/app/components/DirView.tsx

@@ -207,7 +207,7 @@ export default function DirView({ dirPath, entries, spacePreview }: DirViewProps
                   {entry.type === 'directory'
                     ? <FolderOpen size={22} className="text-yellow-400" />
                     : <FileIconLarge node={entry} />}
-                  <span className="text-xs text-foreground leading-snug line-clamp-2 w-full" suppressHydrationWarning>
+                  <span className="text-xs text-foreground leading-snug line-clamp-2 w-full" title={entry.name} suppressHydrationWarning>
                     {entry.name}
                   </span>
                   {entry.type === 'directory' && (
@@ -230,7 +230,7 @@ export default function DirView({ dirPath, entries, spacePreview }: DirViewProps
                   className="flex items-center gap-3 px-4 py-3 bg-card hover:bg-accent transition-colors duration-100"
                 >
                   <FileIcon node={entry} />
-                  <span className="flex-1 text-sm text-foreground truncate" suppressHydrationWarning>
+                  <span className="flex-1 text-sm text-foreground truncate" title={entry.name} suppressHydrationWarning>
                     {entry.name}
                   </span>
                   {entry.type === 'directory' ? (