@hawkeye-xb.com/imprint-cli 0.1.0 → 0.2.0

package/dist/cli.js

@@ -263,6 +263,68 @@ async function install(args) {
       await installCodex(creds.token, apiBase);
       break;
   }
+  await bootstrapUsageDoc(creds.token, apiBase);
+}
+var USAGE_DOC_PATH = "users/_imprint-usage.md";
+var USAGE_DOC = `# How to use Imprint (auto-seeded)
+
+This file was created by \`imprint install\` on first run as a primer for any AI agent that connects to this user's Imprint memory. Edit or \`rm\` it freely \u2014 it will only be re-seeded if missing.
+
+## Triggers
+
+- **Session start**: run \`ls /\` to see what context exists. Then \`cat\` or \`grep\` anything that might be relevant before asking the user identity questions.
+- **User reveals a preference / decision / constraint**: \`write\` it. Don't wait for explicit "remember this".
+- **Stored memory contradicts current observation**: overwrite or \`rm\` it. Stale memories are worse than missing ones.
+
+## Path taxonomy
+
+- \`users/<topic>.md\` \u2014 identity, working style, preferences, principles
+- \`projects/<name>/<topic>.md\` \u2014 per-project goals, constraints, decisions
+- \`feedback/<topic>.md\` \u2014 corrections received, validated approaches
+- \`references/<topic>.md\` \u2014 pointers to external systems (Linear, Slack, dashboards)
+
+## Entry shape
+
+Lead with the rule or fact in one line, then:
+
+- **Why:** the reason it matters (often a past incident, deadline, or stated preference)
+- **How to apply:** when this should change behavior in future sessions
+
+Knowing *why* lets future agents handle edge cases instead of mechanically following the rule.
+
+## Privacy
+
+Don't persist employer names, work emails, or any identifier that could leak day-job context unless the user has explicitly said it's safe. When in doubt, abstract ("a tech company") or omit.
+`;
+async function bootstrapUsageDoc(token, apiBase) {
+  const url = `${apiBase}/api/v1/memories/${USAGE_DOC_PATH}`;
+  try {
+    const head = await fetch(url, {
+      headers: { Authorization: `Bearer ${token}` }
+    });
+    if (head.status === 200) return;
+    if (head.status !== 404) {
+      console.warn(`  (skipped seeding ${USAGE_DOC_PATH}: HTTP ${head.status})`);
+      return;
+    }
+    const res = await fetch(`${apiBase}/api/v1/memories`, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${token}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({ path: USAGE_DOC_PATH, content: USAGE_DOC })
+    });
+    if (res.ok) {
+      console.log(`\u2713 Seeded ${USAGE_DOC_PATH} (visible on first \`ls /\`)`);
+    } else {
+      console.warn(`  (skipped seeding ${USAGE_DOC_PATH}: HTTP ${res.status})`);
+    }
+  } catch (err) {
+    console.warn(
+      `  (skipped seeding ${USAGE_DOC_PATH}: ${err.message})`
+    );
+  }
 }
 function parseTool(args) {
   const idx = args.indexOf("--tool");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hawkeye-xb.com/imprint-cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
   "description": "Imprint CLI — long-term memory for AI coding tools (Claude Code, Cursor, Codex). Installs the imprint MCP server into your tool's settings file via a browser OAuth flow.",
   "license": "Elastic-2.0",
@@ -23,7 +23,8 @@
     "codex"
   ],
   "bin": {
-    "imprint": "./dist/cli.js"
+    "imprint": "./dist/cli.js",
+    "imprint-cli": "./dist/cli.js"
   },
   "files": [
     "dist",