Wax

Overview

Wax is a high-performance, single-file memory layer for AI agents on Apple platforms. It stores documents, embeddings, and structured knowledge in a single portable .wax file. Designed for sub-millisecond recall latency with hybrid search capabilities (text + vector), it operates entirely on-device without server or cloud dependencies. The implementation leverages Metal acceleration for vector search and SQLite FTS5 for text search, making it particularly optimized for Apple Silicon hardware.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• handoff_latest

  Load prior context from previous sessions

  Try:Load my previous session contextTry:Get the latest handoff
• session_start

  Start a new memory session

  Try:Start a new sessionTry:Initialize a fresh session
• remember

  Store memories, facts, and decisions

  Try:Remember that I'm working on a SwiftUI habit trackerTry:Store this important fact about our project
• recall

  Retrieve assembled context from memory

  Try:Recall what we discussed about API designTry:Get the context about our earlier decisions
• search

  Perform hybrid or text-only search in memory

  Try:Search for information about authenticationTry:Find documents related to performance optimization
• handoff

  Pass session content with optional project and pending tasks

  Try:Handoff my current work progressTry:Save session with remaining tasks
• session_end

  End the current memory session

  Try:End the current sessionTry:Finalize this session
• corpus_search

  Search across broker-managed session history

  Try:Search across all previous sessionsTry:Find information from past project sessions
• entity_upsert

  Insert or update structured entities

  Try:Add a new entity for the user profileTry:Update the company entity information
• fact_assert

  Assert a structured fact

  Try:Add a fact that the user prefers SwiftTry:Record that the project deadline is next month
• fact_retract

  Remove a structured fact

  Try:Retract the fact that the deadline was last monthTry:Remove outdated information about the API
• facts_query

  Query structured facts

  Try:Find facts about the user's preferencesTry:Get all facts related to project deadlines

Comparable tools

Installation

dependencies: [
    .package(url: "https://github.com/christopherkarani/Wax.git", from: "0.1.8")
]

npx -y waxmcp@latest mcp install --scope user

{
  "mcpServers": {
    "wax": {
      "command": "wax-mcp",
      "args": []
    }
  }
}

FAQ

What platforms does Wax support?

Wax supports iOS and macOS, optimized for Apple Silicon (M-series) processors.

How does Wax ensure data privacy?

Wax operates entirely on-device with no server or cloud dependencies, ensuring 100% local data privacy.

On Hacker News

Recent discussion from the developer community.

• Sub-Millisecond RAG on Apple Silicon. No Server. No API. One File▲ 130💬 39
  Story by ckarani · 2026-02-17
• Show HN: Wax – RAG in a single file (SQLite for AI memory)▲ 2
  Story by karc14 · 2026-02-13

Compare Wax with