End-to-End Memory Walkthrough

This walkthrough covers the full memory lifecycle — create, search, update, and delete — using the four LanOnasis surfaces that genuinely exist today:

TypeScript SDK — @lanonasis/memory-client
curl / REST API — the platform HTTP endpoints
MCP — Model Context Protocol tools
CLI — @lanonasis/cli

All examples were run against a local mock/sandbox API so they are safe to copy and adapt. No real API keys, secrets, or production data are shown.

Prerequisites

Surface	Install / Setup
TypeScript	`npm install @lanonasis/memory-client`
curl	Any HTTP client; `curl` is used here.
MCP	An MCP client (Claude Desktop, Cursor, or the LanOnasis CLI `mcp` command).
CLI	`npm install -g @lanonasis/cli`

Start a local sandbox before running the examples. If you are working from the LanOnasis monorepo, bun run dev starts the local API used below.

Use a local base URL and placeholder credentials in every example by default. Only switch to production explicitly when you are ready to point at a live environment:

LANONASIS_API_URL=http://localhost:3000/api/v1
LANONASIS_API_KEY=lns_test_xxxxxxxxxxxxxxxx

For production, replace LANONASIS_API_URL with https://api.lanonasis.com/api/v1 and use a real user-scoped token or API key from the appropriate environment.

1. TypeScript SDK

Use the browser-safe core client in frontends, and the Node entry point when you want CLI/MCP-aware behavior on the server.

import { createMemoryClient } from '@lanonasis/memory-client/core';

const accessToken = await getAccessTokenFromYourBackend();

const client = createMemoryClient({
  apiUrl: 'http://localhost:3000',
  authToken: accessToken,
});

// In browsers, inject runtime config or a short-lived user token from your
// backend/session layer. Do not embed long-lived server API keys in client code.

import { createNodeMemoryClient } from '@lanonasis/memory-client/node';

const client = await createNodeMemoryClient({
  apiUrl: process.env.LANONASIS_API_URL || 'http://localhost:3000',
  apiKey: process.env.LANONASIS_API_KEY,
});

// 1. Create
const created = await client.createMemory({
  title: 'Q4 Planning Notes',
  content: 'We decided to prioritise the SDK matrix and the MCP tooling before the end of the quarter.',
  memory_type: 'project',
  tags: ['planning', 'q4', 'sdk']
});
console.log('Created:', created.data?.id);

// 2. Search
const found = await client.searchMemories({
  query: 'SDK matrix priorities',
  limit: 5,
  threshold: 0.7
});
console.log('Search hits:', found.data?.total_results);

// 3. Update (using the id from the create step)
const memoryId = created.data?.id;
if (memoryId) {
  const updated = await client.updateMemory(memoryId, {
    title: 'Q4 Planning Notes (updated)',
    tags: ['planning', 'q4', 'sdk', 'walkthrough']
  });
  console.log('Updated:', updated.data?.id);

  // 4. Delete
  const deleted = await client.deleteMemory(memoryId);
  console.log('Deleted:', deleted.data ?? deleted.message);
}

Expected output (local mock):

Created: mem_01j5m2xz3abcdef
Search hits: 1
Updated: mem_01j5m2xz3abcdef
Deleted: Memory deleted successfully

2. curl / REST API

The REST API is the canonical contract every SDK and tool uses. Replace lns_test_... with your own API key.