toon-memory 1.1.2 → 1.3.0

package/README.md

@@ -2,14 +2,9 @@
 
 Persistent memory for AI coding agents — remember decisions, patterns, and bugs between sessions.
 
-🎉 **1.0 Released!**
-
-Supercharge **OpenCode, VS Code Copilot, Claude Code, Cursor, Windsurf, Cline, Continue** and more with Persistent Memory
-
-Saves context in **TOON format** (40% fewer tokens than JSON) · 5 MCP tools · Works everywhere
-
 [![npm version](https://img.shields.io/npm/v/toon-memory.svg)](https://www.npmjs.com/package/toon-memory)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![CI](https://github.com/LuiggiVal08/toon-memory/actions/workflows/ci.yml/badge.svg)](https://github.com/LuiggiVal08/toon-memory/actions/workflows/ci.yml)
 
 ---
 
@@ -25,9 +20,21 @@ AI agents forget everything between sessions. toon-memory fixes this by providin
 
 ---
 
-## Get Started
+## Features
+
+- **5 MCP tools** — `memory_remember`, `memory_recall`, `memory_forget`, `memory_stats`, `memory_summary`
+- **7 agents supported** — OpenCode, VS Code/Copilot, Claude Code, Cursor, Windsurf, Cline, Continue
+- **TOON format** — 40% fewer tokens than JSON, better LLM comprehension
+- **Per-project memory** — each project gets its own memory file
+- **Zero config** — just install and use
+- **Auto gitignore** — automatically adds `.opencode/memory/` to `.gitignore`
+- **Date filtering** — search memory by date range
+
+---
+
+## Quick Start
 
-### 1. Install (one command)
+### 1. Install
 
 ```bash
 # macOS / Linux
@@ -60,16 +67,16 @@ memory_remember   # Save important decisions
 
 ## Supported Agents
 
-| Agent | Config Location | Status |
-|-------|-----------------|--------|
-| **OpenCode** | `.opencode/opencode.json` | ✅ Full support |
-| **VS Code / Copilot** | `.vscode/mcp.json` | ✅ Full support |
-| **Claude Code** | `.claude/settings.json` | ✅ Full support |
-| **Cursor** | `.cursor/mcp.json` | ✅ Full support |
-| **Windsurf** | `.windsurfrules` | ✅ Full support |
-| **Cline** | `.cline/mcp.json` | ✅ Full support |
-| **Continue** | `.continue/config.json` | ✅ Full support |
-| **Aider** | `.aider.conf.yml` | ⚠️ Manual config |
+| Agent | Config Location | Auto-Setup |
+|-------|-----------------|------------|
+| **OpenCode** | `.opencode/opencode.json` | ✅ |
+| **VS Code / Copilot** | `.vscode/mcp.json` | ✅ |
+| **Claude Code** | `.claude/settings.json` | ✅ |
+| **Cursor** | `.cursor/mcp.json` | ✅ |
+| **Windsurf** | `.windsurfrules` | ✅ |
+| **Cline** | `.cline/mcp.json` | ✅ |
+| **Continue** | `.continue/config.json` | ✅ |
+| **Aider** | `.aider.conf.yml` | ⚠️ Manual |
 
 ---
 
@@ -83,6 +90,19 @@ memory_remember   # Save important decisions
 | `memory_stats` | View memory state |
 | `memory_summary` | Save/retrieve file summaries |
 
+### Date Filtering
+
+Search memory by date range:
+
+```typescript
+// Search with date filter
+memory_recall({
+  query: "redis",
+  from_date: "2026-07-01",
+  to_date: "2026-07-31"
+})
+```
+
 ---
 
 ## How It Works
@@ -109,24 +129,55 @@ summaries:
 ## CLI Commands
 
 ```bash
-npx toon-memory          # Interactive installer
-npx toon-memory init     # Quick setup (no prompts)
-npx toon-memory mcp      # Run MCP server directly
-npx toon-memory status   # Check installation status
-npx toon-memory upgrade  # Update to latest version
-npx toon-memory uninstall # Remove from all agents
+npx toon-memory              # Interactive installer
+npx toon-memory init         # Quick setup (no prompts)
+npx toon-memory mcp          # Run MCP server directly
+npx toon-memory status       # Check installation status
+npx toon-memory stats        # View memory statistics
+npx toon-memory export       # Export memory to JSON
+npx toon-memory import <file> # Import memory from JSON
+npx toon-memory upgrade      # Update to latest version
+npx toon-memory uninstall    # Remove from all agents
 ```
 
----
+### Stats
 
-## Uninstall
+```bash
+$ npx toon-memory stats
+
+🧠 toon-memory stats
+
+📊 Memory Stats
+━━━━━━━━━━━━━━━━━━
+Total entries: 45
+├── decision: 12
+├── pattern: 18
+├── bug: 8
+└── knowledge: 7
+Last updated: 2026-07-10
+File size: 12.4 KB
+```
+
+### Export
 
 ```bash
-# Remove from all agents and uninstall CLI
-npx toon-memory uninstall
+$ npx toon-memory export
+
+🧠 toon-memory export
 
-# Or with the global install
-toon-memory uninstall
+Exported 45 entries to:
+  /path/to/project/toon-memory-export.json
+```
+
+### Import
+
+```bash
+$ npx toon-memory import backup.json
+
+🧠 toon-memory import
+
+Imported 3 new entries
+Skipped 2 duplicates
 ```
 
 ---
@@ -205,10 +256,23 @@ git clone https://github.com/LuiggiVal08/toon-memory.git
 cd toon-memory
 npm install
 npm run build
+npm test
 ```
 
 ---
 
+## Contributing
+
+Contributions are welcome! Please read our [Code of Conduct](CODE_OF_CONDUCT.md) first.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'feat: add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+---
+
 ## License
 
 MIT

package/bin/toon-memory.js

@@ -1,15 +1,10 @@
 #!/usr/bin/env node
-import { dirname, join } from "path"
-import { fileURLToPath } from "url"
-import { spawn } from "child_process"
-
-const __dirname = dirname(fileURLToPath(import.meta.url))
-const args = process.argv.slice(2)
-
-const target = args[0] === "mcp"
-  ? join(__dirname, "..", "mcp", "server.js")
-  : join(__dirname, "..", "dist", "cli", "setup.js")
-
-const extraArgs = args[0] === "mcp" ? [] : args
-const child = spawn("node", [target, ...extraArgs], { stdio: "inherit" })
-child.on("exit", (code) => process.exit(code ?? 0))
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+import { spawn } from "child_process";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const args = process.argv.slice(2);
+const target = args[0] === "mcp" ? join(__dirname, "..", "mcp", "server.js") : join(__dirname, "..", "dist", "cli", "setup.js");
+const extraArgs = args[0] === "mcp" ? [] : args;
+const child = spawn("node", [target, ...extraArgs], { stdio: "inherit" });
+child.on("exit", (code) => process.exit(code ?? 0));

package/dist/cli/setup.js

@@ -1,5 +1,5 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync, cpSync, unlinkSync } from "fs";
-import { dirname, join } from "path";
+import { basename, dirname, join } from "path";
 import { fileURLToPath } from "url";
 import { execSync } from "child_process";
 import { createInterface } from "readline";
@@ -77,6 +77,23 @@ function installOpenCodeTools() {
     console.log("  Created .opencode/memory/data.toon");
   }
 }
+function ensureGitignore() {
+  const gitignorePath = join(projectRoot, ".gitignore");
+  const entry = ".opencode/memory/";
+  if (!existsSync(gitignorePath)) {
+    writeFileSync(gitignorePath, `${entry}
+`);
+    console.log("  Created .gitignore with memory exclusion");
+    return;
+  }
+  const content = readFileSync(gitignorePath, "utf-8");
+  if (!content.includes(entry)) {
+    writeFileSync(gitignorePath, `${content.trim()}
+${entry}
+`);
+    console.log("  Added .opencode/memory/ to .gitignore");
+  }
+}
 function installMCPConfig(agent, scope) {
   const configPath = scope === "global" ? agent.global : agent.local;
   if (!configPath) {
@@ -139,6 +156,7 @@ function init(scope = "local") {
     installMCPConfig(agent, scope);
     console.log("");
   }
+  ensureGitignore();
   console.log("Done! Restart your agent to use memory tools.\n");
 }
 function status() {
@@ -195,6 +213,128 @@ function upgrade() {
     console.error("Upgrade failed:", error.message);
   }
 }
+function stats() {
+  console.log("\n\u{1F9E0} toon-memory stats\n");
+  const memoryFile = join(projectRoot, ".opencode", "memory", "data.toon");
+  if (!existsSync(memoryFile)) {
+    console.log("Memory not initialized. Run 'npx toon-memory init' first.\n");
+    return;
+  }
+  const data = readFileSync(memoryFile, "utf-8");
+  const lines = data.split("\n").filter((l) => l.startsWith("  ") && l.includes("|"));
+  const categories = {};
+  let latestDate = "";
+  for (const line of lines) {
+    const parts = line.trim().split("|");
+    if (parts.length >= 7) {
+      const category = parts[1];
+      const date = parts[6];
+      categories[category] = (categories[category] || 0) + 1;
+      if (date > latestDate) latestDate = date;
+    }
+  }
+  console.log("\u{1F4CA} Memory Stats");
+  console.log("\u2501".repeat(20));
+  console.log(`Total entries: ${lines.length}`);
+  for (const [cat, count] of Object.entries(categories)) {
+    console.log(`\u251C\u2500\u2500 ${cat}: ${count}`);
+  }
+  console.log(`Last updated: ${latestDate || "never"}`);
+  const fileSize = Buffer.byteLength(data, "utf-8");
+  console.log(`File size: ${(fileSize / 1024).toFixed(1)} KB`);
+  console.log("");
+}
+function exportMemory() {
+  console.log("\n\u{1F9E0} toon-memory export\n");
+  const memoryFile = join(projectRoot, ".opencode", "memory", "data.toon");
+  if (!existsSync(memoryFile)) {
+    console.log("Memory not initialized. Run 'npx toon-memory init' first.\n");
+    return;
+  }
+  const data = readFileSync(memoryFile, "utf-8");
+  const lines = data.split("\n").filter((l) => l.startsWith("  ") && l.includes("|"));
+  const entries = lines.map((line) => {
+    const parts = line.trim().split("|");
+    return {
+      id: parts[0],
+      category: parts[1],
+      key: parts[2],
+      content: parts[3],
+      file: parts[4],
+      tags: parts[5] ? parts[5].split(";") : [],
+      date: parts[6]
+    };
+  });
+  const exportData = {
+    project: basename(projectRoot),
+    exported_at: (/* @__PURE__ */ new Date()).toISOString(),
+    entries,
+    summaries: {}
+  };
+  const outputPath = join(projectRoot, "toon-memory-export.json");
+  writeFileSync(outputPath, JSON.stringify(exportData, null, 2));
+  console.log(`Exported ${entries.length} entries to:`);
+  console.log(`  ${outputPath}
+`);
+}
+function importMemory() {
+  console.log("\n\u{1F9E0} toon-memory import\n");
+  const importFile = process.argv[3];
+  if (!importFile) {
+    console.log("Usage: npx toon-memory import <file.json>\n");
+    return;
+  }
+  const importPath = importFile.startsWith("/") ? importFile : join(projectRoot, importFile);
+  if (!existsSync(importPath)) {
+    console.log(`File not found: ${importPath}
+`);
+    return;
+  }
+  let importData;
+  try {
+    importData = JSON.parse(readFileSync(importPath, "utf-8"));
+  } catch {
+    console.log("Invalid JSON file\n");
+    return;
+  }
+  if (!importData.entries || !Array.isArray(importData.entries)) {
+    console.log("Invalid format: missing 'entries' array\n");
+    return;
+  }
+  const memoryDir = join(projectRoot, ".opencode", "memory");
+  const memoryFile = join(memoryDir, "data.toon");
+  if (!existsSync(memoryDir)) mkdirSync(memoryDir, { recursive: true });
+  let existingKeys = [];
+  if (existsSync(memoryFile)) {
+    const existing = readFileSync(memoryFile, "utf-8");
+    existingKeys = existing.split("\n").filter((l) => l.startsWith("  ") && l.includes("|")).map((l) => l.trim().split("|")[2]);
+  }
+  const newEntries = importData.entries.filter((e) => !existingKeys.includes(e.key));
+  if (newEntries.length === 0) {
+    console.log("No new entries to import (all keys already exist)\n");
+    return;
+  }
+  const newLines = newEntries.map((e) => {
+    const tags = Array.isArray(e.tags) ? e.tags.join(";") : e.tags || "";
+    return `  ${e.id}|${e.category}|${e.key}|${e.content}|${e.file}|${tags}|${e.date}`;
+  }).join("\n");
+  if (existsSync(memoryFile)) {
+    const existing = readFileSync(memoryFile, "utf-8");
+    const updated = existing.replace(
+      /entries\[\d+\|]/,
+      `entries[${newEntries.length}|]`
+    ) + "\n" + newLines;
+    writeFileSync(memoryFile, updated);
+  } else {
+    writeFileSync(memoryFile, `version: 1
+entries[${newEntries.length}|]{id|category|key|content|file|tags|date}:
+${newLines}
+`);
+  }
+  console.log(`Imported ${newEntries.length} new entries`);
+  console.log(`Skipped ${importData.entries.length - newEntries.length} duplicates
+`);
+}
 const args = process.argv.slice(2);
 if (args[0] === "uninstall") {
   uninstall();
@@ -212,6 +352,18 @@ if (args[0] === "upgrade") {
   upgrade();
   process.exit(0);
 }
+if (args[0] === "stats") {
+  stats();
+  process.exit(0);
+}
+if (args[0] === "export") {
+  exportMemory();
+  process.exit(0);
+}
+if (args[0] === "import") {
+  importMemory();
+  process.exit(0);
+}
 const agents = detectAgents();
 console.log("\n\u{1F9E0} toon-memory installer\n");
 console.log("Supported agents:");
@@ -231,6 +383,7 @@ Installing ${scope}ly...
     installMCPConfig(agent, scope);
     console.log("");
   }
+  ensureGitignore();
   console.log("Done! Restart your agent to use memory tools.");
   console.log("Run 'npx toon-memory uninstall' to remove.\n");
   rl.close();

package/mcp/server.js

@@ -27709,10 +27709,12 @@ server.registerTool(
     description: "Busca en la memoria persistente del proyecto. Devuelve entradas relevantes. Usar ANTES de leer archivos.",
     inputSchema: {
       query: external_exports.string().describe("Texto a buscar"),
-      category: external_exports.string().optional().default("").describe("Filtrar por categor\xEDa (vac\xEDo = todos)")
+      category: external_exports.string().optional().default("").describe("Filtrar por categor\xEDa (vac\xEDo = todos)"),
+      from_date: external_exports.string().optional().default("").describe("Fecha inicio filtro (YYYY-MM-DD)"),
+      to_date: external_exports.string().optional().default("").describe("Fecha fin filtro (YYYY-MM-DD)")
     }
   },
-  async ({ query, category }) => {
+  async ({ query, category, from_date, to_date }) => {
     const data = readMemory();
     const lines = data.split("\n").filter((l) => l.startsWith("  ") && l.includes("|"));
     const queryLower = query.toLowerCase();
@@ -27722,6 +27724,8 @@ server.registerTool(
       if (parts.length < 7) return null;
       const [id, cat, key, content, file2, tags, date5] = parts;
       if (category && cat !== category) return null;
+      if (from_date && date5 < from_date) return null;
+      if (to_date && date5 > to_date) return null;
       const searchStr = `${id} ${cat} ${key} ${content} ${file2} ${tags}`.toLowerCase();
       if (!searchStr.includes(queryLower)) return null;
       return { id, cat, key, content, file: file2, tags, date: date5 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toon-memory",
-  "version": "1.1.2",
+  "version": "1.3.0",
   "description": "Persistent memory system for AI coding agents using TOON format (40% fewer tokens than JSON)",
   "type": "module",
   "bin": {
@@ -17,7 +17,8 @@
     "uninstall.sh"
   ],
   "scripts": {
-    "build": "npm run build:mcp && npm run build:cli",
+    "build": "npm run build:bin && npm run build:mcp && npm run build:cli",
+    "build:bin": "esbuild src/bin/toon-memory.ts --platform=node --format=esm --outfile=bin/toon-memory.js",
     "build:mcp": "esbuild src/mcp/server.ts --bundle --platform=node --format=esm --outfile=mcp/server.js",
     "build:cli": "esbuild src/cli/setup.ts --platform=node --format=esm --outfile=dist/cli/setup.js && esbuild src/cli/toon-memory.ts --platform=node --format=esm --outfile=dist/cli/toon-memory.js",
     "test": "vitest run",

package/src/bin/toon-memory.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import { dirname, join } from "path"
+import { fileURLToPath } from "url"
+import { spawn } from "child_process"
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const args = process.argv.slice(2)
+
+const target = args[0] === "mcp"
+  ? join(__dirname, "..", "mcp", "server.js")
+  : join(__dirname, "..", "dist", "cli", "setup.js")
+
+const extraArgs = args[0] === "mcp" ? [] : args
+const child = spawn("node", [target, ...extraArgs], { stdio: "inherit" })
+child.on("exit", (code) => process.exit(code ?? 0))

package/src/cli/setup.ts

@@ -1,5 +1,5 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync, cpSync, unlinkSync } from "fs"
-import { dirname, join } from "path"
+import { basename, dirname, join } from "path"
 import { fileURLToPath } from "url"
 import { execSync } from "child_process"
 import { createInterface } from "readline"
@@ -112,6 +112,24 @@ function installOpenCodeTools(): void {
   }
 }
 
+// Add .opencode/memory/ to .gitignore if not present
+function ensureGitignore(): void {
+  const gitignorePath = join(projectRoot, ".gitignore")
+  const entry = ".opencode/memory/"
+  
+  if (!existsSync(gitignorePath)) {
+    writeFileSync(gitignorePath, `${entry}\n`)
+    console.log("  Created .gitignore with memory exclusion")
+    return
+  }
+  
+  const content = readFileSync(gitignorePath, "utf-8")
+  if (!content.includes(entry)) {
+    writeFileSync(gitignorePath, `${content.trim()}\n${entry}\n`)
+    console.log("  Added .opencode/memory/ to .gitignore")
+  }
+}
+
 // Install MCP server config for different agents
 function installMCPConfig(agent: Agent, scope: string): void {
   const configPath = scope === "global" ? agent.global : agent.local
@@ -197,6 +215,8 @@ function init(scope: string = "local"): void {
     console.log("")
   }
   
+  ensureGitignore()
+  
   console.log("Done! Restart your agent to use memory tools.\n")
 }
 
@@ -271,6 +291,161 @@ function upgrade(): void {
   }
 }
 
+// Show memory statistics
+function stats(): void {
+  console.log("\n🧠 toon-memory stats\n")
+  
+  const memoryFile = join(projectRoot, ".opencode", "memory", "data.toon")
+  
+  if (!existsSync(memoryFile)) {
+    console.log("Memory not initialized. Run 'npx toon-memory init' first.\n")
+    return
+  }
+  
+  const data = readFileSync(memoryFile, "utf-8")
+  const lines = data.split("\n").filter((l: string) => l.startsWith("  ") && l.includes("|"))
+  
+  const categories: Record<string, number> = {}
+  let latestDate = ""
+  
+  for (const line of lines) {
+    const parts = line.trim().split("|")
+    if (parts.length >= 7) {
+      const category = parts[1]
+      const date = parts[6]
+      categories[category] = (categories[category] || 0) + 1
+      if (date > latestDate) latestDate = date
+    }
+  }
+  
+  console.log("📊 Memory Stats")
+  console.log("━".repeat(20))
+  console.log(`Total entries: ${lines.length}`)
+  
+  for (const [cat, count] of Object.entries(categories)) {
+    console.log(`├── ${cat}: ${count}`)
+  }
+  
+  console.log(`Last updated: ${latestDate || "never"}`)
+  
+  const fileSize = Buffer.byteLength(data, "utf-8")
+  console.log(`File size: ${(fileSize / 1024).toFixed(1)} KB`)
+  console.log("")
+}
+
+// Export memory to JSON
+function exportMemory(): void {
+  console.log("\n🧠 toon-memory export\n")
+  
+  const memoryFile = join(projectRoot, ".opencode", "memory", "data.toon")
+  
+  if (!existsSync(memoryFile)) {
+    console.log("Memory not initialized. Run 'npx toon-memory init' first.\n")
+    return
+  }
+  
+  const data = readFileSync(memoryFile, "utf-8")
+  const lines = data.split("\n").filter((l: string) => l.startsWith("  ") && l.includes("|"))
+  
+  const entries = lines.map((line: string) => {
+    const parts = line.trim().split("|")
+    return {
+      id: parts[0],
+      category: parts[1],
+      key: parts[2],
+      content: parts[3],
+      file: parts[4],
+      tags: parts[5] ? parts[5].split(";") : [],
+      date: parts[6]
+    }
+  })
+  
+  const exportData = {
+    project: basename(projectRoot),
+    exported_at: new Date().toISOString(),
+    entries,
+    summaries: {}
+  }
+  
+  const outputPath = join(projectRoot, "toon-memory-export.json")
+  writeFileSync(outputPath, JSON.stringify(exportData, null, 2))
+  
+  console.log(`Exported ${entries.length} entries to:`)
+  console.log(`  ${outputPath}\n`)
+}
+
+// Import memory from JSON
+function importMemory(): void {
+  console.log("\n🧠 toon-memory import\n")
+  
+  const importFile = process.argv[3]
+  
+  if (!importFile) {
+    console.log("Usage: npx toon-memory import <file.json>\n")
+    return
+  }
+  
+  // Use absolute path if provided, otherwise resolve relative to project root
+  const importPath = importFile.startsWith("/") ? importFile : join(projectRoot, importFile)
+  
+  if (!existsSync(importPath)) {
+    console.log(`File not found: ${importPath}\n`)
+    return
+  }
+  
+  let importData: any
+  try {
+    importData = JSON.parse(readFileSync(importPath, "utf-8"))
+  } catch {
+    console.log("Invalid JSON file\n")
+    return
+  }
+  
+  if (!importData.entries || !Array.isArray(importData.entries)) {
+    console.log("Invalid format: missing 'entries' array\n")
+    return
+  }
+  
+  const memoryDir = join(projectRoot, ".opencode", "memory")
+  const memoryFile = join(memoryDir, "data.toon")
+  
+  if (!existsSync(memoryDir)) mkdirSync(memoryDir, { recursive: true })
+  
+  let existingKeys: string[] = []
+  if (existsSync(memoryFile)) {
+    const existing = readFileSync(memoryFile, "utf-8")
+    existingKeys = existing.split("\n")
+      .filter((l: string) => l.startsWith("  ") && l.includes("|"))
+      .map((l: string) => l.trim().split("|")[2])
+  }
+  
+  const newEntries = importData.entries.filter((e: any) => !existingKeys.includes(e.key))
+  
+  if (newEntries.length === 0) {
+    console.log("No new entries to import (all keys already exist)\n")
+    return
+  }
+  
+  const newLines = newEntries.map((e: any) => {
+    const tags = Array.isArray(e.tags) ? e.tags.join(";") : (e.tags || "")
+    return `  ${e.id}|${e.category}|${e.key}|${e.content}|${e.file}|${tags}|${e.date}`
+  }).join("\n")
+  
+  if (existsSync(memoryFile)) {
+    const existing = readFileSync(memoryFile, "utf-8")
+    const updated = existing.replace(
+      /entries\[\d+\|]/,
+      `entries[${newEntries.length}|]`
+    ) + "\n" + newLines
+    writeFileSync(memoryFile, updated)
+  } else {
+    writeFileSync(memoryFile, `version: 1\nentries[${newEntries.length}|]{id|category|key|content|file|tags|date}:\n${newLines}\n`)
+  }
+  
+  console.log(`Imported ${newEntries.length} new entries`)
+  console.log(`Skipped ${importData.entries.length - newEntries.length} duplicates\n`)
+}
+
 // Main
 const args = process.argv.slice(2)
 
@@ -294,6 +469,21 @@ if (args[0] === "upgrade") {
   process.exit(0)
 }
 
+if (args[0] === "stats") {
+  stats()
+  process.exit(0)
+}
+
+if (args[0] === "export") {
+  exportMemory()
+  process.exit(0)
+}
+
+if (args[0] === "import") {
+  importMemory()
+  process.exit(0)
+}
+
 const agents = detectAgents()
 console.log("\n🧠 toon-memory installer\n")
 
@@ -317,6 +507,8 @@ rl.question("Install (1) Local or (2) Global? [1/2]: ", (answer: string) => {
     console.log("")
   }
   
+  ensureGitignore()
+  
   console.log("Done! Restart your agent to use memory tools.")
   console.log("Run 'npx toon-memory uninstall' to remove.\n")
   rl.close()

package/src/mcp/server.ts

@@ -83,9 +83,11 @@ server.registerTool(
     inputSchema: {
       query: z.string().describe("Texto a buscar"),
       category: z.string().optional().default("").describe("Filtrar por categoría (vacío = todos)"),
+      from_date: z.string().optional().default("").describe("Fecha inicio filtro (YYYY-MM-DD)"),
+      to_date: z.string().optional().default("").describe("Fecha fin filtro (YYYY-MM-DD)"),
     },
   },
-  async ({ query, category }) => {
+  async ({ query, category, from_date, to_date }) => {
     const data = readMemory()
     const lines = data.split("\n").filter((l) => l.startsWith("  ") && l.includes("|"))
     const queryLower = query.toLowerCase()
@@ -97,6 +99,8 @@ server.registerTool(
         if (parts.length < 7) return null
         const [id, cat, key, content, file, tags, date] = parts
         if (category && cat !== category) return null
+        if (from_date && date < from_date) return null
+        if (to_date && date > to_date) return null
         const searchStr = `${id} ${cat} ${key} ${content} ${file} ${tags}`.toLowerCase()
         if (!searchStr.includes(queryLower)) return null
         return { id, cat, key, content, file, tags, date }