Palimnex

Palimnex is a repository-local memory system for coding agents. It combines a rebuildable Redis source-discovery cache with a durable SQLite historical ledger, encrypted portable packs, evidence-aware retrieval, and explicit retention and authorized-erasure controls.

This repository is the independent continuation of the portable Project Memory bundle originally developed inside btc-usdt-atomic-swap. Product-facing development now belongs here. No live Redis data, SQLite ledger, credentials, wallet material, atomic-swap implementation, or repository-specific rollback snapshot was copied.

The Python distribution version is 2.8.1, with public SDK and extension API v1. Version 2.8.0 adds a replicable palimnex:audit-graph:v1 export and an optional Semantica projector that copies that graph as untrusted history with TTL disabled and fail-closed erasure receipts. See the SDK guide for installation, typed interfaces, source resolvers, derivative adapters, signed checkpoints, the audit graph, optional Semantica projection, pack identity and MCP.

Use Palimnex in your repository

Install the exact published release from PyPI:

pipx install "palimnex[crypto]==2.8.1"

Or install the same release directly from its Git tag:

pipx install "palimnex[crypto] @ git+https://github.com/EdwinKestler/palimnex@v2.8.1"

Before the first run, add .palimnex/, *.pmem and *.key to the repository's .gitignore so the durable ledger and keys are never committed. In 2.8.0 and later, palimnex init --write does this and writes the configuration, palimnex redis start starts the guarded Redis, and palimnex doctor checks the installation. The installation guide covers configuration, Redis, first run, agent instructions and uninstall; the upgrade guide covers moving between versions.

Quick start (this repository)

Requirements are Python 3.11+, Redis server/CLI for cache-backed integration, and the distribution cryptography package for encrypted packs and signatures. Install development dependencies with python3 -m pip install -e '.[test,mcp]' inside a virtual environment to run the full gate, including MCP integration.

./scripts/palimnex_redis.sh start
python3 palimnex.py status
python3 palimnex.py index --incremental
python3 palimnex.py validate --deep
python3 palimnex.py evaluate --limit 5
python3 palimnex.py ledger-init
python3 palimnex.py ledger-status
python3 palimnex.py audit-graph

ledger-init is a one-time local write that creates the durable ledger; ledger-status exits 2 and audit-graph fails until it exists.

Run the standalone gate with:

./scripts/palimnex_check.sh

Repository source is authoritative. Cache and ledger results are discovery or historical evidence, never authorization to execute external actions.

Layout

• palimnex.py — repository-root CLI.
• palimnex/ — engine, schemas, fixtures, and tests.
• docs/ — design, operations, retention, SDK contracts, and the Pages site.
• scripts/palimnex_redis.sh — owner-only Unix-socket Redis launcher.
• .palimnex.json — this repository's safe local configuration.
• LICENSE — MIT license.
• .github/workflows/palimnex-check.yml — CI for the standalone gate.
• docs/index.html — dependency-free GitHub Pages architecture site.

See the installation guide, the upgrade guide, the SDK guide, the operator runbook, retention policy, compatibility policy, maintainer initialization prompt, and extraction record.

The Pages source can be previewed locally and published from docs/ by an authorized maintainer. See the Pages guide for the workflow and branch-source options.

Safety boundary

Palimnex never forgets durable data automatically. Cleanup is a separate, authorized transaction that resolves derivatives, enforces holds, removes eligible local content and indexes, recomputes dependent facts, verifies local stores, and writes a non-reconstructive audit tombstone. Optional Semantica copies of the audit graph are untrusted projections: retention_days must be None, and a mandatory store that reports not_configured, unsupported, or failed fails the adapter apply. It does not claim forensic deletion from SSDs, backups, snapshots, third-party systems, or unmanaged exported copies.

License

Palimnex is released under the MIT License. See LICENSE.