forget-connect 0.5.1 → 0.5.2

package/assets/commands/forget-settings.md

@@ -0,0 +1,25 @@
+---
+description: forget settings — status, doctor, weekly report, cloud usage
+argument-hint: "[doctor|weekly|usage]"
+allowed-tools: Bash(~/.forget/venv/bin/forget-server recall:*), Bash(~/.forget/venv/bin/forget-server status:*), Bash(~/.forget/venv/bin/forget-server doctor:*), Bash(~/.forget/venv/bin/forget-server weekly:*), Bash(npx forget-connect doctor:*)
+---
+<!-- forget-connect:command v1 — delete this line to keep your edits across upgrades -->
+
+Recall dial:
+!`~/.forget/venv/bin/forget-server recall status 2>/dev/null`
+
+Argument: "$ARGUMENTS"
+
+- `doctor`: run `~/.forget/venv/bin/forget-server doctor`. If every line is ✓,
+  say "healthy" in one line; if any ✗, explain only that line's prescription (→)
+  and ask before running it.
+- `weekly`: run `~/.forget/venv/bin/forget-server weekly`; summarize the numbers only.
+- `usage`: run `~/.forget/venv/bin/forget-server recall cloud-usage` and show the
+  output as is.
+- No argument: combine the dial output above with
+  `~/.forget/venv/bin/forget-server status` into a settings screen of at most
+  4 lines: dial / server + memory count / LLM / anything unusual (only when
+  present). End with a short pointer: gear changes are /forget.
+  If deep recall is off: a running local LLM (Ollama · LM Studio) attaches
+  automatically; forget cloud (forget.sh/cloud) is the no-GPU alternative —
+  never install anything on the user's behalf.

package/assets/commands/forget.md

@@ -0,0 +1,24 @@
+---
+description: Recall dial — pick a gear (low·medium·high·extra)
+argument-hint: "[low|medium|high|extra]"
+allowed-tools: Bash(~/.forget/venv/bin/forget-server recall:*)
+---
+<!-- forget-connect:command v1 — delete this line to keep your edits across upgrades -->
+
+Current dial:
+!`~/.forget/venv/bin/forget-server recall status 2>/dev/null | head -1`
+
+Argument: "$ARGUMENTS"
+
+- If the argument is a gear name (low|medium|high|extra), immediately run
+  `~/.forget/venv/bin/forget-server recall use <gear>` and print only the
+  dial line from its output — no commentary.
+- If there is no argument, use AskUserQuestion to let the user pick a gear
+  (arrow keys). Question: "Recall gear" / header: "recall" / 4 options,
+  appending "(current)" to the label of the current gear:
+  · low — instant search (~0.2s, no LLM)
+  · medium — currently shares low's engine
+  · high — an LLM reads 40 candidates (~3s)
+  · extra — reads 100 candidates in full (~5s)
+  Apply the selection with `recall use` and print only the dial line.
+- Any other argument: answer with one line — "Settings live in /forget-settings".

package/assets/hooks/forget_turnrecall.py

@@ -118,7 +118,9 @@ def main() -> None:
     # possible, but only when the user asks for it — and it says so when it does.
     project = None if scope_disabled() else project_key_for_path(hook_input.get("cwd") or os.getcwd())
     crossed = bool(project) and wants_cross_project(prompt)
-    search_args: dict = {"query": prompt[:300], "top_k": MAX_RECALLS + 2}
+    # Per-turn ambient recall stays on the instant path — the recall dial is
+    # the user's explicit choice, not a tax on every keystroke.
+    search_args: dict = {"query": prompt[:300], "top_k": MAX_RECALLS + 2, "recall": "low"}
     if project and not crossed:
         search_args["filters"] = layered_filter(project)
     result = _rpc("search_memories", search_args)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forget-connect",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "description": "Safely connect Claude Code, Codex, and Claude Desktop to Forget memory.",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -22,11 +22,14 @@ import {
 } from "./core.js";
 import { doctorRemote } from "./doctor.js";
 import {
+  commandsDirFor,
   connectHooksSettings,
   disconnectHooksSettings,
   hooksDirFor,
   inspectHooks,
+  installCommandAssets,
   installHookScripts,
+  removeCommandAssets,
   removeHookScripts,
   settingsPathFor,
 } from "./hooks.js";
@@ -643,9 +646,11 @@ export async function run(argv = process.argv.slice(2), env = process.env) {
     }
     if (manageHooks && options.action === "connect") {
       stdout.write(`Would install hook scripts into ${hooksDir}\n`);
+      stdout.write(`Would install slash commands (/forget, /forget-settings) into ${commandsDirFor({ env })}\n`);
     }
     if (manageHooks && options.action === "disconnect") {
       stdout.write(`Would remove hook scripts from ${hooksDir}\n`);
+      stdout.write(`Would remove our slash commands from ${commandsDirFor({ env })} (user-edited files are kept)\n`);
     }
     return;
   }
@@ -656,6 +661,11 @@ export async function run(argv = process.argv.slice(2), env = process.env) {
     hookScriptPaths = options.action === "connect"
       ? await installHookScripts(hooksDir)
       : await removeHookScripts(hooksDir);
+    const commandsDir = commandsDirFor({ env });
+    const commandPaths = options.action === "connect"
+      ? await installCommandAssets(commandsDir)
+      : await removeCommandAssets(commandsDir);
+    hookScriptPaths = hookScriptPaths.concat(commandPaths);
   }
   const verb = options.action === "connect" ? "Connected" : "Disconnected";
   if (!result.changed.length && !hookScriptPaths.length) {
@@ -677,6 +687,7 @@ export async function run(argv = process.argv.slice(2), env = process.env) {
     }
     if (manageHooks) {
       stdout.write("  hooks: session capsule, per-turn recall, conflict alerts, session capture (needs python3 on PATH)\n");
+      stdout.write("  commands: /forget (the recall dial) · /forget-settings (status, doctor, cloud usage)\n");
     }
     if (options.hosted && !options.scope) {
       stdout.write(

package/src/hooks.js

@@ -258,3 +258,57 @@ export async function removeHookScripts(hooksDir) {
   }
   return removed;
 }
+
+// --- slash commands (/forget, /forget-settings) — the dial in the editor ---
+//
+// Same file-ownership rule as settings.json: a command file without our
+// marker is the user's (hand-written or edited with the marker removed) and
+// is never touched — not on connect, not on disconnect.
+
+export const COMMAND_ASSETS = ["forget.md", "forget-settings.md"];
+export const COMMAND_MARKER = "forget-connect:command";
+
+export function commandsDirFor(options = {}) {
+  const env = options.env ?? process.env;
+  const home = options.home ?? env.HOME ?? env.USERPROFILE ?? os.homedir();
+  return path.join(home, ".claude", "commands");
+}
+
+function commandAssetsDir() {
+  return fileURLToPath(new URL("../assets/commands/", import.meta.url));
+}
+
+export async function installCommandAssets(commandsDir) {
+  const written = [];
+  for (const name of COMMAND_ASSETS) {
+    const target = path.join(commandsDir, name);
+    let existing = null;
+    try {
+      existing = await readFile(target, "utf8");
+    } catch (error) {
+      if (!error || error.code !== "ENOENT") throw error;
+    }
+    if (existing !== null && !existing.includes(COMMAND_MARKER)) continue;
+    const content = await readFile(path.join(commandAssetsDir(), name), "utf8");
+    if (existing === content) continue;
+    await atomicWrite(target, content, 0o644);
+    written.push(target);
+  }
+  return written;
+}
+
+export async function removeCommandAssets(commandsDir) {
+  const removed = [];
+  for (const name of COMMAND_ASSETS) {
+    const target = path.join(commandsDir, name);
+    try {
+      const existing = await readFile(target, "utf8");
+      if (!existing.includes(COMMAND_MARKER)) continue;
+      await unlink(target);
+      removed.push(target);
+    } catch (error) {
+      if (!error || error.code !== "ENOENT") throw error;
+    }
+  }
+  return removed;
+}