@geminilight/mindos 0.6.22 → 0.6.23

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/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/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]">
                 <span suppressHydrationWarning>{part}</span>
               </Link>
             )}

package/app/components/FileTree.tsx

@@ -6,7 +6,7 @@ import { FileNode } from '@/lib/types';
 import { encodePath } from '@/lib/utils';
 import {
   ChevronDown, FileText, Table, Folder, FolderOpen, Plus, Loader2,
-  Trash2, Pencil, Layers, ScrollText, FolderInput,
+  Trash2, Pencil, Layers, ScrollText, FolderInput, Copy,
 } from 'lucide-react';
 import { createFileAction, deleteFileAction, renameFileAction, renameSpaceAction, deleteSpaceAction, convertToSpaceAction, deleteFolderAction } from '@/lib/actions';
 import { useLocale } from '@/lib/LocaleContext';
@@ -16,6 +16,10 @@ function notifyFilesChanged() {
   window.dispatchEvent(new Event('mindos:files-changed'));
 }
 
+async function copyPathToClipboard(path: string) {
+  try { await navigator.clipboard.writeText(path); } catch { /* noop */ }
+}
+
 const SYSTEM_FILES = new Set(['INSTRUCTION.md', 'README.md']);
 
 const HIDDEN_FILES_KEY = 'show-hidden-files';
@@ -141,6 +145,9 @@ function SpaceContextMenu({ x, y, node, onClose, onRename, onImport, onDelete }:
           <FolderInput size={14} className="shrink-0" /> {t.fileTree.importFile}
         </button>
       )}
+      <button className={MENU_ITEM} onClick={() => { copyPathToClipboard(node.path); onClose(); }}>
+        <Copy size={14} className="shrink-0" /> {t.fileTree.copyPath}
+      </button>
       <button className={MENU_ITEM} onClick={() => { onRename(); onClose(); }}>
         <Pencil size={14} className="shrink-0" /> {t.fileTree.renameSpace}
       </button>
@@ -173,6 +180,9 @@ function FolderContextMenu({ x, y, node, onClose, onRename, onDelete }: {
       }}>
         <Layers size={14} className="shrink-0 text-[var(--amber)]" /> {t.fileTree.convertToSpace}
       </button>
+      <button className={MENU_ITEM} onClick={() => { copyPathToClipboard(node.path); onClose(); }}>
+        <Copy size={14} className="shrink-0" /> {t.fileTree.copyPath}
+      </button>
       <button className={MENU_ITEM} onClick={() => { onRename(); onClose(); }}>
         <Pencil size={14} className="shrink-0" /> {t.fileTree.rename}
       </button>
@@ -643,6 +653,9 @@ function FileNodeItem({ node, depth, currentPath, onNavigate }: {
         <span className="truncate leading-5" suppressHydrationWarning>{node.name}</span>
       </button>
       <div className="absolute right-1 top-1/2 -translate-y-1/2 hidden group-hover/file:flex items-center gap-0.5">
+        <button onClick={() => copyPathToClipboard(node.path)} className="p-0.5 rounded text-muted-foreground hover:text-foreground hover:bg-muted transition-colors" title={t.fileTree.copyPath}>
+          <Copy size={12} />
+        </button>
         <button onClick={startRename} className="p-0.5 rounded text-muted-foreground hover:text-foreground hover:bg-muted transition-colors" title={t.fileTree.rename}>
           <Pencil size={12} />
         </button>

package/app/components/HomeContent.tsx

@@ -159,7 +159,7 @@ function FeatureChip({ id, icon, name, entryPath, active, inactiveTitle }: {
   );
 
   if (active && entryPath) {
-    return <Link key={id} href={`/view/${encodePath(entryPath)}`}><span className={cls}>{inner}</span></Link>;
+    return <Link key={id} href={`/view/${encodePath(entryPath)}`} className={cls}>{inner}</Link>;
   }
   return <span key={id} className={cls} title={inactiveTitle}>{inner}</span>;
 }

package/app/components/RightAskPanel.tsx

@@ -21,11 +21,14 @@ interface RightAskPanelProps {
   onWidthCommit: (w: number) => void;
   askMode?: 'panel' | 'popup';
   onModeSwitch?: () => void;
+  maximized?: boolean;
+  onMaximize?: () => void;
 }
 
 export default function RightAskPanel({
   open, onClose, currentFile, initialMessage, onFirstMessage,
   width, onWidthChange, onWidthCommit, askMode, onModeSwitch,
+  maximized = false, onMaximize,
 }: RightAskPanelProps) {
   const handleMouseDown = useResizeDrag({
     width,
@@ -42,10 +45,11 @@ export default function RightAskPanel({
       className={`
         hidden md:flex fixed top-0 right-0 h-screen z-40
         flex-col bg-card border-l border-border
-        transition-transform duration-200 ease-out
+        transition-all duration-200 ease-out
         ${open ? 'translate-x-0' : 'translate-x-full pointer-events-none'}
+        ${maximized ? 'border-l-0' : ''}
       `}
-      style={{ width: `${width}px` }}
+      style={{ width: maximized ? '100vw' : `${width}px` }}
       role="complementary"
       aria-label="MindOS Agent panel"
     >
@@ -61,7 +65,6 @@ export default function RightAskPanel({
           </button>
         </div>
       }>
-        {/* Flex column + min-h-0 so MessageList flex-1 gets a bounded height (fragment children are direct flex items) */}
         <div className="flex min-h-0 w-full flex-1 flex-col overflow-hidden">
           <AskContent
             visible={open}
@@ -72,17 +75,21 @@ export default function RightAskPanel({
             onClose={onClose}
             askMode={askMode}
             onModeSwitch={onModeSwitch}
+            maximized={maximized}
+            onMaximize={onMaximize}
           />
         </div>
       </ErrorBoundary>
 
-      {/* Drag resize handle — LEFT edge */}
-      <div
-        className="absolute top-0 -left-[3px] w-[6px] h-full cursor-col-resize z-40 group hidden md:block"
-        onMouseDown={handleMouseDown}
-      >
-        <div className="absolute left-[2px] top-0 w-[2px] h-full opacity-0 group-hover:opacity-100 bg-[var(--amber)]/60 transition-opacity" />
-      </div>
+      {/* Drag resize handle — LEFT edge (hidden when maximized) */}
+      {!maximized && (
+        <div
+          className="absolute top-0 -left-[3px] w-[6px] h-full cursor-col-resize z-40 group hidden md:block"
+          onMouseDown={handleMouseDown}
+        >
+          <div className="absolute left-[2px] top-0 w-[2px] h-full opacity-0 group-hover:opacity-100 bg-[var(--amber)]/60 transition-opacity" />
+        </div>
+      )}
     </aside>
   );
 }

package/app/components/SidebarLayout.tsx

@@ -413,6 +413,8 @@ export default function SidebarLayout({ fileTree, children }: SidebarLayoutProps
         onWidthCommit={ap.handleAskWidthCommit}
         askMode={ap.askMode}
         onModeSwitch={ap.handleAskModeSwitch}
+        maximized={ap.askMaximized}
+        onMaximize={ap.toggleAskMaximized}
       />
 
       <RightAgentDetailPanel
@@ -493,7 +495,7 @@ export default function SidebarLayout({ fileTree, children }: SidebarLayoutProps
 
       <main
         id="main-content"
-        className="min-h-screen transition-all duration-200 pt-[52px] md:pt-0"
+        className={`min-h-screen transition-all duration-200 pt-[52px] md:pt-0 ${ap.askMaximized ? 'hidden' : ''}`}
         onDragEnter={(e) => {
           if (!e.dataTransfer.types.includes('Files')) return;
           e.preventDefault();
@@ -560,7 +562,7 @@ export default function SidebarLayout({ fileTree, children }: SidebarLayoutProps
       <style>{`
         @media (min-width: 768px) {
           :root {
-            --right-panel-width: ${ap.askPanelOpen ? ap.askPanelWidth : 0}px;
+            --right-panel-width: ${ap.askMaximized ? '100vw' : `${ap.askPanelOpen ? ap.askPanelWidth : 0}px`};
             --right-agent-detail-width: ${agentDockOpen ? agentDetailWidth : 0}px;
           }
           #main-content {

package/app/components/ask/AskContent.tsx

@@ -601,24 +601,24 @@ export default function AskContent({ visible, currentFile, initialMessage, onFir
           </span>
         </div>
         <div className="flex items-center gap-1">
-          <button type="button" onClick={() => setShowHistory(v => !v)} aria-pressed={showHistory} className={`p-1 rounded transition-colors ${showHistory ? 'bg-muted text-foreground' : 'text-muted-foreground hover:text-foreground hover:bg-muted'}`} title="Session history">
+          <button type="button" onClick={() => setShowHistory(v => !v)} aria-pressed={showHistory} className={`p-1.5 rounded transition-colors ${showHistory ? 'bg-muted text-foreground' : 'text-muted-foreground hover:text-foreground hover:bg-muted'}`} title="Session history">
             <History size={iconSize} />
           </button>
-          <button type="button" onClick={handleResetSession} disabled={isLoading} className="p-1 rounded hover:bg-muted text-muted-foreground hover:text-foreground transition-colors disabled:opacity-40" title="New session">
+          <button type="button" onClick={handleResetSession} disabled={isLoading} className="p-1.5 rounded hover:bg-muted text-muted-foreground hover:text-foreground transition-colors disabled:opacity-40" title="New session">
             <RotateCcw size={iconSize} />
           </button>
           {isPanel && onMaximize && (
-            <button type="button" onClick={onMaximize} className="p-1 rounded hover:bg-muted text-muted-foreground hover:text-foreground transition-colors" title={maximized ? 'Restore panel' : 'Maximize panel'}>
+            <button type="button" onClick={onMaximize} className="p-1.5 rounded hover:bg-muted text-muted-foreground hover:text-foreground transition-colors" title={maximized ? 'Restore panel' : 'Maximize panel'}>
               {maximized ? <Minimize2 size={iconSize} /> : <Maximize2 size={iconSize} />}
             </button>
           )}
           {onModeSwitch && (
-            <button type="button" onClick={onModeSwitch} className="p-1 rounded hover:bg-muted text-muted-foreground hover:text-foreground transition-colors" title={askMode === 'popup' ? 'Dock to side panel' : 'Open as popup'}>
+            <button type="button" onClick={onModeSwitch} className="p-1.5 rounded hover:bg-muted text-muted-foreground hover:text-foreground transition-colors" title={askMode === 'popup' ? 'Dock to side panel' : 'Open as popup'}>
               {askMode === 'popup' ? <PanelRight size={iconSize} /> : <AppWindow size={iconSize} />}
             </button>
           )}
           {onClose && (
-            <button type="button" onClick={onClose} className="p-1 rounded hover:bg-muted text-muted-foreground hover:text-foreground transition-colors" aria-label="Close">
+            <button type="button" onClick={onClose} className="p-1.5 rounded hover:bg-muted text-muted-foreground hover:text-foreground transition-colors" aria-label="Close">
               <X size={isPanel ? iconSize : 15} />
             </button>
           )}

package/app/components/ask/FileChip.tsx

@@ -22,7 +22,7 @@ export default function FileChip({ path, onRemove, variant = 'kb' }: FileChipPro
         type="button"
         onClick={onRemove}
         aria-label={`Remove ${name}`}
-        className="text-muted-foreground hover:text-foreground ml-0.5 shrink-0"
+        className="p-1 -mr-1 rounded hover:bg-muted hover:text-foreground transition-colors shrink-0"
       >
         <X size={10} />
       </button>

package/app/components/ask/MessageList.tsx

@@ -137,7 +137,7 @@ export default function MessageList({
   }, [messages]);
 
   return (
-    <div className="flex-1 overflow-y-auto px-4 py-4 space-y-4 min-h-0">
+    <div className="flex-1 overflow-y-auto overflow-x-hidden px-4 py-4 space-y-4 min-h-0">
       {messages.length === 0 && (
         <div className="mt-6 space-y-3">
           <p className="text-center text-sm text-muted-foreground/60">{emptyPrompt}</p>

package/app/hooks/useAskPanel.ts

@@ -7,6 +7,7 @@ import { useAskModal } from './useAskModal';
 export interface AskPanelState {
   askPanelOpen: boolean;
   askPanelWidth: number;
+  askMaximized: boolean;
   askMode: 'panel' | 'popup';
   desktopAskPopupOpen: boolean;
   askInitialMessage: string;
@@ -17,6 +18,7 @@ export interface AskPanelState {
   handleAskWidthChange: (w: number) => void;
   handleAskWidthCommit: (w: number) => void;
   handleAskModeSwitch: () => void;
+  toggleAskMaximized: () => void;
 }
 
 /**
@@ -29,6 +31,7 @@ export function useAskPanel(): AskPanelState {
   const [askMode, setAskMode] = useState<'panel' | 'popup'>('panel');
   const [desktopAskPopupOpen, setDesktopAskPopupOpen] = useState(false);
   const [askInitialMessage, setAskInitialMessage] = useState('');
+  const [askMaximized, setAskMaximized] = useState(false);
   const [askOpenSource, setAskOpenSource] = useState<'user' | 'guide' | 'guide-next'>('user');
 
   const askModal = useAskModal();
@@ -82,7 +85,8 @@ export function useAskPanel(): AskPanelState {
     }
   }, [askMode]);
 
-  const closeAskPanel = useCallback(() => setAskPanelOpen(false), []);
+  const closeAskPanel = useCallback(() => { setAskPanelOpen(false); setAskMaximized(false); }, []);
+  const toggleAskMaximized = useCallback(() => setAskMaximized(v => !v), []);
   const closeDesktopAskPopup = useCallback(() => setDesktopAskPopupOpen(false), []);
 
   const handleAskWidthChange = useCallback((w: number) => setAskPanelWidth(w), []);
@@ -109,9 +113,9 @@ export function useAskPanel(): AskPanelState {
   }, []);
 
   return {
-    askPanelOpen, askPanelWidth, askMode, desktopAskPopupOpen,
+    askPanelOpen, askPanelWidth, askMaximized, askMode, desktopAskPopupOpen,
     askInitialMessage, askOpenSource,
     toggleAskPanel, closeAskPanel, closeDesktopAskPopup,
-    handleAskWidthChange, handleAskWidthCommit, handleAskModeSwitch,
+    handleAskWidthChange, handleAskWidthCommit, handleAskModeSwitch, toggleAskMaximized,
   };
 }

package/app/hooks/useFileImport.ts

@@ -106,7 +106,7 @@ export function useFileImport() {
       const merged = [...prev];
       for (const f of newFiles) {
         const isDup = merged.some(m =>
-          m.name === f.name && m.size === f.size
+          m.name === f.name && m.size === f.size && m.file.lastModified === f.file.lastModified
         );
         if (!isDup && merged.length < MAX_FILES) merged.push(f);
       }

package/app/lib/agent/tools.ts

@@ -532,7 +532,7 @@ export const knowledgeBaseTools: AgentTool<any>[] = [
   {
     name: 'create_file',
     label: 'Create File',
-    description: 'Create a new file. Only .md and .csv files are allowed. Parent directories are created automatically.',
+    description: 'Create a new file. Only .md and .csv files are allowed. Parent directories are created automatically. Does NOT create Space scaffolding (INSTRUCTION.md/README.md). Use create_space to create a Space.',
     parameters: CreateFileParams,
     execute: safeExecute(async (_id, params: Static<typeof CreateFileParams>) => {
       createFile(params.path, params.content ?? '');

package/app/lib/core/fs-ops.ts

@@ -2,7 +2,7 @@ import fs from 'fs';
 import path from 'path';
 import { resolveSafe, assertWithinRoot } from './security';
 import { MindOSError, ErrorCodes } from '@/lib/errors';
-import { scaffoldIfNewSpace, cleanDirName, INSTRUCTION_TEMPLATE, README_TEMPLATE } from './space-scaffold';
+import { cleanDirName, INSTRUCTION_TEMPLATE, README_TEMPLATE } from './space-scaffold';
 
 /**
  * Reads the content of a file given a relative path from mindRoot.
@@ -33,6 +33,8 @@ export function writeFile(mindRoot: string, filePath: string, content: string):
 /**
  * Creates a new file. Throws if the file already exists.
  * Creates parent directories as needed.
+ * NOTE: Does NOT auto-scaffold Space files (INSTRUCTION.md/README.md).
+ * Use createSpaceFilesystem() or convertToSpace() for explicit Space creation.
  */
 export function createFile(mindRoot: string, filePath: string, initialContent = ''): void {
   const resolved = resolveSafe(mindRoot, filePath);
@@ -41,7 +43,6 @@ export function createFile(mindRoot: string, filePath: string, initialContent =
   }
   fs.mkdirSync(path.dirname(resolved), { recursive: true });
   fs.writeFileSync(resolved, initialContent, 'utf-8');
-  scaffoldIfNewSpace(mindRoot, filePath);
 }
 
 /**