metame-cli 1.3.8 → 1.3.9

package/README.md

@@ -6,15 +6,27 @@
 
 > **The Cognitive Profile Layer for Claude Code.**
 >
-> *Not a memory system — a cognitive mirror. It knows how you think, decide, and communicate, and it protects your core values.*
+> *Knows how you think. Works wherever you are.*
 
 ## 📖 Introduction
 
-**Claude Code** is a powerful tool, but it suffers from "Project Amnesia." Every time you switch folders, it forgets who you are, your communication style, and your specific constraints.
+**Claude Code** is powerful, but it has two pain points:
 
-**MetaMe** solves this by wrapping Claude in a  **Cognitive Profile Layer** . It creates a persistent "Global Brain" that travels with you across every project. Unlike ChatGPT/Claude/Gemini's built-in memory (which stores *facts* like "user lives in X"), MetaMe captures *how you think* — your decision style, cognitive load preferences, motivation patterns, and communication traits.
+1. **Project Amnesia** — Switch folders, and it forgets who you are. Your communication style, coding preferences, constraints — gone. Every project, you start from scratch.
 
-It is not a memory system; it is a  **Cognitive Mirror** .
+2. **Desktop-Bound** — Leave your computer, work stops. You can't continue that debugging session on your phone. You can't vibe with Claude on the train, in bed, or waiting in line.
+
+**MetaMe** solves both — and more:
+
+**🧠 Cognitive Profile** — A persistent "Global Brain" (`~/.claude_profile.yaml`) that travels with you across every project. Unlike ChatGPT/Claude's built-in memory (which stores *facts* like "user lives in X"), MetaMe captures *how you think* — your decision style, cognitive load preferences, and communication traits. It's not a memory system; it's a **Cognitive Mirror**.
+
+**📱 Mobile Bridge** — Full Claude Code from your phone via Telegram or Feishu. Same tools, same files, same conversation history. Start on your computer, continue anywhere. `/cd last` syncs you to exactly where you left off.
+
+**🔔 Remote Wake** — Daemon runs in the background on your computer. Send a message from your phone, and it wakes up Claude Code to do real work — edit files, run commands, commit code — even while you're away from your desk.
+
+**📂 File Transfer** — Send files from your computer to your phone (ask Claude to send any project file). Send files from your phone to your computer (just attach them in chat). Seamless both ways.
+
+**⏰ Heartbeat Tasks** — Schedule Claude to run automatically. Daily summaries, automated workflows, multi-step skill chains — all running on your machine, pushing results to your phone.
 
 ## ✨ Key Features
 
@@ -34,15 +46,19 @@ MetaMe is a wrapper around **Claude Code**. You must have Node.js and the offici
 
 ## 📦 Installation
 
-Install MetaMe globally via NPM:
-
-**Bash**
+**Option A: NPM (recommended)** — full CLI with daemon, mobile bridge, interview
 
-```
+```bash
 npm install -g metame-cli
 ```
 
-*(Note: If you encounter permission errors on Mac/Linux, use `sudo npm install -g metame-cli`)*
+**Option B: Claude Code Plugin** — lightweight, profile injection + slash commands
+
+```bash
+claude plugin install github:Yaron9/MetaMe/plugin
+```
+
+*(NPM note: If you encounter permission errors on Mac/Linux, use `sudo npm install -g metame-cli`)*
 
 ## 🚀 Usage
 
@@ -170,7 +186,6 @@ metame daemon install-launchd         # macOS auto-start (RunAtLoad + KeepAlive)
 | `/cd` | Change working directory — with directory browser |
 | `/cd last` | **Sync to computer** — jump to the most recent session's directory |
 | `/session` | Current session info |
-| `/continue` | Continue the most recent terminal session |
 
 Just type naturally for conversation — every message stays in the same Claude Code session with full context.
 
@@ -190,7 +205,9 @@ Each chat gets a persistent session via `claude -p --resume <session-id>`. This
 💻 Bash: 「git status」
 ```
 
-**File sending (v1.3.7):** Ask Claude to send any file to your phone:
+**File transfer (v1.3.8):** Seamlessly move files between your phone and computer.
+
+*Computer → Phone (download):* Ask Claude to send any project file:
 
 ```
 You: Send me report.md
@@ -200,8 +217,18 @@ Claude: Here you go!
 
 Works for documents, audio, images, etc. Click button to download. Links valid for 30 minutes.
 
+*Phone → Computer (upload):* Send files directly to your project:
+
+```
+[📎 You send a PDF, image, or any file]
+Claude: 📥 Saved: document.pdf
+        File is in your project's upload/ folder.
+```
+
+Uploaded files are saved to `<project>/upload/`. Claude won't read large files automatically — just tell it when you want it to process them.
+
 - **Telegram:** Works out of the box
-- **Feishu:** Requires `im:resource` permission in app settings
+- **Feishu:** Requires `im:resource` + `im:message` permissions in app settings
 
 **Other commands:**
 

package/index.js

@@ -598,10 +598,15 @@ if (isDaemon) {
 
     // --- Telegram Setup ---
     console.log("━━━ 📱 Telegram Setup ━━━");
-    console.log("Steps:");
-    console.log("  1. Open Telegram, search @BotFather");
-    console.log("  2. Send /newbot, follow prompts to create a bot");
-    console.log("  3. Copy the bot token (looks like: 123456:ABC-DEF...)");
+    console.log("");
+    console.log("Step 1: Create a Bot");
+    console.log("  • Open Telegram app on your phone or desktop");
+    console.log("  • Search for @BotFather (official Telegram bot)");
+    console.log("  • Send /newbot command");
+    console.log("  • Enter a display name (e.g., 'My MetaMe Bot')");
+    console.log("  • Enter a username (must end in 'bot', e.g., 'my_metame_bot')");
+    console.log("  • BotFather will reply with your bot token");
+    console.log("    (looks like: 123456789:ABCdefGHI-jklMNOpqrSTUvwxYZ)");
     console.log("");
 
     const tgToken = (await ask("Paste your Telegram bot token (Enter to skip): ")).trim();
@@ -652,17 +657,38 @@ if (isDaemon) {
 
     // --- Feishu Setup ---
     console.log("━━━ 📘 Feishu (Lark) Setup ━━━");
-    console.log("Steps:");
-    console.log("  1. Go to: https://open.feishu.cn/app");
-    console.log("     → Create App (企业自建应用)");
-    console.log("  2. In 'Credentials' (凭证与基础信息), copy App ID & App Secret");
-    console.log("  3. In 'Bot' (机器人), enable bot capability");
-    console.log("  4. In 'Event Subscription' (事件订阅):");
-    console.log("     → Set mode to 'Long Connection' (使用长连接接收事件)");
-    console.log("     → Add event: im.message.receive_v1 (接收消息)");
-    console.log("  5. In 'Permissions' (权限管理), add:");
-    console.log("     → im:message, im:message:send_as_bot, im:chat");
-    console.log("  6. Publish the app version (创建版本 → 申请发布)");
+    console.log("");
+    console.log("Step 1: Create an App");
+    console.log("  • Go to: https://open.feishu.cn/app");
+    console.log("  • Click '创建企业自建应用' (Create Enterprise App)");
+    console.log("  • Fill in app name and description");
+    console.log("");
+    console.log("Step 2: Get Credentials");
+    console.log("  • In left sidebar → '凭证与基础信息' (Credentials)");
+    console.log("  • Copy App ID and App Secret");
+    console.log("");
+    console.log("Step 3: Enable Bot");
+    console.log("  • In left sidebar → '应用能力' → '机器人' (Bot)");
+    console.log("  • Enable the bot capability");
+    console.log("");
+    console.log("Step 4: Configure Events");
+    console.log("  • In left sidebar → '事件订阅' (Event Subscription)");
+    console.log("  • Choose '使用长连接接收事件' (Long Connection mode) — important!");
+    console.log("  • Add event: im.message.receive_v1 (接收消息)");
+    console.log("");
+    console.log("Step 5: Add Permissions");
+    console.log("  • In left sidebar → '权限管理' (Permissions)");
+    console.log("  • Search and enable these 5 permissions:");
+    console.log("    → im:message                       (获取与发送单聊、群组消息)");
+    console.log("    → im:message.p2p_msg:readonly      (读取用户发给机器人的单聊消息)");
+    console.log("    → im:message.group_at_msg:readonly (接收群聊中@机器人消息事件)");
+    console.log("    → im:message:send_as_bot           (以应用的身份发消息)");
+    console.log("    → im:resource                      (文件上传下载 - for file transfer)");
+    console.log("");
+    console.log("Step 6: Publish");
+    console.log("  • In left sidebar → '版本管理与发布' (Version Management)");
+    console.log("  • Click '创建版本' → fill version (e.g., 1.0.0)");
+    console.log("  • Click '申请发布' (Apply for Release)");
     console.log("");
 
     const feishuAppId = (await ask("Paste your Feishu App ID (Enter to skip): ")).trim();

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "metame-cli",
-    "version": "1.3.8",
+    "version": "1.3.9",
     "description": "The Cognitive Profile Layer for Claude Code. Knows how you think, not just what you said.",
     "main": "index.js",
     "bin": {
@@ -13,7 +13,8 @@
     "scripts": {
         "start": "node index.js",
         "sync:plugin": "cp scripts/schema.js scripts/pending-traits.js scripts/signal-capture.js scripts/distill.js scripts/daemon.js scripts/telegram-adapter.js scripts/feishu-adapter.js scripts/daemon-default.yaml plugin/scripts/ && echo '✅ Plugin scripts synced'",
-        "precommit": "npm run sync:plugin"
+        "restart:daemon": "node index.js daemon stop 2>/dev/null; sleep 1; node index.js daemon start 2>/dev/null || echo '⚠️  Daemon not running or restart failed'",
+        "precommit": "npm run sync:plugin && npm run restart:daemon"
     },
     "keywords": [
         "claude",

package/scripts/daemon.js

@@ -669,22 +669,6 @@ async function handleCommand(bot, chatId, text, config, executeTaskByName) {
     return;
   }
 
-  if (text === '/continue') {
-    // Continue the most recent conversation in current workdir
-    const session = getSession(chatId);
-    const cwd = session ? session.cwd : HOME;
-    const state2 = loadState();
-    state2.sessions[chatId] = {
-      id: '__continue__',
-      cwd,
-      created: new Date().toISOString(),
-      started: true,
-    };
-    saveState(state2);
-    await bot.sendMessage(chatId, `Resuming last conversation in ${cwd}`);
-    return;
-  }
-
   // /file <shortId> — send cached file (from button callback)
   if (text.startsWith('/file ')) {
     const shortId = text.slice(6).trim();
@@ -1006,7 +990,7 @@ async function handleCommand(bot, chatId, text, config, executeTaskByName) {
       '/cd <path> — 切换工作目录',
       '/session — 查看当前会话',
       '',
-      '⚙️ /status /tasks /budget /reload',
+      '⚙️ /status /tasks /run <name> /budget /reload',
       '',
       '直接打字即可对话 💬',
     ].join('\n'));
@@ -1904,6 +1888,27 @@ async function main() {
     }, 1000);
   });
 
+  // Auto-restart: watch daemon.js for code changes (hot restart)
+  const DAEMON_SCRIPT = path.join(METAME_DIR, 'daemon.js');
+  let _restartDebounce = null;
+  fs.watchFile(DAEMON_SCRIPT, { interval: 3000 }, (curr, prev) => {
+    if (curr.mtimeMs === prev.mtimeMs) return;
+    if (_restartDebounce) clearTimeout(_restartDebounce);
+    _restartDebounce = setTimeout(async () => {
+      log('INFO', 'daemon.js changed on disk — auto-restarting...');
+      await notifyFn('🔄 Code updated, daemon restarting...').catch(() => {});
+      // Spawn new daemon process, then exit
+      const { spawn } = require('child_process');
+      const newDaemon = spawn(process.execPath, [DAEMON_SCRIPT], {
+        detached: true,
+        stdio: 'ignore',
+        env: { ...process.env, METAME_ROOT: process.env.METAME_ROOT || path.dirname(__dirname) },
+      });
+      newDaemon.unref();
+      setTimeout(() => process.exit(0), 500);
+    }, 2000);
+  });
+
   // Start bridges (both can run simultaneously)
   telegramBridge = await startTelegramBridge(config, executeTaskByName);
   feishuBridge = await startFeishuBridge(config, executeTaskByName);
@@ -1912,6 +1917,7 @@ async function main() {
   const shutdown = () => {
     log('INFO', 'Daemon shutting down...');
     fs.unwatchFile(CONFIG_FILE);
+    fs.unwatchFile(DAEMON_SCRIPT);
     if (heartbeatTimer) clearInterval(heartbeatTimer);
     if (telegramBridge) telegramBridge.stop();
     if (feishuBridge) feishuBridge.stop();