Skip to content
Pillbox
Pillbox logo Pillbox logo

Pillbox

The persistent memory layer for AI agents — structured, searchable, and built in Rust.
Get started GitHub

Persistent memory

Pills and capsules survive across sessions — your agent picks up where it left off, every time.

Fuzzy search

FTS5 full-text search with Jaro-Winkler fuzzy matching finds context even with typos or partial terms.

Web UI

Review and correct what your agents saved from a local interface. No cloud, no account.

Built in Rust

Single binary, zero runtime dependencies. Works on Linux and macOS.

Git-friendly

The local database lives inside your project directory. Commit .pillbox/ to git and every team member shares the same project memory.

6 languages

CLI and web interface fully localized in English, Spanish, French, German, Italian, and Portuguese. Auto-detected from your system locale.

Quick install

Section titled “Quick install”
Terminal window
curl -fsSL https://raw.githubusercontent.com/Kevinsillo/pillbox/main/install.sh | bash

Then follow the getting started guide.

How it works

Section titled “How it works”

Pillbox organizes knowledge in four layers:

  • Bottles — one per project. Maps a directory to a database.
  • Prescriptions — work sessions within a bottle. One open at a time.
  • Pills — project-specific knowledge saved during a session. Searchable.
  • Capsules — personal, cross-project knowledge. Conventions, preferences, context.

Your agent opens a prescription when it starts work, saves pills as it makes decisions and fixes bugs, and closes the prescription with a summary when done. Next session, it calls pill_context to restore everything.