@piut/cli 3.6.0 → 3.7.0

package/dist/cli.js

@@ -122,7 +122,10 @@ async function pingMcp(serverUrl, key, toolName) {
       headers: {
         Authorization: `Bearer ${key}`,
         "Content-Type": "application/json",
-        "User-Agent": `piut-cli (configured: ${toolName})`
+        "User-Agent": `piut-cli (configured: ${toolName})`,
+        "X-Piut-Hostname": os.hostname(),
+        "X-Piut-Machine-Id": getMachineId(),
+        "X-Piut-Tool": toolName
       },
       body: JSON.stringify({
         jsonrpc: "2.0",
@@ -167,6 +170,9 @@ function getMachineId() {
   const hostname = os.hostname();
   return crypto.createHash("sha256").update(hostname).digest("hex").slice(0, 16);
 }
+function getHostname() {
+  return os.hostname();
+}
 async function registerProject(key, project) {
   const res = await fetch(`${API_BASE}/api/cli/projects`, {
     method: "POST",
@@ -209,55 +215,88 @@ async function deleteConnections(key, toolNames) {
   } catch {
   }
 }
-async function resyncBrain(serverUrl, key, content) {
-  const res = await fetch(serverUrl, {
+async function unpublishServer(key) {
+  const res = await fetch(`${API_BASE}/api/mcp/publish`, {
     method: "POST",
     headers: {
       Authorization: `Bearer ${key}`,
       "Content-Type": "application/json"
     },
-    body: JSON.stringify({
-      jsonrpc: "2.0",
-      id: 1,
-      method: "tools/call",
-      params: {
-        name: "update_brain",
-        arguments: { content }
-      }
-    })
+    body: JSON.stringify({ published: false })
   });
   if (!res.ok) {
-    throw new Error(`Resync failed (HTTP ${res.status})`);
+    const body = await res.json().catch(() => ({ error: "Unknown error" }));
+    throw new Error(body.error || `Unpublish failed (HTTP ${res.status})`);
   }
-  const data = await res.json();
-  if (data.error) {
-    throw new Error(data.error.message || "Resync failed");
+  return res.json();
+}
+async function listVaultFiles(key) {
+  const res = await fetch(`${API_BASE}/api/cli/vault`, {
+    headers: { Authorization: `Bearer ${key}` }
+  });
+  if (!res.ok) {
+    const body = await res.json().catch(() => ({ error: "Unknown error" }));
+    throw new Error(body.error || `Failed to list vault files (HTTP ${res.status})`);
   }
-  const resultContent = data.result?.content;
-  const text = Array.isArray(resultContent) && resultContent[0]?.text ? resultContent[0].text : "Brain updated";
-  return { summary: text };
+  return res.json();
 }
-async function unpublishServer(key) {
-  const res = await fetch(`${API_BASE}/api/mcp/publish`, {
+async function uploadVaultFile(key, filename, content) {
+  const res = await fetch(`${API_BASE}/api/cli/vault/upload`, {
     method: "POST",
     headers: {
       Authorization: `Bearer ${key}`,
       "Content-Type": "application/json"
     },
-    body: JSON.stringify({ published: false })
+    body: JSON.stringify({ filename, content })
   });
   if (!res.ok) {
     const body = await res.json().catch(() => ({ error: "Unknown error" }));
-    throw new Error(body.error || `Unpublish failed (HTTP ${res.status})`);
+    throw new Error(body.error || `Upload failed (HTTP ${res.status})`);
+  }
+  return res.json();
+}
+async function readVaultFile(key, filename) {
+  const encoded = encodeURIComponent(filename);
+  const res = await fetch(`${API_BASE}/api/cli/vault/${encoded}`, {
+    headers: { Authorization: `Bearer ${key}` }
+  });
+  if (!res.ok) {
+    const body = await res.json().catch(() => ({ error: "Unknown error" }));
+    throw new Error(body.error || `Failed to read vault file (HTTP ${res.status})`);
   }
   return res.json();
 }
+async function deleteVaultFile(key, filename) {
+  const res = await fetch(`${API_BASE}/api/cli/vault`, {
+    method: "DELETE",
+    headers: {
+      Authorization: `Bearer ${key}`,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify({ filename })
+  });
+  if (!res.ok) {
+    const body = await res.json().catch(() => ({ error: "Unknown error" }));
+    throw new Error(body.error || `Delete failed (HTTP ${res.status})`);
+  }
+}
 
 // src/lib/tools.ts
 import os2 from "os";
 import path from "path";
+import crypto2 from "crypto";
 var MCP_URL = (slug) => `https://piut.com/api/mcp/${slug}`;
 var AUTH_HEADER = (key) => ({ Authorization: `Bearer ${key}` });
+function getMachineId2() {
+  return crypto2.createHash("sha256").update(os2.hostname()).digest("hex").slice(0, 16);
+}
+function machineHeaders(toolName) {
+  return {
+    "X-Piut-Hostname": os2.hostname(),
+    "X-Piut-Machine-Id": getMachineId2(),
+    "X-Piut-Tool": toolName
+  };
+}
 function appData() {
   return process.env.APPDATA || path.join(os2.homedir(), "AppData", "Roaming");
 }
@@ -269,18 +308,19 @@ var TOOLS = [
     configPaths: {
       darwin: ["~/.claude.json"],
       win32: ["~/.claude.json"],
-      linux: ["~/.claude.json"]
+      linux: ["~/.claude.json"],
+      project: [".mcp.json"]
     },
     skillFilePath: "CLAUDE.md",
     quickCommand: (slug, key) => `claude mcp add-json piut-context '${JSON.stringify({
       type: "http",
       url: MCP_URL(slug),
-      headers: AUTH_HEADER(key)
+      headers: { ...AUTH_HEADER(key), ...machineHeaders("Claude Code") }
     })}'`,
     generateConfig: (slug, key) => ({
       type: "http",
       url: MCP_URL(slug),
-      headers: AUTH_HEADER(key)
+      headers: { ...AUTH_HEADER(key), ...machineHeaders("Claude Code") }
     })
   },
   {
@@ -316,7 +356,7 @@ var TOOLS = [
     skillFilePath: ".cursor/rules/piut.mdc",
     generateConfig: (slug, key) => ({
       url: MCP_URL(slug),
-      headers: AUTH_HEADER(key)
+      headers: { ...AUTH_HEADER(key), ...machineHeaders("Cursor") }
     })
   },
   {
@@ -331,7 +371,7 @@ var TOOLS = [
     skillFilePath: ".windsurf/rules/piut.md",
     generateConfig: (slug, key) => ({
       serverUrl: MCP_URL(slug),
-      headers: AUTH_HEADER(key)
+      headers: { ...AUTH_HEADER(key), ...machineHeaders("Windsurf") }
     })
   },
   {
@@ -345,7 +385,7 @@ var TOOLS = [
     generateConfig: (slug, key) => ({
       type: "http",
       url: MCP_URL(slug),
-      headers: AUTH_HEADER(key)
+      headers: { ...AUTH_HEADER(key), ...machineHeaders("GitHub Copilot") }
     })
   },
   {
@@ -361,7 +401,7 @@ var TOOLS = [
     generateConfig: (slug, key) => ({
       type: "http",
       url: MCP_URL(slug),
-      headers: AUTH_HEADER(key)
+      headers: { ...AUTH_HEADER(key), ...machineHeaders("Amazon Q") }
     })
   },
   {
@@ -376,9 +416,49 @@ var TOOLS = [
     generateConfig: (slug, key) => ({
       settings: {
         url: MCP_URL(slug),
-        headers: AUTH_HEADER(key)
+        headers: { ...AUTH_HEADER(key), ...machineHeaders("Zed") }
       }
     })
+  },
+  {
+    id: "gemini-cli",
+    name: "Gemini CLI",
+    configKey: "mcpServers",
+    configPaths: {
+      darwin: ["~/.gemini/settings.json"],
+      win32: ["~/.gemini/settings.json"],
+      linux: ["~/.gemini/settings.json"],
+      project: [".gemini/settings.json"]
+    },
+    generateConfig: (slug, key) => ({
+      httpUrl: MCP_URL(slug),
+      headers: { ...AUTH_HEADER(key), ...machineHeaders("Gemini CLI") }
+    })
+  },
+  {
+    id: "openclaw",
+    name: "OpenClaw",
+    configKey: "mcpServers",
+    configPaths: {
+      darwin: ["~/.mcporter/mcporter.json", "~/.openclaw/workspace/config/mcporter.json"],
+      win32: ["~/.mcporter/mcporter.json", "~/.openclaw/workspace/config/mcporter.json"],
+      linux: ["~/.mcporter/mcporter.json", "~/.openclaw/workspace/config/mcporter.json"]
+    },
+    quickCommand: (slug, key) => `npx mcporter config add piut-context ${MCP_URL(slug)} --header "Authorization=Bearer ${key}"`,
+    generateConfig: (slug, key) => ({
+      url: MCP_URL(slug),
+      headers: { ...AUTH_HEADER(key), ...machineHeaders("OpenClaw") }
+    })
+  },
+  {
+    id: "paperclip",
+    name: "Paperclip",
+    skillOnly: true,
+    configPaths: {
+      darwin: ["~/.paperclip/config.json"],
+      win32: ["~/.paperclip/config.json"],
+      linux: ["~/.paperclip/config.json"]
+    }
   }
 ];
 
@@ -471,6 +551,28 @@ function extractKeyFromConfig(piutConfig) {
   }
   return null;
 }
+function extractSlugFromConfig(piutConfig) {
+  const slugFromUrl = (u) => {
+    if (typeof u !== "string") return null;
+    const m = u.match(/\/api\/mcp\/([^/?#]+)/);
+    return m ? m[1] : null;
+  };
+  const fromUrl = slugFromUrl(piutConfig.url) || slugFromUrl(piutConfig.serverUrl) || slugFromUrl(piutConfig.httpUrl);
+  if (fromUrl) return fromUrl;
+  const settings = piutConfig.settings;
+  if (settings) {
+    const fromSettings = slugFromUrl(settings.url);
+    if (fromSettings) return fromSettings;
+  }
+  const args2 = piutConfig.args;
+  if (Array.isArray(args2)) {
+    for (const arg of args2) {
+      const fromArg = slugFromUrl(arg);
+      if (fromArg) return fromArg;
+    }
+  }
+  return null;
+}
 function removeFromConfig(filePath, configKey) {
   const config = readConfig(filePath);
   if (!config) return false;
@@ -781,20 +883,25 @@ async function setupCommand(options) {
   const toolFilter = options.tool;
   for (const tool of TOOLS) {
     if (toolFilter && tool.id !== toolFilter) continue;
+    if (tool.skillOnly) continue;
     const paths = resolveConfigPaths(tool.configPaths);
     for (const configPath of paths) {
       const exists = fs4.existsSync(configPath);
       const parentExists = fs4.existsSync(path6.dirname(configPath));
       if (exists || parentExists) {
-        const configured2 = exists && isPiutConfigured(configPath, tool.configKey);
+        const configured2 = exists && !!tool.configKey && isPiutConfigured(configPath, tool.configKey);
         let staleKey = false;
-        if (configured2) {
+        if (configured2 && tool.configKey) {
           const piutConfig = getPiutConfig(configPath, tool.configKey);
           if (piutConfig) {
             const existingKey = extractKeyFromConfig(piutConfig);
             if (existingKey && existingKey !== apiKey) {
               staleKey = true;
             }
+            const existingSlug = extractSlugFromConfig(piutConfig);
+            if (existingSlug && existingSlug !== slug) {
+              staleKey = true;
+            }
           }
         }
         detected.push({
@@ -810,7 +917,6 @@ async function setupCommand(options) {
   }
   if (detected.length === 0) {
     console.log(warning("  No supported AI tools detected."));
-    console.log(dim("  Supported: Claude Code, Claude Desktop, Cursor, Windsurf, GitHub Copilot, Amazon Q, Zed"));
     console.log(dim("  See https://piut.com/docs for manual setup."));
     console.log();
     return;
@@ -862,7 +968,7 @@ async function setupCommand(options) {
       try {
         execSync(tool.quickCommand(slug, apiKey), { stdio: "pipe" });
         const claudeJson = expandPath("~/.claude.json");
-        const written = getPiutConfig(claudeJson, tool.configKey);
+        const written = tool.configKey ? getPiutConfig(claudeJson, tool.configKey) : null;
         if (written) {
           quickSuccess = true;
           configured.push(tool.name);
@@ -871,7 +977,7 @@ async function setupCommand(options) {
         }
         try {
           execSync(tool.quickCommand(slug, apiKey) + " --scope user", { stdio: "pipe" });
-          const retryCheck = getPiutConfig(claudeJson, tool.configKey);
+          const retryCheck = tool.configKey ? getPiutConfig(claudeJson, tool.configKey) : null;
           if (retryCheck) {
             quickSuccess = true;
             configured.push(tool.name);
@@ -890,10 +996,12 @@ async function setupCommand(options) {
       }
       if (quickSuccess) continue;
     }
-    const serverConfig = tool.generateConfig(slug, apiKey);
-    mergeConfig(configPath, tool.configKey, serverConfig);
-    configured.push(tool.name);
-    toolLine(tool.name, success("configured"), "\u2714");
+    if (tool.generateConfig && tool.configKey) {
+      const serverConfig = tool.generateConfig(slug, apiKey);
+      mergeConfig(configPath, tool.configKey, serverConfig);
+      configured.push(tool.name);
+      toolLine(tool.name, success("configured"), "\u2714");
+    }
   }
   if (!options.skipSkill && configured.length > 0) {
     const addSkill = options.yes ? true : await confirm({
@@ -934,6 +1042,7 @@ async function setupCommand(options) {
     console.log(dim("  Verifying..."));
     for (const det of selected) {
       if (!configured.includes(det.tool.name)) continue;
+      if (!det.tool.configKey) continue;
       const piutConfig = getPiutConfig(det.configPath, det.tool.configKey);
       if (piutConfig) {
         toolLine(det.tool.name, success("config verified"), "\u2714");
@@ -976,6 +1085,7 @@ function isCommandAvailable(cmd) {
 
 // src/commands/status.ts
 import fs9 from "fs";
+import os7 from "os";
 import path12 from "path";
 import chalk3 from "chalk";
 
@@ -1394,7 +1504,10 @@ var INCLUDE_DOT_DIRS = /* @__PURE__ */ new Set([
   ".openclaw",
   ".zed",
   ".github",
-  ".amazonq"
+  ".amazonq",
+  ".gemini",
+  ".mcporter",
+  ".paperclip"
 ]);
 function getDefaultScanDirs() {
   const dirs = [];
@@ -1456,7 +1569,11 @@ var SCAN_DOT_DIRS = /* @__PURE__ */ new Set([
   ".github",
   ".zed",
   ".amazonq",
-  ".vscode"
+  ".vscode",
+  ".gemini",
+  ".openclaw",
+  ".mcporter",
+  ".paperclip"
 ]);
 function shouldSkipDir(name) {
   if (name.startsWith(".") && !SCAN_DOT_DIRS.has(name)) return true;
@@ -1543,7 +1660,9 @@ function collectConfigFiles(projects, onProgress) {
     path10.join(home2, ".claude", "MEMORY.md"),
     path10.join(home2, ".claude", "CLAUDE.md"),
     path10.join(home2, ".openclaw", "workspace", "SOUL.md"),
-    path10.join(home2, ".openclaw", "workspace", "MEMORY.md")
+    path10.join(home2, ".openclaw", "workspace", "MEMORY.md"),
+    path10.join(home2, ".gemini", "MEMORY.md"),
+    path10.join(home2, ".paperclip", "IDENTITY.md")
   ];
   for (const gp of globalPaths) {
     try {
@@ -1715,6 +1834,7 @@ function clearStore() {
 }
 
 // src/commands/status.ts
+var API_BASE3 = process.env.PIUT_API_BASE || "https://piut.com";
 var PIUT_FILES = [
   "CLAUDE.md",
   ".cursor/rules/piut.mdc",
@@ -1731,13 +1851,55 @@ function hasPiutReference(filePath) {
     return false;
   }
 }
+async function fetchRemoteConnections(key) {
+  try {
+    const res = await fetch(`${API_BASE3}/api/mcp/connections`, {
+      headers: { Authorization: `Bearer ${key}` }
+    });
+    if (!res.ok) return [];
+    const data = await res.json();
+    return data.connections || [];
+  } catch {
+    return [];
+  }
+}
+async function fetchRemoteProjects(key) {
+  try {
+    const res = await fetch(`${API_BASE3}/api/cli/projects`, {
+      headers: { Authorization: `Bearer ${key}` }
+    });
+    if (!res.ok) return [];
+    const data = await res.json();
+    return data.projects || [];
+  } catch {
+    return [];
+  }
+}
+function machineLabel(hostname, machineId) {
+  if (hostname) return hostname;
+  if (machineId && machineId !== "unknown") return machineId.slice(0, 8);
+  return "unknown";
+}
+function timeAgo(dateStr) {
+  const diff = Date.now() - new Date(dateStr).getTime();
+  const minutes = Math.floor(diff / 6e4);
+  if (minutes < 1) return "just now";
+  if (minutes < 60) return `${minutes}m ago`;
+  const hours = Math.floor(minutes / 60);
+  if (hours < 24) return `${hours}h ago`;
+  const days = Math.floor(hours / 24);
+  if (days < 7) return `${days}d ago`;
+  return new Date(dateStr).toLocaleDateString();
+}
 async function statusCommand(options = {}) {
   banner();
   if (options.verify) {
     await verifyStatus();
     return;
   }
-  console.log("  AI tool configuration:");
+  const thisHostname = os7.hostname();
+  const thisMachineId = getMachineId2();
+  console.log(`  AI tools on this machine ${dim(`(${thisHostname})`)}:`);
   console.log();
   let foundAny = false;
   for (const tool of TOOLS) {
@@ -1759,7 +1921,7 @@ async function statusCommand(options = {}) {
     console.log(dim("  Run ") + brand("piut setup") + dim(" to configure your AI tools."));
   }
   console.log();
-  console.log("  Connected projects:");
+  console.log(`  Connected projects on this machine:`);
   console.log();
   const projects = scanForProjects();
   let connectedCount = 0;
@@ -1784,6 +1946,33 @@ async function statusCommand(options = {}) {
     console.log(dim(`  ${connectedCount} project(s) connected to your brain.`));
   }
   console.log();
+  const store = readStore();
+  if (store.apiKey) {
+    const [remoteConnections, remoteProjects] = await Promise.all([
+      fetchRemoteConnections(store.apiKey),
+      fetchRemoteProjects(store.apiKey)
+    ]);
+    const otherMachineConns = remoteConnections.filter((c) => c.machine_id !== thisMachineId);
+    const otherMachineProjects = remoteProjects.filter((p) => p.machineId !== thisMachineId);
+    if (otherMachineConns.length > 0 || otherMachineProjects.length > 0) {
+      console.log(`  Other machines:`);
+      console.log();
+      if (otherMachineConns.length > 0) {
+        for (const conn of otherMachineConns) {
+          const machine = machineLabel(conn.hostname, conn.machine_id);
+          const age = timeAgo(conn.last_connected_at);
+          console.log(dim(`  ${conn.tool_name}`) + dim(` @${machine}`) + dim(` \u2014 ${conn.request_count} requests, ${age}`));
+        }
+      }
+      if (otherMachineProjects.length > 0) {
+        for (const proj of otherMachineProjects) {
+          const machine = machineLabel(proj.hostname, proj.machineId);
+          console.log(dim(`  ${proj.projectName}`) + dim(` @${machine}:${proj.projectPath}`));
+        }
+      }
+      console.log();
+    }
+  }
 }
 async function verifyStatus() {
   const store = readStore();
@@ -1862,6 +2051,7 @@ async function removeCommand() {
   banner();
   const configured = [];
   for (const tool of TOOLS) {
+    if (!tool.configKey) continue;
     const paths = resolveConfigPaths(tool.configPaths);
     for (const configPath of paths) {
       if (fs10.existsSync(configPath) && isPiutConfigured(configPath, tool.configKey)) {
@@ -1895,6 +2085,7 @@ async function removeCommand() {
   console.log();
   const removedNames = [];
   for (const { tool, configPath } of selected) {
+    if (!tool.configKey) continue;
     const removed = removeFromConfig(configPath, tool.configKey);
     if (removed) {
       removedNames.push(tool.name);
@@ -1916,7 +2107,7 @@ async function removeCommand() {
 // src/commands/build.ts
 import { select as select2, checkbox as checkbox3, input as input2, confirm as confirm3 } from "@inquirer/prompts";
 import chalk5 from "chalk";
-import os7 from "os";
+import os8 from "os";
 
 // src/lib/auth.ts
 import { select, input, password as password2 } from "@inquirer/prompts";
@@ -2212,7 +2403,7 @@ async function buildCommand(options) {
 }
 async function selectFolders() {
   const defaults = getDefaultScanDirs();
-  const homeDir = os7.homedir();
+  const homeDir = os8.homedir();
   const ALL_VALUE = "__all__";
   const CUSTOM_VALUE = "__custom__";
   const choices = [
@@ -2360,6 +2551,18 @@ var RULE_FILES = [
     filePath: ".zed/rules.md",
     strategy: "create",
     detect: (p) => p.hasZedRules || fs11.existsSync(path13.join(p.path, ".zed"))
+  },
+  {
+    tool: "Gemini CLI",
+    filePath: "GEMINI.md",
+    strategy: "append",
+    detect: (p) => fs11.existsSync(path13.join(p.path, ".gemini"))
+  },
+  {
+    tool: "Paperclip",
+    filePath: "AGENTS.md",
+    strategy: "append",
+    detect: (p) => fs11.existsSync(path13.join(p.path, ".paperclip"))
   }
 ];
 var DEDICATED_FILE_CONTENT = `## p\u0131ut Context (MCP Server: piut-context)
@@ -2545,6 +2748,7 @@ async function connectCommand(options) {
     }
   }
   const machineId = getMachineId();
+  const hostname = getHostname();
   for (const projectPath of selectedPaths) {
     const projectActions = byProject.get(projectPath) || [];
     const projectName = path13.basename(projectPath);
@@ -2554,6 +2758,7 @@ async function connectCommand(options) {
       projectName,
       projectPath,
       machineId,
+      hostname,
       toolsDetected,
       configFiles: configFilesWritten
     }).catch(() => {
@@ -2576,7 +2781,9 @@ var DEDICATED_FILES = /* @__PURE__ */ new Set([
 var APPEND_FILES = [
   "CLAUDE.md",
   ".github/copilot-instructions.md",
-  "CONVENTIONS.md"
+  "CONVENTIONS.md",
+  "GEMINI.md",
+  "AGENTS.md"
 ];
 function hasPiutReference3(filePath) {
   try {
@@ -3052,13 +3259,119 @@ async function doctorCommand(options) {
   if (result.issues > 0) throw new CliError(`${result.issues} issue(s) found`);
 }
 
-// src/commands/interactive.ts
-import { select as select3, confirm as confirm7, checkbox as checkbox6, Separator } from "@inquirer/prompts";
+// src/commands/vault.ts
 import fs14 from "fs";
 import path15 from "path";
-import { exec as exec2 } from "child_process";
-import os8 from "os";
 import chalk11 from "chalk";
+import { confirm as confirm7 } from "@inquirer/prompts";
+function formatSize2(bytes) {
+  if (bytes < 1024) return `${bytes} B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+function resolveApiKey(options) {
+  const key = options.key || readStore().apiKey;
+  if (!key) {
+    console.log(warning("  No API key found."));
+    console.log(dim("  Run ") + brand("piut login") + dim(" first, or pass --key."));
+    throw new CliError();
+  }
+  return key;
+}
+async function vaultListCommand(options) {
+  const key = resolveApiKey(options);
+  const data = await listVaultFiles(key);
+  if (data.files.length === 0) {
+    console.log(dim("  No files in vault."));
+    console.log(dim("  Upload with: ") + brand("piut vault upload <file>"));
+    console.log();
+    return;
+  }
+  console.log();
+  for (const file of data.files) {
+    const size = dim(`(${formatSize2(file.sizeBytes)})`);
+    console.log(`  ${file.filename}  ${size}`);
+    if (file.summary) {
+      console.log(dim(`    ${file.summary}`));
+    }
+  }
+  console.log();
+  console.log(dim(`  ${data.usage.fileCount} file(s), ${formatSize2(data.usage.totalBytes)} / ${formatSize2(data.usage.maxBytes)} used`));
+  console.log();
+}
+async function vaultUploadCommand(filePath, options) {
+  const key = resolveApiKey(options);
+  const resolved = path15.resolve(filePath);
+  if (!fs14.existsSync(resolved)) {
+    console.log(chalk11.red(`  File not found: ${filePath}`));
+    throw new CliError();
+  }
+  const stat = fs14.statSync(resolved);
+  if (!stat.isFile()) {
+    console.log(chalk11.red(`  Not a file: ${filePath}`));
+    throw new CliError();
+  }
+  const filename = path15.basename(resolved);
+  const content = fs14.readFileSync(resolved, "utf-8");
+  const spinner = new Spinner();
+  spinner.start(`Uploading ${filename}...`);
+  try {
+    const result = await uploadVaultFile(key, filename, content);
+    spinner.stop();
+    console.log(success(`  Uploaded ${result.filename}`) + dim(` (${formatSize2(result.sizeBytes)})`));
+    if (result.summary) {
+      console.log(dim(`  ${result.summary}`));
+    }
+    console.log();
+  } catch (err) {
+    spinner.stop();
+    console.log(chalk11.red(`  ${err.message}`));
+    throw new CliError();
+  }
+}
+async function vaultReadCommand(filename, options) {
+  const key = resolveApiKey(options);
+  try {
+    const file = await readVaultFile(key, filename);
+    if (options.output) {
+      const outPath = path15.resolve(options.output);
+      fs14.writeFileSync(outPath, file.content, "utf-8");
+      console.log(success(`  Saved to ${outPath}`));
+      console.log();
+    } else {
+      console.log();
+      console.log(file.content);
+    }
+  } catch (err) {
+    console.log(chalk11.red(`  ${err.message}`));
+    throw new CliError();
+  }
+}
+async function vaultDeleteCommand(filename, options) {
+  const key = resolveApiKey(options);
+  if (!options.yes) {
+    const confirmed = await confirm7({
+      message: `Delete "${filename}" from vault? This cannot be undone.`,
+      default: false
+    });
+    if (!confirmed) return;
+  }
+  try {
+    await deleteVaultFile(key, filename);
+    console.log(success(`  Deleted ${filename}`));
+    console.log();
+  } catch (err) {
+    console.log(chalk11.red(`  ${err.message}`));
+    throw new CliError();
+  }
+}
+
+// src/commands/interactive.ts
+import { select as select3, confirm as confirm8, checkbox as checkbox6, Separator } from "@inquirer/prompts";
+import fs15 from "fs";
+import path16 from "path";
+import { exec as exec2 } from "child_process";
+import chalk12 from "chalk";
 async function authenticate() {
   const config = readStore();
   const apiKey = config.apiKey;
@@ -3097,7 +3410,7 @@ async function interactiveMenu() {
     console.log(warning("  You haven\u2019t built a brain yet."));
     console.log(dim("  Your brain is how AI tools learn about you \u2014 your projects, preferences, and context."));
     console.log();
-    const wantBuild = await confirm7({
+    const wantBuild = await confirm8({
       message: "Build your brain now?",
       default: true
     });
@@ -3113,7 +3426,7 @@ async function interactiveMenu() {
     console.log(warning("  Your brain is built but not deployed yet."));
     console.log(dim("  Deploy it to make your MCP server live so AI tools can read your brain."));
     console.log();
-    const wantDeploy = await confirm7({
+    const wantDeploy = await confirm8({
       message: "Deploy your brain now?",
       default: true
     });
@@ -3135,10 +3448,23 @@ async function interactiveMenu() {
         loop: false,
         choices: [
           {
-            name: hasBrain ? "Resync Brain" : "Build Brain",
+            name: "My Brain",
+            value: "view-brain",
+            description: "View all 5 brain sections",
+            disabled: !hasBrain && "(build brain first)"
+          },
+          {
+            name: "Build Brain",
             value: "build",
-            description: hasBrain ? "Rescan your files and merge updates into your brain" : "Build your brain from your files"
+            description: hasBrain ? "Rebuild your brain from your files" : "Build your brain from your files"
+          },
+          {
+            name: "Edit Brain",
+            value: "edit-brain",
+            description: "Open piut.com to edit your brain",
+            disabled: !hasBrain && "(build brain first)"
           },
+          new Separator(),
           {
             name: isDeployed ? "Undeploy Brain" : "Deploy Brain",
             value: "deploy",
@@ -3159,23 +3485,21 @@ async function interactiveMenu() {
           },
           new Separator(),
           {
-            name: "Edit Brain",
-            value: "edit-brain",
-            description: "Open piut.com to edit your brain",
-            disabled: !hasBrain && "(build brain first)"
+            name: "View Files",
+            value: "vault-view",
+            description: "List and manage files in your vault"
           },
           {
-            name: "View Brain",
-            value: "view-brain",
-            description: "View all 5 brain sections",
-            disabled: !hasBrain && "(build brain first)"
+            name: "Upload Files",
+            value: "vault-upload",
+            description: "Upload a file to your vault"
           },
+          new Separator(),
           {
             name: "Status",
             value: "status",
             description: "Show brain, deployment, and connected tools/projects"
           },
-          new Separator(),
           {
             name: "Logout",
             value: "logout",
@@ -3194,12 +3518,14 @@ async function interactiveMenu() {
     if (action === "exit") return;
     try {
       switch (action) {
+        case "view-brain":
+          await handleViewBrain(apiKey);
+          break;
         case "build":
-          if (hasBrain) {
-            await handleResyncBrain(apiKey, currentValidation);
-          } else {
-            await buildCommand({ key: apiKey });
-          }
+          await buildCommand({ key: apiKey });
+          break;
+        case "edit-brain":
+          handleEditBrain();
           break;
         case "deploy":
           if (isDeployed) {
@@ -3214,11 +3540,11 @@ async function interactiveMenu() {
         case "connect-projects":
           await handleManageProjects(apiKey, currentValidation);
           break;
-        case "edit-brain":
-          handleEditBrain();
+        case "vault-view":
+          await handleVaultView(apiKey);
           break;
-        case "view-brain":
-          await handleViewBrain(apiKey);
+        case "vault-upload":
+          await handleVaultUpload(apiKey);
           break;
         case "status":
           statusCommand();
@@ -3241,7 +3567,7 @@ async function interactiveMenu() {
       } else if (err instanceof CliError) {
         console.log();
       } else {
-        console.log(chalk11.red(`  Error: ${err.message}`));
+        console.log(chalk12.red(`  Error: ${err.message}`));
         console.log();
       }
     }
@@ -3252,7 +3578,7 @@ async function interactiveMenu() {
   }
 }
 async function handleUndeploy(apiKey) {
-  const confirmed = await confirm7({
+  const confirmed = await confirm8({
     message: "Undeploy your brain? AI tools will lose access to your MCP server.",
     default: false
   });
@@ -3264,7 +3590,7 @@ async function handleUndeploy(apiKey) {
     console.log(dim("  Run ") + brand("piut deploy") + dim(" to re-deploy anytime."));
     console.log();
   } catch (err) {
-    console.log(chalk11.red(`  \u2717 ${err.message}`));
+    console.log(chalk12.red(`  \u2717 ${err.message}`));
   }
 }
 async function handleConnectTools(apiKey, validation) {
@@ -3273,10 +3599,10 @@ async function handleConnectTools(apiKey, validation) {
   for (const tool of TOOLS) {
     const paths = resolveConfigPaths(tool.configPaths);
     for (const configPath of paths) {
-      const exists = fs14.existsSync(configPath);
-      const parentExists = fs14.existsSync(path15.dirname(configPath));
+      const exists = fs15.existsSync(configPath);
+      const parentExists = fs15.existsSync(path16.dirname(configPath));
       if (exists || parentExists) {
-        const connected = exists && isPiutConfigured(configPath, tool.configKey);
+        const connected = exists && !!tool.configKey && isPiutConfigured(configPath, tool.configKey);
         detected.push({ tool, configPath, connected });
         break;
       }
@@ -3284,20 +3610,31 @@ async function handleConnectTools(apiKey, validation) {
   }
   if (detected.length === 0) {
     console.log(warning("  No supported AI tools detected."));
-    console.log(dim("  Supported: Claude Code, Claude Desktop, Cursor, Windsurf, GitHub Copilot, Amazon Q, Zed"));
     console.log();
     return;
   }
-  const connectedCount = detected.filter((d) => d.connected).length;
-  const availableCount = detected.length - connectedCount;
+  const mcpTools = detected.filter((d) => !d.tool.skillOnly);
+  const skillOnlyTools = detected.filter((d) => d.tool.skillOnly);
+  const connectedCount = mcpTools.filter((d) => d.connected).length;
+  const availableCount = mcpTools.length - connectedCount;
   if (connectedCount > 0 || availableCount > 0) {
     const parts = [];
     if (connectedCount > 0) parts.push(`${connectedCount} connected`);
     if (availableCount > 0) parts.push(`${availableCount} available`);
+    if (skillOnlyTools.length > 0) parts.push(`${skillOnlyTools.length} skill-only`);
     console.log(dim(`  ${parts.join(", ")}`));
   }
   console.log();
-  const choices = detected.map((d) => ({
+  if (mcpTools.length === 0) {
+    console.log(dim("  Detected tools are skill-only (no MCP config to manage)."));
+    if (skillOnlyTools.length > 0) {
+      console.log(dim(`  Skill-only: ${skillOnlyTools.map((d) => d.tool.name).join(", ")}`));
+    }
+    console.log(dim('  Use "Connect Projects" to add skill files to your projects.'));
+    console.log();
+    return;
+  }
+  const choices = mcpTools.map((d) => ({
     name: `${d.tool.name}${d.connected ? dim(" (connected)") : ""}`,
     value: d,
     checked: d.connected
@@ -3307,7 +3644,7 @@ async function handleConnectTools(apiKey, validation) {
     choices
   });
   const toConnect = selected.filter((s) => !s.connected);
-  const toDisconnect = detected.filter((d) => d.connected && !selected.includes(d));
+  const toDisconnect = mcpTools.filter((d) => d.connected && !selected.includes(d));
   if (toConnect.length === 0 && toDisconnect.length === 0) {
     console.log(dim("  No changes."));
     console.log();
@@ -3315,18 +3652,24 @@ async function handleConnectTools(apiKey, validation) {
   }
   console.log();
   for (const { tool, configPath } of toConnect) {
-    const serverConfig = tool.generateConfig(slug, apiKey);
-    mergeConfig(configPath, tool.configKey, serverConfig);
-    toolLine(tool.name, success("connected"), "\u2714");
+    if (tool.generateConfig && tool.configKey) {
+      const serverConfig = tool.generateConfig(slug, apiKey);
+      mergeConfig(configPath, tool.configKey, serverConfig);
+      toolLine(tool.name, success("connected"), "\u2714");
+    }
   }
   const removedNames = [];
   for (const { tool, configPath } of toDisconnect) {
+    if (!tool.configKey) continue;
     const removed = removeFromConfig(configPath, tool.configKey);
     if (removed) {
       removedNames.push(tool.name);
       toolLine(tool.name, warning("disconnected"), "\u2714");
     }
   }
+  if (skillOnlyTools.length > 0) {
+    console.log(dim(`  Skill-only (use "Connect Projects"): ${skillOnlyTools.map((d) => d.tool.name).join(", ")}`));
+  }
   if (toConnect.length > 0 && validation.serverUrl) {
     await Promise.all(
       toConnect.map(({ tool }) => pingMcp(validation.serverUrl, apiKey, tool.name))
@@ -3380,29 +3723,29 @@ async function handleManageProjects(apiKey, validation) {
   console.log();
   const copilotTool = TOOLS.find((t) => t.id === "copilot");
   for (const { project } of toConnect) {
-    const projectName = path15.basename(project.path);
+    const projectName = path16.basename(project.path);
     writePiutConfig(project.path, { slug, apiKey, serverUrl });
     await writePiutSkill(project.path, slug, apiKey);
     ensureGitignored(project.path);
     if (copilotTool) {
-      const hasCopilot = fs14.existsSync(path15.join(project.path, ".github", "copilot-instructions.md")) || fs14.existsSync(path15.join(project.path, ".github"));
+      const hasCopilot = fs15.existsSync(path16.join(project.path, ".github", "copilot-instructions.md")) || fs15.existsSync(path16.join(project.path, ".github"));
       if (hasCopilot) {
-        const vscodeMcpPath = path15.join(project.path, ".vscode", "mcp.json");
+        const vscodeMcpPath = path16.join(project.path, ".vscode", "mcp.json");
         const serverConfig = copilotTool.generateConfig(slug, apiKey);
         mergeConfig(vscodeMcpPath, copilotTool.configKey, serverConfig);
       }
     }
     for (const rule of RULE_FILES) {
       if (!rule.detect(project)) continue;
-      const absPath = path15.join(project.path, rule.filePath);
-      if (fs14.existsSync(absPath) && hasPiutReference2(absPath)) continue;
-      if (rule.strategy === "create" || !fs14.existsSync(absPath)) {
+      const absPath = path16.join(project.path, rule.filePath);
+      if (fs15.existsSync(absPath) && hasPiutReference2(absPath)) continue;
+      if (rule.strategy === "create" || !fs15.existsSync(absPath)) {
         const isAppendType = rule.strategy === "append";
         const content = isAppendType ? PROJECT_SKILL_SNIPPET + "\n" : DEDICATED_FILE_CONTENT;
-        fs14.mkdirSync(path15.dirname(absPath), { recursive: true });
-        fs14.writeFileSync(absPath, content, "utf-8");
+        fs15.mkdirSync(path16.dirname(absPath), { recursive: true });
+        fs15.writeFileSync(absPath, content, "utf-8");
       } else {
-        fs14.appendFileSync(absPath, APPEND_SECTION);
+        fs15.appendFileSync(absPath, APPEND_SECTION);
       }
     }
     toolLine(projectName, success("connected"), "\u2714");
@@ -3418,24 +3761,24 @@ async function handleManageProjects(apiKey, validation) {
     });
   }
   for (const { project } of toDisconnect) {
-    const projectName = path15.basename(project.path);
+    const projectName = path16.basename(project.path);
     for (const dedicatedFile of DEDICATED_FILES) {
-      const absPath = path15.join(project.path, dedicatedFile);
-      if (fs14.existsSync(absPath) && hasPiutReference2(absPath)) {
+      const absPath = path16.join(project.path, dedicatedFile);
+      if (fs15.existsSync(absPath) && hasPiutReference2(absPath)) {
         try {
-          fs14.unlinkSync(absPath);
+          fs15.unlinkSync(absPath);
         } catch {
         }
       }
     }
     for (const appendFile of APPEND_FILES) {
-      const absPath = path15.join(project.path, appendFile);
-      if (fs14.existsSync(absPath) && hasPiutReference2(absPath)) {
+      const absPath = path16.join(project.path, appendFile);
+      if (fs15.existsSync(absPath) && hasPiutReference2(absPath)) {
         removePiutSection(absPath);
       }
     }
-    const vscodeMcpPath = path15.join(project.path, ".vscode", "mcp.json");
-    if (fs14.existsSync(vscodeMcpPath) && isPiutConfigured(vscodeMcpPath, "servers")) {
+    const vscodeMcpPath = path16.join(project.path, ".vscode", "mcp.json");
+    if (fs15.existsSync(vscodeMcpPath) && isPiutConfigured(vscodeMcpPath, "servers")) {
       removeFromConfig(vscodeMcpPath, "servers");
     }
     removePiutDir(project.path);
@@ -3459,95 +3802,84 @@ function handleEditBrain() {
   console.log(success("  \u2713 Opened in browser."));
   console.log();
 }
-function formatScanContent(input3) {
-  const { summary } = input3;
-  const parts = [];
-  parts.push("The user has re-scanned their filesystem. Below is updated information about their projects, config files, and documents. Please merge this into the existing brain sections, preserving existing content and updating what has changed.");
-  parts.push("");
-  if (summary.folders.length > 0) {
-    parts.push(`## Folder Structure
-${summary.folders.join("\n")}`);
-  }
-  if (summary.projects.length > 0) {
-    const projectLines = summary.projects.map(
-      (p) => `- **${p.name}** (${p.path})${p.description ? ` \u2014 ${p.description}` : ""}`
-    );
-    parts.push(`## Projects Found
-${projectLines.join("\n")}`);
-  }
-  const totalFiles = (summary.configFiles?.length || 0) + (summary.recentDocuments?.length || 0) + (summary.personalDocuments?.length || 0);
-  const fileLimit = totalFiles <= 10 ? 1e4 : totalFiles <= 30 ? 5e3 : totalFiles <= 60 ? 3e3 : 2e3;
-  if (summary.configFiles.length > 0) {
-    const configBlocks = summary.configFiles.map(
-      (f) => `### ${f.name}
-\`\`\`
-${f.content.slice(0, fileLimit)}
-\`\`\``
-    );
-    parts.push(`## AI Config Files
-${configBlocks.join("\n\n")}`);
-  }
-  if (summary.recentDocuments.length > 0) {
-    const docBlocks = summary.recentDocuments.map(
-      (f) => `### ${f.name}
-${f.content.slice(0, fileLimit)}`
-    );
-    parts.push(`## Recent Documents
-${docBlocks.join("\n\n")}`);
-  }
-  if (summary.personalDocuments && summary.personalDocuments.length > 0) {
-    const docBlocks = summary.personalDocuments.map(
-      (f) => `### ${f.name}
-${f.content.slice(0, fileLimit)}`
-    );
-    parts.push(`## Personal Documents
-${docBlocks.join("\n\n")}`);
-  }
-  let result = parts.join("\n\n");
-  if (result.length > 4e5) {
-    result = result.slice(0, 4e5);
-  }
-  return result;
+function formatSize3(bytes) {
+  if (bytes < 1024) return `${bytes} B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
 }
-async function handleResyncBrain(apiKey, validation) {
-  if (!validation.serverUrl) {
-    console.log(warning("  Brain must be deployed before resyncing."));
-    console.log(dim("  Run ") + brand("piut deploy") + dim(" first."));
+async function handleVaultView(apiKey) {
+  const data = await listVaultFiles(apiKey);
+  if (data.files.length === 0) {
+    console.log(dim('  Vault is empty. Use "Upload Files" to add files.'));
     console.log();
     return;
   }
-  const cwd = process.cwd();
-  const cwdDisplay = cwd.replace(os8.homedir(), "~");
-  console.log(dim(`  Scanning ${cwdDisplay}...`));
-  const scanResult = await scanFolders([cwd]);
-  const allFolderPaths = scanResult.folders.map((f) => f.path);
-  const brainInput = buildBrainInput(scanResult, allFolderPaths);
-  const projCount = brainInput.summary.projects.length;
-  const cfgCount = brainInput.summary.configFiles.length;
-  const dcCount = (brainInput.summary.personalDocuments?.length || 0) + brainInput.summary.recentDocuments.length;
-  console.log(success(`  Scanned: ${projCount} projects, ${cfgCount} config files, ${dcCount} docs`));
   console.log();
-  if (projCount === 0 && cfgCount === 0) {
-    console.log(chalk11.yellow("  No projects or config files found to resync from."));
+  for (const file of data.files) {
+    const size = dim(`(${formatSize3(file.sizeBytes)})`);
+    console.log(`  ${file.filename}  ${size}`);
+    if (file.summary) console.log(dim(`    ${file.summary}`));
+  }
+  console.log();
+  console.log(dim(`  ${data.usage.fileCount} file(s), ${formatSize3(data.usage.totalBytes)} / ${formatSize3(data.usage.maxBytes)} used`));
+  console.log();
+  const action = await select3({
+    message: "Actions:",
+    choices: [
+      { name: "Delete a file", value: "delete" },
+      { name: "Back", value: "back" }
+    ]
+  });
+  if (action === "back") return;
+  if (action === "delete") {
+    const fileChoices = data.files.map((f) => ({
+      name: `${f.filename}  ${dim(`(${formatSize3(f.sizeBytes)})`)}`,
+      value: f.filename
+    }));
+    const filename = await select3({
+      message: "Which file to delete?",
+      choices: fileChoices
+    });
+    const confirmed = await confirm8({
+      message: `Delete "${filename}"? This cannot be undone.`,
+      default: false
+    });
+    if (confirmed) {
+      try {
+        await deleteVaultFile(apiKey, filename);
+        console.log(success(`  Deleted ${filename}`));
+        console.log();
+      } catch (err) {
+        console.log(chalk12.red(`  ${err.message}`));
+        console.log();
+      }
+    }
+  }
+}
+async function handleVaultUpload(apiKey) {
+  const { input: input3 } = await import("@inquirer/prompts");
+  const filePath = await input3({ message: "File path:" });
+  if (!filePath.trim()) return;
+  const resolved = path16.resolve(filePath);
+  if (!fs15.existsSync(resolved) || !fs15.statSync(resolved).isFile()) {
+    console.log(chalk12.red(`  File not found: ${filePath}`));
     console.log();
     return;
   }
-  const content = formatScanContent(brainInput);
+  const filename = path16.basename(resolved);
+  const content = fs15.readFileSync(resolved, "utf-8");
   const spinner = new Spinner();
-  spinner.start("Resyncing brain...");
+  spinner.start(`Uploading ${filename}...`);
   try {
-    const result = await resyncBrain(validation.serverUrl, apiKey, content);
+    const result = await uploadVaultFile(apiKey, filename, content);
     spinner.stop();
-    console.log();
-    console.log(success("  \u2713 Brain resynced."));
-    console.log(dim(`  ${result.summary}`));
+    console.log(success(`  Uploaded ${result.filename}`) + dim(` (${formatSize3(result.sizeBytes)})`));
+    if (result.summary) console.log(dim(`  ${result.summary}`));
     console.log();
   } catch (err) {
     spinner.stop();
-    const msg = err.message;
-    console.log(chalk11.red(`  \u2717 ${msg}`));
+    console.log(chalk12.red(`  ${err.message}`));
     console.log();
-    throw new CliError(msg);
   }
 }
 async function handleViewBrain(apiKey) {
@@ -3578,7 +3910,7 @@ async function handleViewBrain(apiKey) {
   if (hasUnpublishedChanges) {
     console.log(warning("  You have unpublished changes."));
     console.log();
-    const wantPublish = await confirm7({
+    const wantPublish = await confirm8({
       message: "Publish now?",
       default: true
     });
@@ -3592,11 +3924,11 @@ async function handleViewBrain(apiKey) {
         console.log();
         const msg = err.message;
         if (msg === "REQUIRES_SUBSCRIPTION") {
-          console.log(chalk11.yellow("  Deploy requires an active subscription ($10/mo)."));
+          console.log(chalk12.yellow("  Deploy requires an active subscription ($10/mo)."));
           console.log(`  Subscribe at: ${brand("https://piut.com/dashboard/billing")}`);
           console.log(dim("  14-day free trial included."));
         } else {
-          console.log(chalk11.red(`  \u2717 ${msg}`));
+          console.log(chalk12.red(`  \u2717 ${msg}`));
         }
         console.log();
       }
@@ -3605,7 +3937,7 @@ async function handleViewBrain(apiKey) {
 }
 
 // src/cli.ts
-var VERSION = "3.6.0";
+var VERSION = "3.7.0";
 function withExit(fn) {
   return async (...args2) => {
     try {
@@ -3631,6 +3963,11 @@ program.command("remove").description("Remove all p\u0131ut configurations").act
 program.command("login").description("Authenticate with p\u0131ut (email, browser, or API key)").action(withExit(loginCommand));
 program.command("logout").description("Remove saved API key").action(logoutCommand);
 program.command("doctor").description("Diagnose and fix connection issues").option("-k, --key <key>", "API key to verify against").option("--fix", "Auto-fix stale configurations").option("--json", "Output results as JSON").action(withExit(doctorCommand));
+var vault = program.command("vault").description("Manage your file vault (upload, list, read, delete)");
+vault.command("list").description("List all files in your vault").option("-k, --key <key>", "API key").action(withExit(vaultListCommand));
+vault.command("upload <file>").description("Upload a file to your vault").option("-k, --key <key>", "API key").action(withExit(vaultUploadCommand));
+vault.command("read <filename>").description("Read a file from your vault").option("-k, --key <key>", "API key").option("-o, --output <path>", "Save to a local file instead of printing").action(withExit(vaultReadCommand));
+vault.command("delete <filename>").description("Delete a file from your vault").option("-k, --key <key>", "API key").option("-y, --yes", "Skip confirmation prompt").action(withExit(vaultDeleteCommand));
 program.command("update").description("Check for and install CLI updates").action(() => updateCommand(VERSION));
 var args = process.argv.slice(2);
 if (args.includes("--version") || args.includes("-V")) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@piut/cli",
-  "version": "3.6.0",
+  "version": "3.7.0",
   "description": "Build your AI brain instantly. Deploy it as an MCP server. Connect it to every project.",
   "type": "module",
   "bin": {