janitorr/mittens repository overview

⁠Mittens — Agent Ledger

Persistent structured memory for AI agents. Gives LLMs a queryable ledger that survives context windows, accessible via MCP and REST.

⁠Quick Start

docker run -d -p 5070:5070 -v mittens-data:/app/data janitorr/mittens:latest

Or with docker compose:

services:
  mittens:
    image: janitorr/mittens:latest
    ports:
      - "5070:5070"
    volumes:
      - mittens-data:/app/data

Server starts at http://localhost:5070⁠. MCP endpoint at /mcp.

⁠Features

• Six MCP tools: mittens_list, mittens_get, mittens_search, mittens_set, mittens_update, mittens_delete
• REST API at /api/memory
• SQLite persistence — survives restarts, zero config
• Native AOT binary — instant startup, ~33 MB, no .NET runtime
• Conflict resolution by confidence score

⁠Links

• GitHub: https://github.com/janitorr/mittens⁠
• Setup guide: https://github.com/janitorr/mittens/blob/main/setup/SETUP.md⁠