PHPackages spora-ai/spora-plugin-memories - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. spora-ai/spora-plugin-memories ActiveSpora-plugin spora-ai/spora-plugin-memories ============================== Persistent memory storage for agents and users — UI + memory/global\_memory tools. 0.1.0(today)00MITPHPPHP ^8.4.1CI passing Since Jul 30Pushed todayCompare [ Source](https://github.com/spora-ai/spora-plugin-memories)[ Packagist](https://packagist.org/packages/spora-ai/spora-plugin-memories)[ RSS](/packages/spora-ai-spora-plugin-memories/feed)WikiDiscussions main Synced today READMEChangelogDependencies (8)Versions (2)Used By (0) spora-plugin-memories ===================== [](#spora-plugin-memories) Persistent memory storage for agents and users — UI + `memory` / `global_memory` tools for Spora agents. This plugin contributes the **Memories** admin panel to the host's Apps dropdown. The panel is a pre-built Vue SPA delivered as a separate Composer package (`spora-ai/spora-plugin-memories-frontend`, type `spora-plugin-frontend`). The two-package split lets the frontend evolve on its own release cadence and lets backend-only operators skip the bundle entirely. Install ------- [](#install) ``` composer require spora-ai/spora-plugin-memories ``` The PHP package's `require` block pulls the frontend package in transitively — operators don't need to require it separately. The PHP package ships the migration (`memories` table), the controllers, the service layer, and the two memory tools (`memory` and `global_memory`); the frontend package ships the Vue IIFE bundle that the host SPA lazy-loads at runtime. Requires `spora-ai/spora-core` ≥ 0.12.0 (when this plugin shipped, the memories feature was extracted out of core and the host was bumped to drop the previous core implementation). What it does ------------ [](#what-it-does) - Surfaces rows from the `memories` table as a sidebar-and-detail admin panel scoped per user (global) and per agent. - Creates a `memories_000001_create_memories_table.php` migration. On installs upgrading from a host that already shipped the `memories` table, the migration's `hasTable('memories')` guard makes it a no-op. - Ships two LLM-callable tools — `memory` (agent-scoped) and `global_memory` (cross-agent, per user) — each with `list`, `get`, `save`, and `delete` operations. List / get / save auto-approve; only `delete` requires explicit user approval (it is destructive). - Adds a bundled agent template (`memories-assistant.json`) under the plugin's `agent-templates/` directory, wiring both tools onto the host's default system prompt with explicit guidance on when to use each. API surface ----------- [](#api-surface) After install, 12 endpoints appear under `/api/v1/memories*`: - `GET /api/v1/memories` — list the current user's global memories. - `POST /api/v1/memories` — create a global memory. - `PATCH /api/v1/memories/reorder` — reorder global memories. - `GET /api/v1/memories/{id}` — fetch a single global memory. - `PUT /api/v1/memories/{id}` — update a global memory. - `DELETE /api/v1/memories/{id}` — delete a global memory. - `GET /api/v1/agents/{agentId}/memories` — list memories for one agent. - `POST /api/v1/agents/{agentId}/memories` — create an agent memory. - `PATCH /api/v1/agents/{agentId}/memories/reorder` — reorder agent memories. - `GET /api/v1/agents/{agentId}/memories/{memoryId}` — fetch one agent memory. - `PUT /api/v1/agents/{agentId}/memories/{memoryId}` — update an agent memory. - `DELETE /api/v1/agents/{agentId}/memories/{memoryId}` — delete an agent memory. All endpoints require `AuthMiddleware` + `CsrfMiddleware`. Uninstalling ------------ [](#uninstalling) `composer remove spora-ai/spora-plugin-memories` removes the admin-panel metadata from the App Registry, drops the 12 routes, and the navbar tile disappears cleanly. The `memories` table is **preserved** — uninstalling does not `Capsule::schema()->dropIfExists('memories')`. Reinstalling is a no-op on the schema. This is intentional: data persists across plugin uninstall/reinstall cycles. Reference --------- [](#reference) The canonical reference (REST contract, schema, tool definitions, agent template schema) lives on the docs site at [docs.spora-ai.com/develop/plugins/reference/memories](https://docs.spora-ai.com/develop/plugins/reference/memories). If that URL is unreachable (the page may not have published yet), the source-of-truth copy lives in the spora-docs repo at [`docs/develop/plugins/reference/memories.md`](https://github.com/spora-ai/spora-docs/blob/main/docs/develop/plugins/reference/memories.md). License ------- [](#license) MIT — see [LICENSE](LICENSE). ### Health Score 38 — LowBetter than 83% of packages Maintenance100 Actively maintained with recent releases Popularity0 Limited adoption so far Community6 Small or concentrated contributor base Maturity40 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 0d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/5be6ae8a46a938dbf3d35611aa2724446742020f0eeefdfa94333aa2d0ee40a2?d=identicon)[fabeat](/maintainers/fabeat) --- Top Contributors [![fabeat](https://avatars.githubusercontent.com/u/186884?v=4)](https://github.com/fabeat "fabeat (36 commits)") ### Code Quality TestsPest Static AnalysisPHPStan Code StylePHP CS Fixer Type Coverage Yes ### Embed Badge ![Health badge](/badges/spora-ai-spora-plugin-memories/health.svg) ``` [![Health](https://phpackages.com/badges/spora-ai-spora-plugin-memories/health.svg)](https://phpackages.com/packages/spora-ai-spora-plugin-memories) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)