unicity-aos/capsule-memoryPublic

Cross-session memory. Reads local memory state and injects it into the system prompt through hooks. Part of Unicity AOS.

AI summary: A cross-session persistent swap file capsule providing memory for Astrid OS agents.

Star on GitHub

Stars: 8.6K
Forks: 20
Watchers: 10
Open issues: 0
Open PRs: 2
Contributors: ~1
Commits: 27
Branches: 5

RustApache-2.0Created Mar 16, 2026Last push 28d agoLatest release v0.2.0+761 stars this week+761 this month

Star history

since Jul 19, 2026

8.6K stars as of Aug 6, 2026, tracked back to Jul 19, 2026. Historical curve reconstructed from public GitHub event archives, calibrated to the current total.

Contribution activity

commits per day, last 52 weeks

26 commits in the last yearLessMore

Signals and awards

derived from tracked data

Rising fast
+761 stars this week
Permissive license
Apache-2.0
Continuous integration
Automated checks passing

What capsule-memory does

This repository implements the `astrid-capsule-memory` capsule, which serves as a persistent cross-session swap file for agents running on Astrid OS. It hooks directly into the prompt assembly cycle to read a memory file from the workspace via the Virtual File System (VFS). By automatically wrapping this content in a dedicated section and appending it to the system context, it ensures the agent remembers what happened in previous sessions. This seamless context preservation allows agents to maintain long-term memory across distinct operational boundaries without manual state management.

Developers and operators building and running AI agents on Astrid OS who need reliable, cross-session memory management.

Cross-session persistence: Carries context across session boundaries so the agent remembers past events.
Automated prompt injection: Hooks into the before-build cycle to automatically append memory to the system context.
VFS integration: Reads and interacts with a dedicated memory file directly from the workspace filesystem.
Graceful degradation: Functions as a safe no-op if the memory file is missing or empty.
Astrid OS compatibility: Designed specifically as a core operational capsule within the Astrid OS environment.

Where teams use it

Maintaining agent context

Users deploy the capsule so their Astrid OS agent remembers instructions and state from a previous day's work session.

Long-term task execution

Complex, multi-step agent tasks rely on the memory capsule to store progress and resume correctly after an interruption.

Automated state recovery

Developers use the capsule's hook system to automatically load saved workspace context into the agent's prompt without manual intervention.

Iterative prompt building

The system aggregates memory safely over time, allowing the agent to continuously learn from its interactions within the workspace.

Getting started: git clone https://github.com/unicity-aos/capsule-memory.git

README

main branch

astrid-capsule-memory

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:

Reads .astrid/memory.md from the workspace via the VFS
Wraps the content in a # Memory section
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.

View on GitHub

Recent activity

commits and pull requests

docs: add Chinese and Japanese READMEsOpen
#23 by tura-ai-agent · updated 14d ago
feat: KV-backed memory with add_memory tool and /memory-export commandOpen
#3 by joshuajbouw · updated 18d ago
chore: release 0.2.0Merged
#22 by joshuajbouw · updated 28d ago
chore: release 0.2.0 (#22)
joshuajbouw committed ceab000 · 28d ago
ci(release): publish componentized .capsule (was raw wasm)Merged
#21 by joshuajbouw · updated 1mo ago
ci(release): publish componentized .capsule (was raw wasm) (#21)
joshuajbouw committed d634a3d · 1mo ago
chore(deps): bump astrid-sdk to 0.7.1Merged
#20 by joshuajbouw · updated 1mo ago
chore(deps): bump astrid-sdk to 0.7.1 (#20)
joshuajbouw committed 2f570d4 · 1mo ago
chore: commit Cargo.lock and enforce --locked buildsMerged
#19 by joshuajbouw · updated 2mo ago
chore: commit Cargo.lock and enforce --locked builds (#19)
joshuajbouw committed 011067b · 2mo ago
chore: scrub stale wasi-target referencesMerged
#18 by joshuajbouw · updated 2mo ago
chore: scrub stale wasi-target references (#18)
joshuajbouw committed 975769e · 2mo ago

Releases and announcements

2 total

v0.2.0v0.2.0Jul 9, 202610 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
v0.1.0v0.1.0Jun 14, 202640 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

Commits per week

last 52 weeks

26 commits in the last 52 weeks.

When work happens

weekday and hour

Commit volume by weekday and hour (UTC). Larger dots mean more commits.

Date	List	Rank	Stars gained
Jul 21, 2026	daily	#6	+7
Jul 20, 2026	daily	#11	+4

ultraworkers/claw-code
An agent-managed museum exhibit, built in Rust with Gajae-Code / LazyCodex — developed and maintained with no human intervention.
195K stars · Rust
ultraworkers/claw-code
An agent-managed museum exhibit, built in Rust with Gajae-Code / LazyCodex — developed and maintained with no human intervention.
194.9K stars · Rust
ultraworkers/claw-code
An agent-managed museum exhibit, built in Rust with Gajae-Code / LazyCodex — developed and maintained with no human intervention.
194.9K 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
125.4K stars · Rust
denoland/deno
A modern runtime for JavaScript and TypeScript.
108.2K stars · Rust
openai/codex
Lightweight coding agent that runs in your terminal
104.6K stars · Rust

About

License: Apache-2.0
First commit: Mar 15, 2026
Age: 4 months
Default branch: main
Tags: 2
Closed issues: 0
Merged PRs: 21
Owner type: Organization

Community health50%

—Contributing guide
—Code of conduct
—Issue templates
—Security policy

Continuous integration

CIaction_required
Releasesuccess
Running Copilot Code Reviewsuccess

Source

12 top-level entries

Browse the full source tree

Languages

Rust 100.0%

Direct dependencies

Cargo.toml

astrid-sdkuuidserdeserde_json

Full dependency graph

Contributors

View contributor graph

1joshuajbouw27 commits

Topics

astrid-os ai-agents memory-management context-preservation system-prompts

Links

Data from the GitHub API, refreshed Aug 6, 2026.