MemoryLane

MemoryLane gives AI agents durable context.

Agent-native memory layer for persistent context, semantic recall, session history, SDK, CLI, API, and MCP.

---

Install

npm install -g @talocode/memorylane

Or run directly:

npx @talocode/memorylane demo

Quick Start

# Save a memory
memorylane remember "User prefers short, direct X posts" --tag writing --tag preference

# Recall it later
memorylane recall "How should I write X posts?"

# Search memories
memorylane search "Talocode"

# List everything
memorylane list

# Run interactive demo
memorylane demo

CLI

memorylane --version
memorylane --help

# Core commands
memorylane remember <text> [--tag ...] [--importance N] [--session id]
memorylane recall <query> [--limit N] [--tags ...]
memorylane search <query> [--limit N] [--tags ...]
memorylane list [--limit N] [--tag ...]
memorylane get <id>
memorylane delete <id>
memorylane clear --yes

# Sessions
memorylane sessions create --title "My Session"
memorylane sessions list
memorylane sessions show <sessionId>

# Import/Export
memorylane export --out export.json
memorylane import export.json

# Server
memorylane serve --port 3040

# MCP
memorylane mcp

# Diagnostics
memorylane doctor
memorylane demo

API

Start the server:

memorylane serve --port 3040

Endpoints

Method	Path	Description
GET	/health	Health check
GET	/v1/memorylane/health	API health check
GET	/v1/memorylane/capabilities	List available endpoints
POST	/v1/memorylane/memories	Save a memory
GET	/v1/memorylane/memories	List memories
GET	/v1/memorylane/memories/:id	Get a memory
DELETE	/v1/memorylane/memories/:id	Delete a memory
POST	/v1/memorylane/recall	Recall memories
POST	/v1/memorylane/search	Search memories
POST	/v1/memorylane/sessions	Create a session
GET	/v1/memorylane/sessions	List sessions
GET	/v1/memorylane/sessions/:id	Get session with memories
POST	/v1/memorylane/export	Export all data
POST	/v1/memorylane/import	Import data

Example

curl -X POST http://localhost:3040/v1/memorylane/memories \
  -H "Content-Type: application/json" \
  -d '{"text": "User prefers short posts", "tags": ["writing", "preference"], "importance": 8}'

curl -X POST http://localhost:3040/v1/memorylane/recall \
  -H "Content-Type: application/json" \
  -d '{"query": "How should I write?", "limit": 5}'

SDK

import { MemoryLaneClient } from "@talocode/memorylane";

const memory = new MemoryLaneClient({ baseUrl: "http://localhost:3040" });

await memory.remember({
  text: "User prefers short posts",
  tags: ["writing", "preference"],
  importance: 8,
});

const results = await memory.recall({
  query: "How should I write?",
  limit: 5,
});

MCP

Add to your MCP config:

{
  "mcpServers": {
    "memorylane": {
      "command": "memorylane",
      "args": ["mcp"]
    }
  }
}

Available tools: memorylane_remember, memorylane_recall, memorylane_search, memorylane_list_memories, memorylane_create_session, memorylane_list_sessions, memorylane_export, memorylane_import.

Cloud Auth

Local usage is open-source and keyless. For Talocode Cloud API access, set:

export TALOCODE_API_KEY="your-key"
export MEMORYLANE_CLOUD_MODE=true

Install Options

• npm: npm install -g @talocode/memorylane
• npx: npx @talocode/memorylane
• Linux/macOS: curl -fsSL https://raw.githubusercontent.com/talocode/memorylane/main/install.sh | bash
• Windows: iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/talocode/memorylane/main/install.ps1'))
• Android (Termux): pkg install nodejs && npm install -g @talocode/memorylane

Examples

See the examples directory:

• Basic Agent Memory
• Session Recall
• MCP Agent Memory

Docs

• API Reference
• CLI Reference
• SDK Reference
• MCP Reference
• Cloud Auth
• Install Guide

License

MIT