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

This asset can be read and installed directly by agents

TokRepo exposes a universal CLI command, install contract, metadata JSON, adapter-aware plan, and raw content links so agents can judge fit, risk, and next actions.

Native · 94/100Policy: allow
Agent surface
Any MCP/CLI agent
Kind
Cli
Install
Swift
Trust
Trust: Established
Entrypoint
swift package resolve
Universal CLI install command
npx tokrepo install f9414227-7fdc-5800-ab65-8810510db043
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