Install

Choose the surface that matches what you are building.

Codex and Claude Code

Download FishMem Desktop for macOS (Universal DMG). The signed and notarized build supports Apple silicon and Intel Macs on macOS 13.4 or newer. The ZIP archive and release manifest with SHA-256 checksums are also available.

Install and open FishMem Desktop, then select Connect to Codex or Connect to Claude Code. Desktop installs:

• the local fishmem command;
• a host-specific FishMem Skill;
• the connection metadata needed to reach the local Desktop service.

No MCP server is required. The Skill tells the agent when to remember and recall; the CLI provides the small, deterministic command surface.

After connecting, restart the agent and ask:

Remember that this project uses pnpm and TypeScript strict mode.

Then start a new session and ask:

What project conventions do you remember?

Codex and Claude Code are the supported Desktop integrations.

Application SDK

npm install @fishmem/sdk

import { FishMem } from "@fishmem/sdk";

const fishmem = new FishMem({
  apiKey: process.env.FISHMEM_API_KEY!,
  // baseUrl: "https://memory.example.com", // self-hosted
});

await fishmem.memories.add({
  content: "Alex prefers concise answers.",
  user_id: "alex",
});

The same package runs on Node.js, Bun, Deno, Cloudflare Workers, and Vercel. See the SDK quickstart.

Python applications use the same API:

pip install fishmem

from fishmem import FishMem

fishmem = FishMem(api_key="fm_...")

See the Python SDK guide.

Direct REST API

curl https://fishmem.com/v1/memories \
  -H "Authorization: Bearer $FISHMEM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content":"Alex prefers concise answers.","user_id":"alex"}'

Use your own instance URL when self-hosting. See the API reference for every endpoint.

Embedded TypeScript engine

Use the lower-level fishmem package when the engine must run inside your process:

npm install fishmem

This path exposes storage, LLM, embedder, and retrieval configuration directly. It is separate from @fishmem/sdk, which calls the FishMem service over HTTP.

Self-hosted service

Self-hosting includes the REST API and web dashboard. Follow the self-hosting guide, then pass your deployment URL as the SDK baseUrl.