🍃 memoripo
A living workbench for the DeepSeek Harness Hindsight memory bank — grow, read, and use your agent's long-term memory from a persistent sidebar.
memoripo = memori(es) + repo — your memory, as a browsable repository.
中文说明
Why
DSH ships a powerful long-term memory engine (Hindsight), but its state lives in
a database and an ops log. memoripo turns that into a visual workbench: watch
memory grow day by day, see which memories actually get recalled, browse the
four knowledge layers, and manage pages — without leaving the chat UI.
Features
🌱 Garden view (sidebar workbench)
- Bank status at a glance — daemon health, node/fact/link counts, four-layer split (world / experience / observation)
- 7-day growth curve — horizontal per-day stacked bars so even quiet days stay legible
- Timeline — the latest background operations (ingest → consolidate → graph upkeep) with live status pills
- Utilization heat — which documents are actually being recalled (audit-driven), plus recent reads when tracking is on
- Readable activity feed — human labels instead of raw task types, capped with "show more"
🗂 Manage view (plugin-sized overlay)
- Full knowledge-page browser: card grid + folder tree, create/rename/move/delete, mental-model resynthesis
- Page reader with sticky TOC, markdown copy, raw-JSON copy
- Operations panel with retry / retry-all / clear-failed and a centered detail modal per task (progress stage & counters, full error text, copy JSON)
- Search, LLM & embedding config testing, template export/import — all migrated from the original manager under one roof
✨ Crafted details
- Unified top-light shadow system, gradient card faces, hover lift, press feedback, focus rings, slim scrollbars
- Fully localized (English / 简体中文), theme-variable aware (
--dsw-alias-* with safe fallbacks)
⚙️ Zero-config daemon
- The plugin auto-starts the local Hindsight daemon on boot: a mount-time
check plus a 45-second re-check respawn it if it dies mid-session, so no
external start script is needed. The daemon's output is captured to
~/.hindsight/daemon.out.log / daemon.err.log for forensics, and the
status pill shows "connecting" while a spawn is in flight.
Install
dsh plugin add github:Dayi-Z/memoripo
or from source:
git clone <this repo>
cd memoripo
pnpm install && pnpm run build
dsh plugin add ./
Then restart the web app. A 🍃 Memoripo entry appears in the main sidebar footer.
Requirements
- DeepSeek Harness
>= 0.1.0-rc.6 with the web app enabled
- Node.js
^22.19 || >= 24
- A Hindsight backend (daemon + PostgreSQL) — memoripo auto-starts the local
daemon on boot (see "Zero-config daemon") and reads whatever bank DSH is
configured to use
Architecture (one minute)
src/
├── index.ts # host plugin: /memoripo/* routes (status, growth, heat, pages…) + daemon supervisor mount
├── daemon.ts # in-plugin daemon supervisor: 8888 check, offline spawn, 45s re-check, log capture
├── hindsight-routes.ts # management endpoints (pages CRUD, operations, configs…)
└── client/
├── index.ts # sidebar column + footer entry mount
├── Memoripo.tsx # garden view (status, curve, timeline, heat, feed)
└── … # manage view lives in src/hindsight-client/
The host registers read-only analytics routes on the DSH webserver; the client
bundle mounts a compact workbench into the conversation-frame sidebar and a
fuller management overlay reachable from the main sidebar footer. All UI text
goes through two flat locale dictionaries (en/zh) with {n} interpolation.
Development
pnpm install
pnpm run typecheck # server + client TS projects
pnpm run build # lib/ (host) + client/client.js (browser bundle)
pnpm run check # both
Restart the web app after rebuilding to load the new bundle.
License
MIT
