Newshot

Show HN: Woolly, a local mem0-compatible memory API for AI agents

Original text(via HN AI)

Why Woolly

Every AI coding tool starts from zero. You explain your stack to Cursor, then again to Claude Code, then to Codex. Each keeps its own memory, or none, and none of them know what you decided yesterday or what your teammate’s agent learned this morning.

Woolly is the memory they share. It’s one folder on your laptop, plain Markdown, with no cloud and no account. Any tool that speaks MCP can save to it and search it, and woolly proxy gives the same memory to Ollama and any app that uses the OpenAI or Anthropic API.

When a session starts, your agent gets your profile, the project’s notes and where you left off. When it ends, Woolly saves what you decided and why.

The agents you build get the same memory. Send a conversation to the memory API and a local model decides what’s new, what changed and what’s no longer true, per user. While you’re away, Woolly dreams. It tidies what it knows and learns lessons from your sessions.

What it does

  • Sessions that start warm.Claude Code opens every session with your profile, the project’s notes and a handoff from last time. Nobody has to say “here’s my stack” again.

Sessions that start warm.

Claude Code opens every session with your profile, the project’s notes and a handoff from last time. Nobody has to say “here’s my stack” again.

  • Decisions stick.When a session ends, Woolly saves what you chose, why, and what you ruled out. No agent pitches the rejected option again.

Decisions stick.

When a session ends, Woolly saves what you chose, why, and what you ruled out. No agent pitches the rejected option again.

  • Agents that remember.Give the agents you build a memory with an API shaped like mem0’s. For each fact a local model decides whether it’s new, an update, or no longer true, and every user’s memories stay apart.

Agents that remember.

Give the agents you build a memory with an API shaped like mem0’s. For each fact a local model decides whether it’s new, an update, or no longer true, and every user’s memories stay apart.

  • It dreams.While you’re away, Woolly merges duplicates, settles facts that changed, and turns your past sessions into lessons for the next one.

It dreams.

While you’re away, Woolly merges duplicates, settles facts that changed, and turns your past sessions into lessons for the next one.

  • Facts keep their history.A newer fact replaces the old one, which stays on disk with the time it stopped being true. When an AI guesses something that contradicts you, your version wins and the guess waits for your review.

Facts keep their history.

A newer fact replaces the old one, which stays on disk with the time it stopped being true. When an AI guesses something that contradicts you, your version wins and the guess waits for your review.

  • Memory you can readEvery memory is a Markdown file. Open it, grep it, fix it by hand, and see which tool saved it. The Woolly app shows the same thing with search.

Memory you can read

Every memory is a Markdown file. Open it, grep it, fix it by hand, and see which tool saved it. The Woolly app shows the same thing with search.

  • One project memory for the team.woolly init keeps the repo’s stack, conventions and gotchas in .woolly/woolly.md. Commit it, and every teammate’s agent reads and updates the same notes.

One project memory for the team.

woolly init keeps the repo’s stack, conventions and gotchas in .woolly/woolly.md. Commit it, and every teammate’s agent reads and updates the same notes.

Build agents that remember

The same calls as mem0, answered by your own machine. Install the package, add a conversation for a user, and search before your agent replies.


        import { Woolly } from 'woolly-ai';

const w = new Woolly();

await w.add('I just moved to Austin', { userId: 'alice' });
// [{ memory: 'Lives in Austin', event: 'UPDATE', previous_memory: 'Lives in Denver' }]

const memories = await w.search('where does she live?', { userId: 'alice' });
      

Our promise is memory you can check, not a number you have to trust.

LOCOMO benchmark

382 questions over the first three conversations, searched on a laptop with nomic-embed-text. No hosted model and no API key. Run the same test yourself.

Woolly runs where your code does, with no cloud at all.

It’s one binary with no outside dependencies. Install it on your laptop, sync it to your other machines, or commit the project’s memory so your team shares it.

  • On your laptopMac, Windows and Linux. One small binary, or the app.

On your laptop

Mac, Windows and Linux. One small binary, or the app.

  • On a Raspberry PiSync your machines over your own network, encrypted.

On a Raspberry Pi

Sync your machines over your own network, encrypted.

  • In your repoProject memory in git, shared with your whole team.

In your repo

Project memory in git, shared with your whole team.

Private by design.

Woolly refuses passwords and API keys, and an AI can’t plant instructions in your memory. Lines that come from a repo are checked for secrets and injected instructions before any agent sees them.

  • No accountNothing to sign up for.

Nothing to sign up for.

  • No cloudYour memory never leaves your machines.

Your memory never leaves your machines.

  • No telemetryWoolly never phones home.

Woolly never phones home.

Shipping weekly

Built in public, one release at a time. Here’s what landed lately.

  • v0.14.1Nov 17Search by meaning is more accurate. Woolly now gives nomic-embed-text the search and document prefixes it was trained with (and the query prefix mxbai-embed-large expects).
  • v0.14.0Nov 17A memory layer API for the agents you build, with mem0's routes and field names: POST /v1/memories turns a conversation into memories, and POST /v1/search finds them.
  • v0.13.1Nov 13A Windows app. Download Woolly-windows.exe, run it, and Woolly starts in the background with an icon in the system tray.
  • v0.13.0Nov 13Project memory in git: woolly init. A repo's memory lives in .woolly/woolly.md, one fact per line under Overview, Stack, Conventions, Decisions, Gotchas and Commands, so every teammate's agent reads and updates the same notes.

Questions

Still have a question? Ask on GitHub.

The text above was extracted automatically from the source page and may miss images, tables or code blocks. The original is authoritative.

Published by HN AI
This site only summarises and aggregates; copyright stays with the original author. Headlines and summaries follow the source — where they differ, the original wins.
Read the original ↗