ai-memory

Summary

Solution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors

Command line

Values are placeholders taken from each option’s declared default. Nothing is executed here — the output shown is a recording of a run that already happened.

Release history

1. v1.34.0 Aug 28, 2026 · issue 009

   ai-memory v1.34.0 adds a dedicated EMBEDDING_API_KEY, a generic external-conversation importer with --apply, and the workstreams subcommand.

   └──▷ GET THIS VERSION
   copy

   $ git clone --branch v1.34.0 https://github.com/akitaonrails/ai-memory.git
   # already have the repo? check out this version:
   $ git checkout v1.34.0

   └──▷ TRY IT
   List recent managed workstreams for the current checkout in machine-readable form to feed into scripts or dashboards.
   copy

   $ ai-memory workstreams --json

   Import an external conversation export into the pipeline, committing it after a dry-run review.
   copy

   $ ai-memory-importer conversation.json --apply

   • ›Adds EMBEDDING_API_KEY environment variable as an optional embedding-only credential resolved ahead of OPENAI_API_KEY and LLM_API_KEY, letting openai and openai-compat embedding providers use a separate key from the chat model; resolution order for openai is EMBEDDING_API_KEY → OPENAI_API_KEY → LLM_API_KEY (last only with a custom base URL), and for openai-compat is EMBEDDING_API_KEY → LLM_API_KEY.
   • ›Adds ai-memory workstreams subcommand for a read-only checkout-local list of recent managed workstreams with the current selection first, linked harnesses, timestamps, and stable ids; supports human-readable and --json output.
   • ›The ai-memory-importer companion can now replay bounded generic external-conversation JSON into the observation/consolidation pipeline; dry-run by default, --apply sends one ordered /hook/batch with the external-import wire identity, with stable session/event idempotency keys, event/byte caps, and a durable partial-failure manifest for safe resumption of interrupted imports.
2. v1.33.0 Aug 28, 2026 · issue 009

   Session pages now expose originating agent as agent frontmatter, surviving LLM rewrites and compaction checkpoints.

   └──▷ GET THIS VERSION
   copy

   $ git clone --branch v1.33.0 https://github.com/akitaonrails/ai-memory.git
   # already have the repo? check out this version:
   $ git checkout v1.33.0

   • ›Generated sessions/<id>.md pages now include an agent frontmatter field alongside session_id, recording the originating harness so that LLM rewrites, compaction checkpoints, spool drains, and superseding versions cannot overwrite the origin attribution; manual page writes remain unattributed.