unicity-aos/capsule-memoryPublic

What is capsule-memory?

A cross-session persistent memory capsule for Astrid OS agents to maintain contextual awareness.

What does capsule-memory do?

Capsule Memory acts as a dedicated persistent swap file and memory module for autonomous agents operating within the Astrid OS environment. Its core function is to bridge the gap between distinct session boundaries, allowing an agent to remember crucial context, preferences, and project states from previous interactions. It achieves this by automatically hooking into the prompt assembly process, reading a local Markdown file via the Virtual File System, and injecting its contents as system context before the agent formulates a response. The capsule enforces a strict 32KB size limit to prevent unbounded context window consumption, relying entirely on the agent itself to write updates to this storage file using standard tools.

Who is capsule-memory for?

Developers and AI researchers building stateful, long-running autonomous agents within the Astrid OS ecosystem who require robust, transparent memory persistence.

How do I get started with capsule-memory?

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

How popular is capsule-memory on GitHub?

unicity-aos/capsule-memory has 8,442 stars and 20 forks on GitHub, and gained -4 stars in the last 7 days.

What license does capsule-memory use?

unicity-aos/capsule-memory is released under the Apache-2.0 license.

• Permissive license

  Apache-2.0

• Continuous integration

  Automated checks passing

Capsule Memory acts as a dedicated persistent swap file and memory module for autonomous agents operating within the Astrid OS environment. Its core function is to bridge the gap between distinct session boundaries, allowing an agent to remember crucial context, preferences, and project states from previous interactions. It achieves this by automatically hooking into the prompt assembly process, reading a local Markdown file via the Virtual File System, and injecting its contents as system context before the agent formulates a response. The capsule enforces a strict 32KB size limit to prevent unbounded context window consumption, relying entirely on the agent itself to write updates to this storage file using standard tools.

Developers and AI researchers building stateful, long-running autonomous agents within the Astrid OS ecosystem who require robust, transparent memory persistence.

• Cross-Session Context: Persist agent memory and operational context continuously across multiple independent session boundaries.
• Automated Prompt Injection: Seamlessly hook into the `prompt_builder.v1.hook.before_build` lifecycle to inject stored memory into the system prompt.
• Strict Context Capping: Enforce a hard 32KB limit on the memory file, truncating excess content to prevent out-of-memory context window errors.
• File-System Storage Layer: Utilize a transparent `.astrid/memory.md` file within the Virtual File System for simple, inspectable data storage.
• Read-Only Architecture: Handle only the retrieval and injection phase, explicitly forcing the agent to utilize standard filesystem tools to modify its own memory.

Getting started: cargo build --target wasm32-unknown-unknown --release

1. v0.2.0v0.2.0Jul 9, 202652 downloads

   ## What's Changed * chore: release 0.2.0 by @joshuajbouw in https://github.com/unicity-astrid/capsule-memory/pull/22 **Full Changelog**: https://github.com/unicity-astrid/capsule-memory/compare/v0.1.0...v0.2.0

2. v0.1.0v0.1.0Jun 14, 202643 downloads

   ## What's Changed * fix(deps): resolve astrid-sdk from crates.io registry by @joshuajbouw in https://github.com/unicity-astrid/capsule-memory/pull/1 * chore: bump astrid-sdk to 0.3.0 and fix CI by @joshuajbouw in https://github.com/unicity-astrid/capsule-memory/pull/2 * ci: add WASM release pipeline by @joshuajbouw in https://github.com/unicity-astrid/capsule-memory/pull/4 * chore: bump astrid-sdk to 0.5.0 by @joshuajbouw in https://github.com/unicity-astrid/capsule-memory/pull/5 * fix: use workspace:// VFS scheme for memory.md path by @joshuajbouw in https://github.com/unicity-astrid/capsule-memory/pull/6 * feat: read project folder name from cwd_dir env config by @joshuajbouw in https://github.com/unicity-astrid/capsule-memory/pull/7 * feat: inject both personal and project memory by @joshuajbouw in https://github.com/unicity-astrid/capsule-memory/pull/8 * chore: bump astrid-sdk to 0.5.2 by @joshuajbouw in https://github.com/unicity-astrid/capsule-memory/pull/9 * fix: correct env field names in Capsule.toml by @joshuajbouw in https://github.com/unicity-astrid/capsule-memory/pull/10 * fix: include payload in response_topic error for diagnostics by @joshuajbouw in https://github.co

• ultraworkers/claw-code

  An agent-managed museum exhibit, built in Rust with Gajae-Code / LazyCodex — developed and maintained with no human intervention.

  195.2K stars · Rust

• farion1231/cc-switch

  A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io

  140K stars · Rust

• openai/codex

  Lightweight coding agent that runs in your terminal

  127.8K stars · Rust

• denoland/deno

  A modern runtime for JavaScript and TypeScript.

  108.6K stars · Rust

• ruvnet/RuView

  π RuView turns commodity WiFi signals into real-time spatial intelligence, vital sign monitoring, and presence detection — all without a single pixel of video.

  96.4K stars · Rust

• oven-sh/bun

  Incredibly fast JavaScript runtime, bundler, test runner, and package manager – all in one

  96.1K stars · Rust