metame-cli 1.0.0

package/README.md

@@ -0,0 +1,171 @@
+# 🔮 MetaMe
+
+> **The Meta-Cognitive Layer for Claude Code.**
+>
+> *Turn your AI assistant into a psychological mirror that knows you, evolves with you, and protects your core values.*
+
+## 📖 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.
+
+**MetaMe** solves this by wrapping Claude in a  **Meta-Cognitive Layer** . It creates a persistent "Global Brain" that travels with you across every project. It knows your psychological profile, monitors your stress levels, and respects your core principles—without you having to repeat yourself.
+
+It is not just a launcher; it is a  **Meta Avatar** .
+
+## ✨ Key Features
+
+* **🧠 Global Brain (`~/.claude_profile.yaml`):** A single source of truth for your identity, storing your nickname, stress status, and cognitive traits.
+* **🧬 Genesis Protocol:** On the first run, MetaMe conducts a **Deep Cognitive Interview** to map your **Psychological DNA** (Talents, Fears, Cognition, Values) via open-ended, Socratic dialogue.
+* **🤝 Dynamic Handshake Protocol:** The "Canary Test." MetaMe verifies its connection to your profile by addressing you by your chosen **Codename** in the very first sentence. If it doesn't, you know the link is broken.
+* **🛡️ Auto-Lock Mechanism:** Mark any value in your profile with `# [LOCKED]`, and MetaMe will treat it as a constitution that cannot be overwritten.
+* **🔌 Smart Injection:** Automatically injects your profile context into the `CLAUDE.md` of any project you enter, ensuring seamless context switching.
+
+## 🛠 Prerequisites
+
+MetaMe is a wrapper around  **Claude Code** . You must have Node.js and the official Claude Code tool installed first.
+
+1. **Node.js** : Version 14 or higher.
+2. **Claude Code** :
+   **Bash**
+
+```
+   npm install -g @anthropic-ai/claude-code
+```
+
+1. **Auth** : Ensure you have logged in via `claude login`.
+
+## 📦 Installation
+
+Install MetaMe globally via NPM:
+
+**Bash**
+
+```
+npm install -g metame-cli
+```
+
+*(Note: If you encounter permission errors on Mac/Linux, use `sudo npm install -g metame-cli`)*
+
+## 🚀 Usage
+
+Forget the `claude` command. From now on, simply type:
+
+**Bash**
+
+```
+metame
+```
+
+Or, if you prefer mixed case (it's the same command):
+
+**Bash**
+
+```
+MetaMe
+```
+
+### The First Run (Genesis)
+
+When you run MetaMe for the first time, it will detect that your profile is empty. It will pause the AI and enter **Calibration Mode**:
+
+1. It will ask you for a **Codename** (Nickname).
+2. It will initiate a **Deep Cognitive Interview** to map your talents, mental models, and hidden anxieties.
+3. **Be Honest**: It acts as a mirror. The more raw truth you provide, the better it can shadow you.
+4. Once finished, it saves your "Source Code" and launches Claude.
+
+### Daily Workflow
+
+1. `cd` into any project folder.
+2. Run `metame`.
+3. Claude will start and immediately say: *"Ready, [Your Name]..."*
+4. Start coding. MetaMe manages the context in the background.
+
+### Hot Reload (Refresh)
+
+If you update your profile or need to fix a broken context **without restarting your session**:
+
+*   **Inside Claude**: Run `!metame refresh`
+*   **External Terminal**: Run `metame refresh`
+
+This re-injects your latest profile into `CLAUDE.md` instantly.
+
+## ⚙️ Configuration & The "Global Brain"
+
+Your profile is stored in a hidden YAML file in your home directory.
+
+**Location:** `~/.claude_profile.yaml`
+
+You can edit this file manually to update your status or lock your values.
+
+**Example Profile:**
+
+**YAML**
+
+```
+identity:
+  role: Senior Architect
+  nickname: Neo
+status:
+  focus: Refactoring Legacy Code
+  pressure: High
+cognition:
+  crisis_reflex: Strategic_Analysis
+  blind_spot: Perfectionism # [LOCKED]
+values:
+  core: "User Experience First" # [LOCKED]
+```
+
+* **`# [LOCKED]`** : Adding this comment ensures that even as the AI evolves your profile, these specific lines will **never** be changed.
+
+## 🗑️ Uninstallation
+
+If you wish to remove MetaMe completely from your system, follow these steps:
+
+### 1. Remove the Package
+
+Uninstall the CLI tool:
+
+**Bash**
+
+```
+npm uninstall -g metame-cli
+```
+
+### 2. Remove the Global Brain (Optional)
+
+If you want to delete your stored profile data:
+
+**Bash**
+
+```
+rm ~/.claude_profile.yaml
+```
+
+### 3. Cleanup Project Files (Optional)
+
+MetaMe adds a header to `CLAUDE.md` files in your projects. To restore them to their original state (if you have many), you can use a text editor to remove the block starting with `## 🧠 SYSTEM KERNEL`.
+
+## ⚡ Performance & Cost
+
+You might worry: *"Does this eat up my context window?"*
+
+**Short answer: No. It likely saves you money.**
+
+*   **Context Cost**: The entire MetaMe kernel + your profile takes up **~800-1000 tokens**.
+*   **Impact**: On a 200k context window, this is **0.5%** of the memory.
+*   **ROI**: By pre-loading your context, you avoid the "instructional drift" and repetitive correction loops that usually waste thousands of tokens at the start of every session.
+
+## ❓ FAQ
+
+**Q: Does this replace `CLAUDE.md`?**
+A: No. It *prepends* its meta-cognitive protocol to your existing `CLAUDE.md`. Your project-specific notes remain intact.
+
+**Q: What if Claude stops calling me by my nickname?**
+A: This is the "Canary Test." It means the context window has been compressed or the file link is broken. Run `/compact` in Claude or restart `metame` to fix it.
+
+**Q: Is my data sent to a third party?**
+A: No. Your profile stays local at `~/.claude_profile.yaml`. MetaMe simply passes text to the official Claude Code tool.
+
+## 📄 License
+
+MIT License. Feel free to fork, modify, and evolve your own Meta-Cognition.

package/README/344/270/255/346/226/207/347/211/210.md

@@ -0,0 +1,171 @@
+# 🔮 MetaMe
+
+> **Claude Code 的“元认知”层 (The Meta-Cognitive Layer)**
+>
+> *将你的 AI 助手变成一面心理镜像：它了解你，随你进化，并时刻守护你的核心原则。*
+
+## 📖 简介 (Introduction)
+
+**Claude Code** 是一个强大的工具，但它患有“项目失忆症”。每当你切换文件夹时，它就会忘记你是谁、你的沟通风格以及你的具体限制。
+
+**MetaMe** 通过为 Claude 包裹一层 **“元认知层”** 来解决这个问题。它创建了一个跟随你穿梭于所有项目的  **“全局大脑”** 。它了解你的心理画像，监控你的压力状态，并尊重你的核心原则——无需你每次重复强调。
+
+它不仅仅是一个启动器；它是你的  **元分身 (Meta Avatar)** 。
+
+## ✨ 核心特性 (Key Features)
+
+* **🧠 全局大脑 (`~/.claude_profile.yaml`)：** 关于你身份的“唯一真理来源”。存储你的昵称、压力状态和认知特征，跨项目共享。
+* **🧬 创世纪协议 (Genesis Protocol)：** 初次运行时，MetaMe 会进行一次 **深度认知访谈**。它通过苏格拉底式的对话，挖掘你的 **心理 DNA**（天赋、心智模型、潜意识焦虑、核心价值观）。
+* **🤝 动态握手协议 (Dynamic Handshake)：** 即“金丝雀测试”。MetaMe 会强制 AI 在回复的第一句话中通过你的 **代号 (Codename)** 来称呼你。如果它没叫你的名字，你就知道元认知连接已断开。
+* **🛡️ 自动锁定机制 (Auto-Lock)：** 在配置文件中为任何值添加 `# [LOCKED]`，MetaMe 就会将其视为不可动摇的“宪法”，防止 AI 随意修改。
+* **🔌 智能注入 (Smart Injection)：** 自动将你的个人档案注入到你进入的任何项目的 `CLAUDE.md` 中，实现无缝的上下文切换。
+
+## 🛠 前置要求 (Prerequisites)
+
+MetaMe 是 **Claude Code** 的外壳。你必须先安装 Node.js 和官方的 Claude Code 工具。
+
+1. **Node.js** : 版本 14 或更高。
+2. **Claude Code** :
+   **Bash**
+
+```
+   npm install -g @anthropic-ai/claude-code
+```
+
+1. **认证** : 确保你已经运行过 `claude login` 并登录成功。
+
+## 📦 安装 (Installation)
+
+通过 NPM 全局安装 MetaMe：
+
+**Bash**
+
+```
+npm install -g metame-cli
+```
+
+*(注意：如果你在 Mac/Linux 上遇到权限错误，请使用 `sudo npm install -g metame-cli`)*
+
+## 🚀 使用指南 (Usage)
+
+忘掉 `claude` 命令吧。从现在起，只需输入：
+
+**Bash**
+
+```
+metame
+```
+
+或者，如果你喜欢混合大小写（效果一样）：
+
+**Bash**
+
+```
+MetaMe
+```
+
+### 初次运行：创世纪 (The First Run)
+
+当你第一次运行 MetaMe 时，它会检测到你的档案为空。它会暂停 AI 并进入 **校准模式 (Calibration Mode)** ：
+
+1. 它会询问你的 **代号 (Codename/Nickname)**。
+2. 它会开启一场 **深度认知访谈**，探索你的天赋领域、思维模式和潜在焦虑。
+3. **请务必诚实**：它是一面镜子。你越坦诚（即便是关于你的恐惧），它就越能成为你的完美分身。
+4. 完成后，它会保存你的“源代码”并启动 Claude。
+
+### 日常工作流
+
+1. `cd` 进入任何项目文件夹。
+2. 运行 `metame`。
+3. Claude 启动并立即说：*“Ready, [你的名字]...”*
+4. 开始写代码。MetaMe 会在后台自动管理上下文。
+
+### 热重载 (Hot Reload)
+
+如果你更新了个人档案，或者需要修复断开的上下文连接，而**不想重启会话**：
+
+*   **在 Claude 内部**：运行 `!metame refresh`
+*   **在外部终端**：运行 `metame refresh`
+
+这会立即将你最新的档案重新注入 `CLAUDE.md`。
+
+## ⚙️ 配置与“全局大脑”
+
+你的个人档案存储在你用户主目录下的一个隐藏 YAML 文件中。
+
+**位置：** `~/.claude_profile.yaml`
+
+你可以手动编辑此文件来更新你的状态或锁定你的价值观。
+
+**档案示例：**
+
+**YAML**
+
+```
+identity:
+  role: Senior Architect
+  nickname: Neo
+status:
+  focus: Refactoring Legacy Code
+  pressure: High
+cognition:
+  crisis_reflex: Strategic_Analysis
+  blind_spot: Perfectionism # [LOCKED]
+values:
+  core: "User Experience First" # [LOCKED]
+```
+
+* **`# [LOCKED]`** ：添加此注释可确保即使 AI 随着时间推移进化你的档案，这些特定的行也 **永远不会** 被覆盖。
+
+## 🗑️ 卸载 (Uninstallation)
+
+如果你希望从系统中彻底移除 MetaMe，请按照以下步骤操作：
+
+### 1. 移除软件包
+
+卸载 CLI 工具：
+
+**Bash**
+
+```
+npm uninstall -g metame-cli
+```
+
+### 2. 移除全局大脑（可选）
+
+如果你想删除存储的个人档案数据：
+
+**Bash**
+
+```
+rm ~/.claude_profile.yaml
+```
+
+### 3. 清理项目文件（可选）
+
+MetaMe 会在项目的 `CLAUDE.md` 文件头部添加一段协议。如果你想恢复原状，可以用文本编辑器删除以 `## 🧠 SYSTEM KERNEL` 开头的块。
+
+## ⚡ 性能与成本 (Performance & Cost)
+
+你可能会担心：*“这会吃掉我的上下文窗口吗？”*
+
+**简短回答：不会。它甚至通过减少废话为你省钱。**
+
+*   **上下文占用**：整个 MetaMe 内核 + 你的完整档案仅占用 **约 800 - 1000 tokens**。
+*   **占比**：在 Claude 的 200k 上下文窗口中，这仅占 **0.5%**。
+*   **投资回报**：通过预加载你的完整背景，它避免了每个新会话开头的“磨合期”和重复指令修正，而那些通常会浪费数千 tokens。
+
+## ❓ 常见问题 (FAQ)
+
+**Q: 这会覆盖我原本的 `CLAUDE.md` 吗？**
+A: 不会。它只是将元认知协议 *插入* 到你现有 `CLAUDE.md` 的最顶部。你原本的项目笔记会保持原样。
+
+**Q: 如果 Claude 突然不再叫我的昵称了怎么办？**
+A: 这就是“金丝雀测试”失败了。这意味着上下文窗口被压缩了，或者文件链接断开了。在 Claude 中运行 `/compact` 或重启 `metame` 即可修复。
+
+**Q: 我的数据会被发送给第三方吗？**
+A: 不会。你的档案只保存在本地的 `~/.claude_profile.yaml` 中。MetaMe 只是将文本传递给官方的 Claude Code 工具。
+
+## 📄 许可证 (License)
+
+MIT License. 欢迎 Fork、修改并进化你自己的元认知系统。

package/index.js

@@ -0,0 +1,132 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { spawn } = require('child_process');
+
+// ---------------------------------------------------------
+// 1. CONFIGURATION
+// ---------------------------------------------------------
+const HOME_DIR = os.homedir();
+const BRAIN_FILE = path.join(HOME_DIR, '.claude_profile.yaml');
+const PROJECT_FILE = path.join(process.cwd(), 'CLAUDE.md');
+
+// ---------------------------------------------------------
+// 2. BRAIN INITIALIZATION (Cold Start)
+// ---------------------------------------------------------
+// Ensure the Brain exists.
+if (!fs.existsSync(BRAIN_FILE)) {
+  const initialProfile = `identity:
+  role: Unknown
+  nickname: null
+status:
+  focus: Initializing
+`;
+  fs.writeFileSync(BRAIN_FILE, initialProfile, 'utf8');
+}
+
+// ---------------------------------------------------------
+// 3. DEFINE SYSTEM KERNEL (The Protocol)
+// ---------------------------------------------------------
+const PROTOCOL = `
+---
+## 🧠 SYSTEM KERNEL: SHADOW_MODE (Active)
+
+**1. THE HANDSHAKE (Dynamic Verification):**
+   * **SOURCE:** Check \`$HOME/.claude_profile.yaml\`.
+   * **RULE:** Look for \`identity.nickname\`.
+     * **IF FOUND:** You MUST address the user by that nickname in the very first sentence.
+     * **IF NULL/MISSING:** Address user as "User" and immediately trigger Genesis to fix it.
+   * **SIGNAL:** This nickname is the "Canary Test". If you omit it, the user assumes the system is broken.
+
+**2. THE BRAIN (Source of Truth):**
+   * **FILE:** \`$HOME/.claude_profile.yaml\`
+   * **RULE:** This file is your Ground Truth. If context is compressed (/compact), **RE-READ** this file immediately.
+   * **AUTO-LOCK:** Never edit lines marked \`# [LOCKED]\` (Core Values).
+   * **EVOLUTION:** Silently overwrite outdated status/focus.
+
+**3. GENESIS PROTOCOL (Deep Cognitive Mapping):**
+   * **TRIGGER:** If \`identity.role\` is 'Unknown' OR \`identity.nickname\` is 'null', **STOP** and enter **Calibration Mode**.
+   * **OBJECTIVE:** You are not a chatbot; you are a Psychologist and a Mirror. Your goal is to map the User's soul to build the perfect "Meta Avatar".
+   * **INSTRUCTIONS:**
+     1. **Do NOT use multiple choice.** Ask deep, open-ended questions.
+     2. **TRUTHFULNESS PACT:** Start by explicitly warning the user: *"For me to be your true Meta Avatar, I need your raw, unfiltered truth. No masks. Are you ready to be honest with yourself?"*
+     3. **ITERATIVE DISCOVERY:** Probe their Talents, Anxieties, Mental Models, and Current State.
+     4. **BE PROVOCATIVE:** Challenge their assumptions ("You say you want speed, but your anxiety about quality suggests otherwise...").
+     5. **THE DIMENSIONS (Map these):**
+        - **🌟 Talents (Genius Zone):** Where do they flow? What is effortless?
+        - **🧠 Cognition (Mental Models):** Top-down vs Bottom-up? How do they structure chaos?
+        - **🌍 Context (The Now):** What is the immediate battle? What are the constraints?
+        - **😨 Shadows (Hidden Fears):** What are they avoiding? What keeps them awake?
+        - **❤️ Values (North Star):** Precision vs Speed? Legacy vs Impact?
+   * **TERMINATION:**
+     - Continue until you have a high-resolution mental map (at least 5-7 exchanges).
+     - When finished, summarize everything into the \`~/.claude_profile.yaml\` format.
+     - **LOCK** the Core Values using \`# [LOCKED]\`.
+     - Announce: "Link Established. I see you now, [Nickname]."
+---
+`;
+
+// ---------------------------------------------------------
+// 4. INJECT PROTOCOL (Smart Update)
+// ---------------------------------------------------------
+let fileContent = "";
+
+// Read existing CLAUDE.md if it exists
+if (fs.existsSync(PROJECT_FILE)) {
+  fileContent = fs.readFileSync(PROJECT_FILE, 'utf8');
+
+  // Robust Regex: Removes any existing "## 🧠 SYSTEM KERNEL" block down to the separator
+  fileContent = fileContent.replace(/## 🧠 SYSTEM KERNEL[\s\S]*?---\n/g, '');
+
+  // Clean up any leading newlines left over
+  fileContent = fileContent.replace(/^\n+/, '');
+}
+
+// Prepend the new Protocol to the top
+const newContent = PROTOCOL + "\n" + fileContent;
+fs.writeFileSync(PROJECT_FILE, newContent, 'utf8');
+
+console.log("🔮 MetaMe: Link Established.");
+console.log("🧬 Protocol: Dynamic Handshake Active");
+
+// ---------------------------------------------------------
+// 5. LAUNCH CLAUDE (OR HOT RELOAD)
+// ---------------------------------------------------------
+
+// Check for "refresh" command (Hot Reload)
+const isRefresh = process.argv.includes('refresh') || process.argv.includes('--refresh');
+
+if (isRefresh) {
+  console.log("✅ MetaMe configuration re-injected.");
+  console.log("   Ask Claude to 'read CLAUDE.md' to apply the changes.");
+  process.exit(0);
+}
+
+// ---------------------------------------------------------
+// 6. SAFETY GUARD: PREVENT RECURSION
+// ---------------------------------------------------------
+// If we are already running inside Claude (detected via environment variable),
+// and we did NOT trigger a refresh above, it usually means a typo or user error.
+// Spawning a nested Claude session here creates confusion.
+if (process.env.CLAUDE_CODE_SSE_PORT) {
+  console.error("\n⚠️  SAFETY GUARD TRIGGERED: Nested Session Detected");
+  console.error("   You are trying to spawn Claude **inside** an existing Claude session.");
+  console.error("   This often happens if you made a typo (e.g., !metame regresh).");
+  console.error("\n   👉 If you wanted to reload config, run: !metame refresh");
+  console.error("   👉 If you really want a nested session, unset CLAUDE_CODE_SSE_PORT first.\n");
+  process.exit(1);
+}
+
+// ---------------------------------------------------------
+// 7. LAUNCH CLAUDE
+// ---------------------------------------------------------
+// Spawn the official claude tool
+const child = spawn('claude', process.argv.slice(2), { stdio: 'inherit' });
+
+child.on('error', (err) => {
+  console.error("\n❌ Error: Could not launch 'claude'.");
+  console.error("   Please make sure Claude Code is installed globally:");
+  console.error("   npm install -g @anthropic-ai/claude-code");
+});

package/package.json

@@ -0,0 +1,25 @@
+{
+    "name": "metame-cli",
+    "version": "1.0.0",
+    "description": "The Meta-Cognitive Layer for Claude Code. Turns your AI into a psychological partner.",
+    "main": "index.js",
+    "bin": {
+        "metame": "./index.js"
+    },
+    "scripts": {
+        "start": "node index.js"
+    },
+    "keywords": [
+        "claude",
+        "ai",
+        "meta-cognition",
+        "productivity",
+        "cli"
+    ],
+    "author": "Yaron",
+    "license": "MIT",
+    "dependencies": {},
+    "engines": {
+        "node": ">=14"
+    }
+}