Skip to content

talocode/memorylane

Repository files navigation

MemoryLane

MemoryLane gives AI agents durable context.

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

npm License


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:

Docs

Talocode ecosystem

Part of Talocode — open-source workflow layers for builders. Explore sibling projects:

Project What it is
ScreenLane Screen-aware voice command layer
Tera AI chat & assistant
Codra Local coding agent
GateLane MCP gateway & agent tool control plane
ContextLane Context ingestion for persistent agents
MemoryLane Persistent agent memory (this repo)
SignalLane X growth intelligence
ReplyLane X reply opportunity intelligence
CrawlerLane Crawler / SEO intelligence
WebDataLane Web extraction to structured data
SearchLane Search layer for agents
InvoiceLane Invoicing tools
GeoLane Geo intelligence
UgcLane UGC workflows
OpenSourceLane Open-source distribution tools
StackLane Builder stack platform
Tradia Trading intelligence
Agent Browser Browser automation for agents
Talocode Org home & control plane
Skills Shared agent skills
X Agent X automation agent
LaunchPix Launch tooling
ForgeCAD CAD workflows
WorkLane Work automation
ClipLoop Clip / video loops

MCP-compatible agents integrate via each product's MCP server where available (Model Context Protocol).

More: github.com/talocode · talocode.site · docs.talocode.site

License

MIT

About

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

Topics

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors