@cortexmemory/cli 0.1.1 → 0.22.0

package/templates/basic/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "0.1.1",
+  "description": "AI agent with Cortex Memory SDK",
+  "type": "module",
+  "scripts": {
+    "dev": "node dev-runner.mjs",
+    "build": "tsc && npm run build:convex",
+    "build:convex": "convex deploy",
+    "start": "tsx --env-file=.env.local src/index.ts"
+  },
+  "dependencies": {
+    "@cortexmemory/sdk": "latest",
+    "convex": "^1.31.2",
+    "dotenv": "^17.2.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "typescript": "^5.9.3",
+    "tsx": "^4.21.0"
+  }
+}

package/templates/basic/src/index.ts

@@ -0,0 +1,85 @@
+/**
+ * Cortex Memory SDK - Getting Started
+ *
+ * This is a simple example to get you started with Cortex.
+ * Your AI agent now has persistent memory!
+ *
+ * Note: This is a template file. TypeScript errors about missing '@cortexmemory/sdk'
+ * are expected and will be resolved when dependencies are installed in your project.
+ */
+
+import { Cortex } from "@cortexmemory/sdk";
+
+// Initialize Cortex with your Convex deployment
+const cortex = new Cortex({
+  convexUrl: process.env.CONVEX_URL!,
+});
+
+async function main() {
+  console.log("🧠 Cortex Memory SDK - Example");
+  console.log("================================\n");
+
+  // Define your memory space (isolation boundary)
+  const memorySpaceId = "my-first-agent";
+  const conversationId = "conversation-1";
+
+  try {
+    // Store a memory (remember() auto-creates conversation if needed!)
+    console.log("💾 Storing a memory...");
+    await cortex.memory.remember({
+      memorySpaceId,
+      conversationId,
+      userMessage: "I prefer dark mode and TypeScript",
+      agentResponse: "Got it! I'll remember your preferences.",
+      userId: "user-123",
+      userName: "User",
+    });
+    console.log("✓ Memory stored!\n");
+
+    // Search for memories
+    console.log("🔍 Searching memories...");
+    const results = await cortex.memory.search(
+      memorySpaceId,
+      "what are the user preferences?",
+    );
+
+    console.log(`✓ Found ${results.length} relevant memories:`);
+    results.forEach((result: any, i: number) => {
+      // Handle both MemoryEntry and EnrichedMemory formats
+      const memory = "memory" in result ? result.memory : result;
+      console.log(`\n${i + 1}. ${memory.content}`);
+      console.log(`   Importance: ${memory.importance}`);
+    });
+
+    // Get conversation history
+    console.log("\n📜 Getting conversation history...");
+    const conversation = await cortex.conversations.get(conversationId);
+
+    if (conversation) {
+      console.log(
+        `✓ Conversation has ${conversation.messages.length} messages`,
+      );
+    }
+
+    console.log("\n🎉 Success! Your AI agent has persistent memory.");
+    console.log("\n📚 Next steps:");
+    console.log(
+      "   - Explore the API: https://github.com/SaintNick1214/Project-Cortex",
+    );
+    console.log("   - Add vector embeddings for semantic search");
+    console.log("   - Set up graph database for advanced queries");
+    console.log("   - Build multi-agent systems with context chains\n");
+  } catch (error) {
+    console.error("❌ Error:", error);
+    throw error;
+  } finally {
+    // Cleanup
+    cortex.close();
+  }
+}
+
+// Run the example
+main().catch((error) => {
+  console.error("Fatal error:", error);
+  process.exit(1);
+});

package/templates/basic/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ES2022",
+    "lib": ["ES2022"],
+    "moduleResolution": "node",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "convex"]
+}