toon-memory 1.0.9 → 1.1.1

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 luiggival
+Copyright (c) 2026 Luis Angel Valencia Valera
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -31,10 +31,10 @@ AI agents forget everything between sessions. toon-memory fixes this by providin
 
 ```bash
 # macOS / Linux
-curl -fsSL https://raw.githubusercontent.com/luiggival/toon-memory/main/install.sh | sh
+curl -fsSL https://raw.githubusercontent.com/LuiggiVal08/toon-memory/main/install.sh | sh
 
 # Windows (PowerShell)
-irm https://raw.githubusercontent.com/luiggival/toon-memory/main/install.ps1 | iex
+irm https://raw.githubusercontent.com/LuiggiVal08/toon-memory/main/install.ps1 | iex
 
 # Or with npm (any platform)
 npm i -g toon-memory
@@ -110,7 +110,10 @@ summaries:
 
 ```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
 ```
 
@@ -198,7 +201,7 @@ TOON (Token-Oriented Object Notation) is designed for LLMs:
 ## Development
 
 ```bash
-git clone https://github.com/luiggival/toon-memory.git
+git clone https://github.com/LuiggiVal08/toon-memory.git
 cd toon-memory
 npm install
 npm run build

package/bin/toon-memory.js

@@ -8,7 +8,7 @@ const args = process.argv.slice(2)
 
 const target = args[0] === "mcp"
   ? join(__dirname, "..", "mcp", "server.js")
-  : join(__dirname, "setup.js")
+  : join(__dirname, "..", "dist", "cli", "setup.js")
 
 const extraArgs = args[0] === "mcp" ? [] : args
 const child = spawn("node", [target, ...extraArgs], { stdio: "inherit" })

package/dist/cli/setup.js

@@ -0,0 +1,237 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync, cpSync, unlinkSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+import { execSync } from "child_process";
+import { createInterface } from "readline";
+import { createRequire } from "module";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const projectRoot = process.cwd();
+const sourceDir = join(__dirname, "..", "src");
+const HOME = process.env.HOME || process.env.USERPROFILE || "~";
+try {
+  createRequire(import.meta.url).resolve("@toon-format/toon");
+} catch {
+  console.log("Installing @toon-format/toon...");
+  execSync("npm install @toon-format/toon", { cwd: projectRoot, stdio: "inherit" });
+}
+function detectAgents() {
+  const agents2 = [];
+  const opencodeGlobal = join(HOME, ".config", "opencode", "opencode.json");
+  const opencodeLocal = join(projectRoot, ".opencode", "opencode.json");
+  agents2.push({
+    name: "opencode",
+    global: opencodeGlobal,
+    local: opencodeLocal,
+    mcpKey: "mcp"
+  });
+  const vscodeLocal = join(projectRoot, ".vscode", "mcp.json");
+  agents2.push({
+    name: "vscode/copilot",
+    local: vscodeLocal,
+    mcpKey: "servers"
+  });
+  const claudeGlobal = join(HOME, ".claude", "settings.json");
+  const claudeLocal = join(projectRoot, ".claude", "settings.json");
+  agents2.push({
+    name: "claude",
+    global: claudeGlobal,
+    local: claudeLocal,
+    mcpKey: "mcpServers"
+  });
+  const cursorLocal = join(projectRoot, ".cursor", "mcp.json");
+  agents2.push({
+    name: "cursor",
+    local: cursorLocal,
+    mcpKey: "mcpServers"
+  });
+  const windsurfGlobal = join(HOME, ".codeium", "windsurf", "mcp_config.json");
+  agents2.push({
+    name: "windsurf",
+    global: windsurfGlobal,
+    mcpKey: "mcpServers"
+  });
+  const clineLocal = join(projectRoot, ".cline", "mcp.json");
+  agents2.push({
+    name: "cline",
+    local: clineLocal,
+    mcpKey: "mcpServers"
+  });
+  const continueLocal = join(projectRoot, ".continue", "config.json");
+  agents2.push({
+    name: "continue",
+    local: continueLocal,
+    mcpKey: "mcpServers"
+  });
+  return agents2;
+}
+function installOpenCodeTools() {
+  const toolsDir = join(projectRoot, ".opencode", "tools");
+  const memoryDir = join(projectRoot, ".opencode", "memory");
+  const memoryFile = join(memoryDir, "data.toon");
+  if (!existsSync(toolsDir)) mkdirSync(toolsDir, { recursive: true });
+  if (!existsSync(memoryDir)) mkdirSync(memoryDir, { recursive: true });
+  cpSync(join(sourceDir, "memory.ts"), join(toolsDir, "memory.ts"));
+  console.log("  Copied memory.ts to .opencode/tools/");
+  if (!existsSync(memoryFile)) {
+    writeFileSync(memoryFile, "version: 1\nentries[0|]{id|category|key|content|file|tags|date}:\n");
+    console.log("  Created .opencode/memory/data.toon");
+  }
+}
+function installMCPConfig(agent, scope) {
+  const configPath = scope === "global" ? agent.global : agent.local;
+  if (!configPath) {
+    console.log(`  No ${scope} config path for ${agent.name}`);
+    return;
+  }
+  const configDir = dirname(configPath);
+  if (!existsSync(configDir)) mkdirSync(configDir, { recursive: true });
+  let config = {};
+  if (existsSync(configPath)) {
+    try {
+      config = JSON.parse(readFileSync(configPath, "utf-8"));
+    } catch {
+      config = {};
+    }
+  }
+  const mcpKey = agent.mcpKey || "mcpServers";
+  if (!config[mcpKey]) config[mcpKey] = {};
+  config[mcpKey]["toon-memory"] = {
+    command: "npx",
+    args: ["-y", "toon-memory", "mcp"]
+  };
+  writeFileSync(configPath, JSON.stringify(config, null, 2));
+  console.log(`  MCP server added to ${configPath}`);
+}
+function uninstall() {
+  console.log("\n\u{1F9E0} toon-memory uninstaller\n");
+  const agents2 = detectAgents();
+  for (const agent of agents2) {
+    const configs = [agent.global, agent.local].filter(Boolean);
+    for (const configPath of configs) {
+      if (!existsSync(configPath)) continue;
+      try {
+        const config = JSON.parse(readFileSync(configPath, "utf-8"));
+        const mcpKey = agent.mcpKey || "mcpServers";
+        if (config[mcpKey]?.["toon-memory"]) {
+          delete config[mcpKey]["toon-memory"];
+          writeFileSync(configPath, JSON.stringify(config, null, 2));
+          console.log(`  \u2705 Removed from ${agent.name} (${configPath})`);
+        }
+      } catch {
+      }
+    }
+  }
+  const toolsFile = join(projectRoot, ".opencode", "tools", "memory.ts");
+  if (existsSync(toolsFile)) {
+    unlinkSync(toolsFile);
+    console.log("  \u2705 Removed .opencode/tools/memory.ts");
+  }
+  console.log("\n\u2705 toon-memory uninstalled from all agents\n");
+}
+function init(scope = "local") {
+  console.log("\n\u{1F9E0} toon-memory init\n");
+  const agents2 = detectAgents();
+  for (const agent of agents2) {
+    console.log(`${agent.name}:`);
+    if (agent.name === "opencode") {
+      installOpenCodeTools();
+    }
+    installMCPConfig(agent, scope);
+    console.log("");
+  }
+  console.log("Done! Restart your agent to use memory tools.\n");
+}
+function status() {
+  console.log("\n\u{1F9E0} toon-memory status\n");
+  try {
+    const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
+    console.log(`Version: ${pkg.version}`);
+  } catch {
+    console.log("Version: unknown");
+  }
+  const memoryFile = join(projectRoot, ".opencode", "memory", "data.toon");
+  if (existsSync(memoryFile)) {
+    const data = readFileSync(memoryFile, "utf-8");
+    const lines = data.split("\n").filter((l) => l.startsWith("  ") && l.includes("|"));
+    console.log(`Memory: ${lines.length} entries`);
+  } else {
+    console.log("Memory: not initialized");
+  }
+  const agents2 = detectAgents();
+  console.log("\nAgent configs:");
+  for (const agent of agents2) {
+    const configs = [agent.global, agent.local].filter(Boolean);
+    let found = false;
+    for (const configPath of configs) {
+      if (!existsSync(configPath)) continue;
+      try {
+        const config = JSON.parse(readFileSync(configPath, "utf-8"));
+        const mcpKey = agent.mcpKey || "mcpServers";
+        if (config[mcpKey]?.["toon-memory"]) {
+          console.log(`  \u2705 ${agent.name} (${configPath})`);
+          found = true;
+        }
+      } catch {
+      }
+    }
+    if (!found) {
+      console.log(`  \u274C ${agent.name} (not configured)`);
+    }
+  }
+  console.log("");
+}
+function upgrade() {
+  console.log("\n\u{1F9E0} toon-memory upgrade\n");
+  try {
+    console.log("Checking for updates...");
+    const latest = execSync("npm view toon-memory version", { encoding: "utf-8" }).trim();
+    console.log(`Latest version: ${latest}`);
+    console.log("Upgrading...");
+    execSync("npm install -g toon-memory@" + latest, { stdio: "inherit" });
+    console.log(`
+\u2705 Upgraded to toon-memory@${latest}`);
+    console.log("Restart your agent to use the new version.\n");
+  } catch (error) {
+    console.error("Upgrade failed:", error.message);
+  }
+}
+const args = process.argv.slice(2);
+if (args[0] === "uninstall") {
+  uninstall();
+  process.exit(0);
+}
+if (args[0] === "init") {
+  init(args[1] || "local");
+  process.exit(0);
+}
+if (args[0] === "status") {
+  status();
+  process.exit(0);
+}
+if (args[0] === "upgrade") {
+  upgrade();
+  process.exit(0);
+}
+const agents = detectAgents();
+console.log("\n\u{1F9E0} toon-memory installer\n");
+console.log("Supported agents:");
+agents.forEach((a, i) => console.log(`  ${i + 1}. ${a.name}`));
+console.log("");
+const rl = createInterface({ input: process.stdin, output: process.stdout });
+rl.question("Install (1) Local or (2) Global? [1/2]: ", (answer) => {
+  const scope = answer === "2" ? "global" : "local";
+  console.log(`
+Installing ${scope}ly...
+`);
+  for (const agent of agents) {
+    console.log(`${agent.name}:`);
+    if (agent.name === "opencode") {
+      installOpenCodeTools();
+    }
+    installMCPConfig(agent, scope);
+    console.log("");
+  }
+  console.log("Done! Restart your agent to use memory tools.");
+  console.log("Run 'npx toon-memory uninstall' to remove.\n");
+  rl.close();
+});

package/dist/cli/toon-memory.js

@@ -0,0 +1,9 @@
+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/install.ps1

@@ -0,0 +1,62 @@
+# toon-memory installer for Windows (PowerShell)
+# Usage: irm https://raw.githubusercontent.com/LuiggiVal08/toon-memory/main/install.ps1 | iex
+
+$TOON_VERSION = "1.0.9"
+
+Write-Host "🧠 toon-memory installer" -ForegroundColor Cyan
+Write-Host ""
+
+# Check if npm is available
+if (Get-Command npm -ErrorAction SilentlyContinue) {
+    Write-Host "Installing toon-memory via npm..."
+    npm install -g toon-memory@$TOON_VERSION
+    Write-Host ""
+    Write-Host "✅ toon-memory installed!" -ForegroundColor Green
+    Write-Host ""
+    Write-Host "Next steps:"
+    Write-Host "  1. Run: npx toon-memory"
+    Write-Host "  2. Select your agent(s)"
+    Write-Host "  3. Choose local or global install"
+    Write-Host ""
+} else {
+    Write-Host "npm not found. Installing standalone..." -ForegroundColor Yellow
+    Write-Host ""
+    
+    # Create installation directory
+    $INSTALL_DIR = "$env:USERPROFILE\.toon-memory"
+    New-Item -ItemType Directory -Force -Path $INSTALL_DIR | Out-Null
+    
+    # Download the package
+    Write-Host "Downloading toon-memory v$TOON_VERSION..."
+    $url = "https://registry.npmjs.org/toon-memory/-/toon-memory-$TOON_VERSION.tgz"
+    $tgzPath = "$INSTALL_DIR\toon-memory.tgz"
+    Invoke-WebRequest -Uri $url -OutFile $tgzPath
+    
+    # Extract
+    cd $INSTALL_DIR
+    tar xzf toon-memory.tgz
+    Move-Item -Path "package\*" -Destination "." -Force
+    Remove-Item -Path "package" -Recurse -Force
+    Remove-Item -Path $tgzPath -Force
+    
+    # Create launcher script
+    $launcherContent = @"
+`$SCRIPT_DIR = Split-Path -Parent `$MyInvocation.MyCommand.Path
+node "`$SCRIPT_DIR\bin\toon-memory.js" @args
+"@
+    Set-Content -Path "$INSTALL_DIR\toon-memory.ps1" -Value $launcherContent
+    
+    # Add to PATH if not already there
+    $currentPath = [Environment]::GetEnvironmentVariable("Path", "User")
+    if ($currentPath -notlike "*$INSTALL_DIR*") {
+        [Environment]::SetEnvironmentVariable("Path", "$INSTALL_DIR;$currentPath", "User")
+        Write-Host "Added to PATH"
+    }
+    
+    Write-Host ""
+    Write-Host "✅ toon-memory installed to $INSTALL_DIR" -ForegroundColor Green
+    Write-Host ""
+    Write-Host "⚠️  Open a new PowerShell window, then run:"
+    Write-Host "  toon-memory.ps1"
+    Write-Host ""
+}

package/mcp/server.js

@@ -27664,7 +27664,7 @@ function generateId() {
   return randomBytes(4).toString("hex");
 }
 var server = new McpServer(
-  { name: "toon-memory", version: "1.0.9" },
+  { name: "toon-memory", version: "1.1.0" },
   { capabilities: { tools: { listChanged: true } } }
 );
 server.registerTool(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toon-memory",
-  "version": "1.0.9",
+  "version": "1.1.1",
   "description": "Persistent memory system for AI coding agents using TOON format (40% fewer tokens than JSON)",
   "type": "module",
   "bin": {
@@ -9,13 +9,17 @@
   "files": [
     "src/",
     "bin/",
+    "dist/",
     "mcp/",
     "skills/",
     "install.sh",
+    "install.ps1",
     "uninstall.sh"
   ],
   "scripts": {
-    "build": "esbuild src/mcp/server.ts --bundle --platform=node --format=esm --outfile=mcp/server.js",
+    "build": "npm run build:mcp && npm run build:cli",
+    "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",
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
@@ -46,10 +50,10 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/luiggival/toon-memory.git"
+    "url": "https://github.com/LuiggiVal08/toon-memory.git"
   },
-  "homepage": "https://github.com/luiggival/toon-memory#readme",
+  "homepage": "https://github.com/LuiggiVal08/toon-memory#readme",
   "bugs": {
-    "url": "https://github.com/luiggival/toon-memory/issues"
+    "url": "https://github.com/LuiggiVal08/toon-memory/issues"
   }
 }

package/{bin/setup.js → src/cli/setup.ts}

@@ -1,5 +1,4 @@
-#!/usr/bin/env node
-import { existsSync, mkdirSync, readFileSync, writeFileSync, cpSync, unlinkSync, rmdirSync } from "fs"
+import { existsSync, mkdirSync, readFileSync, writeFileSync, cpSync, unlinkSync } from "fs"
 import { dirname, join } from "path"
 import { fileURLToPath } from "url"
 import { execSync } from "child_process"
@@ -9,7 +8,14 @@ import { createRequire } from "module"
 const __dirname = dirname(fileURLToPath(import.meta.url))
 const projectRoot = process.cwd()
 const sourceDir = join(__dirname, "..", "src")
-const HOME = process.env.HOME || "~"
+const HOME = process.env.HOME || process.env.USERPROFILE || "~"
+
+interface Agent {
+  name: string
+  global?: string
+  local?: string
+  mcpKey: string
+}
 
 // Auto-install @toon-format/toon if not present
 try {
@@ -20,8 +26,8 @@ try {
 }
 
 // Detect all supported agents
-function detectAgents() {
-  const agents = []
+function detectAgents(): Agent[] {
+  const agents: Agent[] = []
   
   // OpenCode
   const opencodeGlobal = join(HOME, ".config", "opencode", "opencode.json")
@@ -87,7 +93,7 @@ function detectAgents() {
 }
 
 // Install custom tools for OpenCode
-function installOpenCodeTools() {
+function installOpenCodeTools(): void {
   const toolsDir = join(projectRoot, ".opencode", "tools")
   const memoryDir = join(projectRoot, ".opencode", "memory")
   const memoryFile = join(memoryDir, "data.toon")
@@ -105,7 +111,7 @@ function installOpenCodeTools() {
 }
 
 // Install MCP server config for different agents
-function installMCPConfig(agent, scope) {
+function installMCPConfig(agent: Agent, scope: string): void {
   const configPath = scope === "global" ? agent.global : agent.local
   
   if (!configPath) {
@@ -116,7 +122,7 @@ function installMCPConfig(agent, scope) {
   const configDir = dirname(configPath)
   if (!existsSync(configDir)) mkdirSync(configDir, { recursive: true })
   
-  let config = {}
+  let config: Record<string, any> = {}
   if (existsSync(configPath)) {
     try {
       config = JSON.parse(readFileSync(configPath, "utf-8"))
@@ -138,13 +144,13 @@ function installMCPConfig(agent, scope) {
 }
 
 // Uninstall from all agents
-function uninstall() {
+function uninstall(): void {
   console.log("\n🧠 toon-memory uninstaller\n")
   
   const agents = detectAgents()
   
   for (const agent of agents) {
-    const configs = [agent.global, agent.local].filter(Boolean)
+    const configs = [agent.global, agent.local].filter(Boolean) as string[]
     
     for (const configPath of configs) {
       if (!existsSync(configPath)) continue
@@ -172,6 +178,97 @@ function uninstall() {
   console.log("\n✅ toon-memory uninstalled from all agents\n")
 }
 
+// Quick init without interactive prompts
+function init(scope: string = "local"): void {
+  console.log("\n🧠 toon-memory init\n")
+  
+  const agents = detectAgents()
+  
+  for (const agent of agents) {
+    console.log(`${agent.name}:`)
+    
+    if (agent.name === "opencode") {
+      installOpenCodeTools()
+    }
+    
+    installMCPConfig(agent, scope)
+    console.log("")
+  }
+  
+  console.log("Done! Restart your agent to use memory tools.\n")
+}
+
+// Show installation status
+function status(): void {
+  console.log("\n🧠 toon-memory status\n")
+  
+  // Check npm package
+  try {
+    const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"))
+    console.log(`Version: ${pkg.version}`)
+  } catch {
+    console.log("Version: unknown")
+  }
+  
+  // Check memory file
+  const memoryFile = join(projectRoot, ".opencode", "memory", "data.toon")
+  if (existsSync(memoryFile)) {
+    const data = readFileSync(memoryFile, "utf-8")
+    const lines = data.split("\n").filter((l: string) => l.startsWith("  ") && l.includes("|"))
+    console.log(`Memory: ${lines.length} entries`)
+  } else {
+    console.log("Memory: not initialized")
+  }
+  
+  // Check agent configs
+  const agents = detectAgents()
+  console.log("\nAgent configs:")
+  
+  for (const agent of agents) {
+    const configs = [agent.global, agent.local].filter(Boolean) as string[]
+    let found = false
+    
+    for (const configPath of configs) {
+      if (!existsSync(configPath)) continue
+      
+      try {
+        const config = JSON.parse(readFileSync(configPath, "utf-8"))
+        const mcpKey = agent.mcpKey || "mcpServers"
+        
+        if (config[mcpKey]?.["toon-memory"]) {
+          console.log(`  ✅ ${agent.name} (${configPath})`)
+          found = true
+        }
+      } catch {}
+    }
+    
+    if (!found) {
+      console.log(`  ❌ ${agent.name} (not configured)`)
+    }
+  }
+  
+  console.log("")
+}
+
+// Upgrade to latest version
+function upgrade(): void {
+  console.log("\n🧠 toon-memory upgrade\n")
+  
+  try {
+    console.log("Checking for updates...")
+    const latest = execSync("npm view toon-memory version", { encoding: "utf-8" }).trim()
+    console.log(`Latest version: ${latest}`)
+    
+    console.log("Upgrading...")
+    execSync("npm install -g toon-memory@" + latest, { stdio: "inherit" })
+    
+    console.log(`\n✅ Upgraded to toon-memory@${latest}`)
+    console.log("Restart your agent to use the new version.\n")
+  } catch (error) {
+    console.error("Upgrade failed:", (error as Error).message)
+  }
+}
+
 // Main
 const args = process.argv.slice(2)
 
@@ -180,15 +277,30 @@ if (args[0] === "uninstall") {
   process.exit(0)
 }
 
+if (args[0] === "init") {
+  init(args[1] || "local")
+  process.exit(0)
+}
+
+if (args[0] === "status") {
+  status()
+  process.exit(0)
+}
+
+if (args[0] === "upgrade") {
+  upgrade()
+  process.exit(0)
+}
+
 const agents = detectAgents()
 console.log("\n🧠 toon-memory installer\n")
 
 console.log("Supported agents:")
-agents.forEach((a, i) => console.log(`  ${i + 1}. ${a.name}`))
+agents.forEach((a: Agent, i: number) => console.log(`  ${i + 1}. ${a.name}`))
 console.log("")
 
 const rl = createInterface({ input: process.stdin, output: process.stdout })
-rl.question("Install (1) Local or (2) Global? [1/2]: ", (answer) => {
+rl.question("Install (1) Local or (2) Global? [1/2]: ", (answer: string) => {
   const scope = answer === "2" ? "global" : "local"
   console.log(`\nInstalling ${scope}ly...\n`)
   

package/src/cli/toon-memory.ts

@@ -0,0 +1,14 @@
+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/mcp/server.ts

@@ -32,7 +32,7 @@ function generateId(): string {
 }
 
 const server = new McpServer(
-  { name: "toon-memory", version: "1.0.9" },
+  { name: "toon-memory", version: "1.1.0" },
   { capabilities: { tools: { listChanged: true } } }
 )