total-agent-memory 0.1.0 → 1.1.0

package/README.md

@@ -7,8 +7,10 @@
 npx -y total-agent-memory
 ```
 
-That's it. One command bootstraps a Python virtual env in `~/.claude-memory/`,
-installs the MCP server, and prints next-step instructions for wiring your IDE.
+That's it. One command bootstraps a Python virtual env in `~/.tam/` (legacy
+`~/.claude-memory/` is migrated automatically with a symlink kept for
+backward-compat), installs the MCP server, and prints next-step instructions
+for wiring your IDE.
 
 ## Quick start
 
@@ -37,7 +39,7 @@ Alias: `tam` (same binary).
 | `status`          | Print install paths, DB size. |
 | `doctor`          | Diagnose Python/uv/git on PATH. |
 | `upgrade`         | Pull the latest server version. |
-| `uninstall`       | Remove `~/.claude-memory` (needs `--yes`). |
+| `uninstall`       | Remove `~/.tam` (needs `--yes`). Also removes `~/.claude-memory` if it's a symlink to `~/.tam`. |
 
 ## Options
 
@@ -45,7 +47,7 @@ Alias: `tam` (same binary).
 |---|---|
 | `--server-version 11.2.2` | Pin a specific server release. |
 | `--source pypi\|git`       | Force install source. Default: PyPI with GitHub fallback. |
-| `--memory-dir /path`      | Override install dir (default `~/.claude-memory`). |
+| `--memory-dir /path`      | Override install dir (default `~/.tam`). |
 | `--yes`                   | Skip prompts (needed for `uninstall`). |
 | `--no-color`              | Disable ANSI. |
 | `--verbose`               | Print every shell command. |
@@ -59,9 +61,9 @@ Alias: `tam` (same binary).
 ## What gets installed
 
 ```
-~/.claude-memory/
+~/.tam/
 ├── .venv/                   # isolated Python env
-│   └── bin/claude-total-memory   # MCP server entry-point
+│   └── bin/total-agent-memory   # MCP server entry-point (legacy claude-total-memory also installed)
 └── memory.db                # SQLite — your memory lives here
 ```
 
@@ -71,7 +73,7 @@ Nothing global is touched. Uninstall with `tam uninstall --yes`.
 
 - Site: <https://totalmemory.dev>
 - Server source: <https://github.com/vbcherepanov/total-agent-memory>
-- PyPI package: `claude-total-memory`
+- PyPI package: `total-agent-memory` (legacy `claude-total-memory` is now a deprecation shim)
 
 ## License
 

package/bin/cli.js

@@ -16,7 +16,7 @@ ${bold('Usage:')}  total-agent-memory <command> [options]
         ${dim('alias:')} tam <command> [options]
 
 ${bold('Commands:')}
-  install            Install Python server into ~/.claude-memory (idempotent)
+  install            Install Python server into ~/.tam (idempotent)
   start              Start the MCP server (default if no command)
   connect <ide>      Wire memory into an IDE config
                      ${dim('claude-code | codex | cursor | cline | continue')}
@@ -25,7 +25,7 @@ ${bold('Commands:')}
   status             Health check + tool count + DB stats
   doctor             Diagnose environment (python, uv, ports, configs)
   upgrade            Upgrade to the latest server version
-  uninstall          Remove ~/.claude-memory and IDE wirings
+  uninstall          Remove ~/.tam and IDE wirings
   version            Print version
   help               Show this message
 
@@ -33,7 +33,7 @@ ${bold('Options:')}
   --version, -v         Print npm wrapper version
   --server-version <v>  Pin server version (default: latest)
   --source <pypi|git>   Where to install from (default: auto)
-  --memory-dir <path>   Override install dir (default: ~/.claude-memory)
+  --memory-dir <path>   Override install dir (default: ~/.tam)
   --yes, -y             Skip prompts
   --no-color            Disable ANSI colors
   --verbose             Print every shell command

package/lib/commands.js

@@ -11,7 +11,7 @@ const { run, runOrThrow } = require('./sh');
 const { c, bold, ok, fail, warn, info, banner, step } = require('./style');
 
 async function ensureInstalled(ctx) {
-  const bin = venvBin(ctx.flags, 'claude-total-memory');
+  const bin = venvBin(ctx.flags, 'total-agent-memory');
   if (exists(bin)) return bin;
   process.stdout.write(`${info('Server not installed yet — installing now…')}\n`);
   const code = await install(ctx);
@@ -85,7 +85,7 @@ async function cmdStatus(ctx) {
   printReport(env);
   const dir = memoryDir(ctx.flags);
   const venv = venvDir(ctx.flags);
-  const bin = venvBin(ctx.flags, 'claude-total-memory');
+  const bin = venvBin(ctx.flags, 'total-agent-memory');
   const db = path.join(dir, 'memory.db');
   process.stdout.write(`\n${bold('Install')}\n`);
   process.stdout.write(`  ${exists(dir) ? ok(`memory dir : ${dir}`) : warn(`memory dir : ${dir} (missing)`)}\n`);

package/lib/ide.js

@@ -18,7 +18,7 @@ const SUPPORTED = [
 ];
 
 function mcpEntry(flags) {
-  const bin = venvBin(flags, 'claude-total-memory');
+  const bin = venvBin(flags, 'total-agent-memory');
   return {
     command: bin,
     args: [],
@@ -113,7 +113,7 @@ function wireOpenCode(flags) {
 }
 function wireCodex(flags) {
   ensureDir(path.dirname(codexPath()));
-  const bin = venvBin(flags, 'claude-total-memory');
+  const bin = venvBin(flags, 'total-agent-memory');
   const block = `
 
 [mcp_servers.total-agent-memory]

package/lib/install.js

@@ -7,10 +7,10 @@ const { memoryDir, venvDir, venvBin, ensureDir, exists } = require('./paths');
 const { diagnose, pickInstaller, printReport, printRemediation } = require('./doctor');
 const { c, bold, ok, fail, warn, info, step } = require('./style');
 
-const PYPI_PACKAGE = 'claude-total-memory';
+const PYPI_PACKAGE = 'total-agent-memory';
 // Pinned to the latest stable release at the time of the wrapper release.
 // Override via `--server-version` or env TAM_SERVER_VERSION.
-const DEFAULT_SERVER_VERSION = '11.2.2';
+const DEFAULT_SERVER_VERSION = '12.2.0';
 const GIT_URL = 'https://github.com/vbcherepanov/total-agent-memory.git';
 
 function pinned(flags) {
@@ -81,10 +81,10 @@ async function pipInstall(flags, env, source) {
     process.stdout.write(`  ${warn('TAM_INSTALL_DRY=1 — skipping real pip install')}\n`);
     // Drop a marker file so subsequent steps don't barf on missing bin.
     const fs = require('fs');
-    const markerDir = path.dirname(venvBin(flags, 'claude-total-memory'));
+    const markerDir = path.dirname(venvBin(flags, 'total-agent-memory'));
     fs.mkdirSync(markerDir, { recursive: true });
-    fs.writeFileSync(venvBin(flags, 'claude-total-memory'), '#!/bin/sh\necho "dry-run shim"\n');
-    fs.chmodSync(venvBin(flags, 'claude-total-memory'), 0o755);
+    fs.writeFileSync(venvBin(flags, 'total-agent-memory'), '#!/bin/sh\necho "dry-run shim"\n');
+    fs.chmodSync(venvBin(flags, 'total-agent-memory'), 0o755);
     return;
   }
 
@@ -122,7 +122,7 @@ async function install(ctx) {
   await pipInstall(flags, env, source);
 
   // Verify entry-point present.
-  const bin = venvBin(flags, 'claude-total-memory');
+  const bin = venvBin(flags, 'total-agent-memory');
   if (!exists(bin)) {
     process.stderr.write(`\n${fail(`entry-point ${bin} not found after install`)}\n`);
     return 1;

package/lib/paths.js

@@ -8,10 +8,24 @@ function home() {
   return process.env.HOME || process.env.USERPROFILE || os.homedir();
 }
 
+let _warnedLegacyEnv = false;
+
 function memoryDir(flags) {
   if (flags && typeof flags['memory-dir'] === 'string') return flags['memory-dir'];
-  if (process.env.CLAUDE_MEMORY_DIR) return process.env.CLAUDE_MEMORY_DIR;
-  return path.join(home(), '.claude-memory');
+  if (process.env.TAM_MEMORY_DIR) return process.env.TAM_MEMORY_DIR;
+  if (process.env.CLAUDE_MEMORY_DIR) {
+    if (!_warnedLegacyEnv) {
+      // eslint-disable-next-line no-console
+      console.warn('  ⚠ CLAUDE_MEMORY_DIR is deprecated, please switch to TAM_MEMORY_DIR');
+      _warnedLegacyEnv = true;
+    }
+    return process.env.CLAUDE_MEMORY_DIR;
+  }
+  const tam = path.join(home(), '.tam');
+  const legacy = path.join(home(), '.claude-memory');
+  if (fs.existsSync(tam)) return tam;
+  if (fs.existsSync(legacy)) return legacy; // Python server will migrate on first run.
+  return tam;
 }
 
 function venvDir(flags) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "total-agent-memory",
-  "version": "0.1.0",
+  "version": "1.1.0",
   "description": "Persistent memory for Claude Code, Codex CLI, Cursor and any MCP client. Local-first, hits #5 on LoCoMo. One command to install.",
   "keywords": [
     "mcp",