KnowledgeMay 13, 2026·2 min read

Wax — Single-File Memory Layer for AI Agents

Wax stores documents, embeddings, and knowledge in one portable `.wax` file, giving AI agents a local memory layer without extra servers.

Agent ready

Ready-to-run agent install

This asset can be installed after the agent chooses its runtime, checks the plan, and runs the matching command.

Native · 96/100Policy: allow
Agent surface
Any MCP/CLI agent
Kind
Knowledge
Install
Single
Trust
Trust: Established
Entrypoint
Asset
Direct install command
npx -y tokrepo@latest install f9414227-7fdc-5800-ab65-8810510db043 --target codex

Run after dry-run confirms the install plan.

Intro

Wax stores documents, embeddings, and knowledge in one portable .wax file, giving AI agents a local memory layer without extra servers.

Best for: Apple-platform teams that want local RAG-style memory and portability without running a separate database fleet

Works with: Swift projects, Apple Silicon, local AI workflows, document and embedding persistence, file-based memory transport

Setup time: 10-15 minutes

Key facts (verified)

  • GitHub: 731 stars · 42 forks · pushed 2026-05-13.
  • License: Apache-2.0; owner avatar verified from GitHub API for christopherkarani.
  • Entry point checked from README: swift package resolve.

Main

Wax matters because it shrinks the operational surface area of memory. Instead of keeping separate stores for documents, vectors, and metadata, you move one file.

That makes it attractive for local-first agent workflows, demo environments, and Apple-centric products where portability and low ceremony matter more than cluster scale.

The README framing is especially useful for engineering decisions: choose Wax when your bottleneck is setup and portability, not when you need a large distributed serving tier.

Source-backed notes

  • README defines Wax as a Swift-native persistence engine for AI agents.
  • The core packaging idea is one portable .wax file containing documents, metadata, and indexes.
  • README positions it as local-first memory tuned for Apple Silicon rather than a server-based vector stack.

FAQ

Q: Is Wax a hosted vector database? A: No. It is designed as a portable local memory engine centered on a single file.

Q: Why is the file model important? A: Backup, copy, and transport become simpler because documents and indexes travel together.

Q: Who should evaluate it first? A: Swift and Apple Silicon teams building local-first agent or retrieval features.

🙏

Source & Thanks

Source: https://github.com/christopherkarani/Wax > License: Apache-2.0 > GitHub stars: 731 · forks: 42

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets