capsule-memory README

The project's README from github.com/unicity-aos/capsule-memory. As one markdown file: README.md.

astrid-capsule-memory

License: MIT OR Apache-2.0 MSRV: 1.94

Cross-session memory for Astrid OS agents.

In the OS model, this capsule is the persistent swap file. It carries context across session boundaries so the agent remembers what happened last time.

How it works

Hooks into prompt_builder.v1.hook.before_build. On each prompt assembly cycle:

  1. Reads .astrid/memory.md from the workspace via the VFS
  2. Wraps the content in a # Memory section
  3. Publishes an appendSystemContext hook response on the per-request response topic

If the file is missing or empty, the capsule is a no-op.

Size cap

Agent-written content can grow without limit (unlike human-authored AGENTS.md), so a 32KB hard cap prevents unbounded context window consumption. Content beyond the limit is truncated at a UTF-8 character boundary with a [Memory truncated] marker.

Read-only

This capsule handles the read/inject side only. The agent writes to .astrid/memory.md using existing filesystem tools (write_file, replace_in_file) from astrid-capsule-fs. No new tools needed.

Development

cargo build --target wasm32-unknown-unknown --release

License

Dual-licensed under MIT and Apache 2.0.

Copyright (c) 2025-2026 Joshua J. Bouw and Unicity Labs.

capsule-memory (unicity-aos/capsule-memory)

Searching Database…

Что это такое?Это 'капсула' (плагин) для агентов Astrid OS / Unicity AOS, которая даёт им память между сессиями: она читает локальный файл памяти из рабочей папки и вставляет его содержимое в системный промпт, чтобы агент помнил, что происходило в предыдущих сессиях.
Это самостоятельное приложение или плагин для чего-то большего?Это небольшой модуль-хук на Rust ('капсула'), который подключается к конвейеру сборки промптов Astrid OS. Он работает только как часть большой платформы агентов Unicity AOS и сам по себе не запускается.
Как это запустить?Отдельной установки не требуется: на каждом цикле сборки промпта капсула автоматически читает '.astrid/memory.md' из рабочей папки через VFS, оборачивает содержимое в раздел '# Memory' и отправляет ответ хука appendSystemContext.
Нужны ли для работы другие капсулы Astrid OS?Да. Эта капсула только читает память, а запись в '.astrid/memory.md' выполняется через инструменты работы с файлами (writefile, replaceinfile), которые предоставляет отдельная капсула astrid-capsule-fs.
Есть ли ограничение на объём памяти, который можно вставить?Да, содержимое жёстко ограничено 32 КБ, чтобы не переполнять контекстное окно. Всё, что выходит за пределы, обрезается по границе символа UTF-8 и помечается уведомлением об обрезке.
Для кого предназначена эта капсула?Для разработчиков, которые создают или дорабатывают агентов на Astrid OS / Unicity AOS и хотят, чтобы их агенты сохраняли контекст между сессиями.
Что такое Astrid OS / Unicity AOS?Это фреймворк операционной системы для агентов. Этот проект — одна из нескольких модульных 'капсул', которые дают ИИ-агентам базовые возможности, похожие на ОС (файловая система, память и т.д.). Эта капсула выступает в роли файла подкачки для контекста.
Что будет, если memory.md ещё не существует?Капсула просто ничего не делает и не вставляет ничего в промпт, пока файл не появится и не будет содержать текст.
Почему бы не использовать файл памяти в стиле AGENTS.md, который пишет человек?Потому что содержимое, которое пишет агент, может расти без ограничений, в отличие от AGENTS.md, написанного человеком. Поэтому капсула вводит жёсткий лимит 32 КБ, чтобы контекстное окно оставалось ограниченным.
Size
0.1 MB
Stars
8.4K
Age
7mo
Commits · 90 Days