Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
163 commits
Select commit Hold shift + click to select a range
6f3298b
feat(memos-local-plugin): hermes adapter overhaul + dual-port viewer …
hijzy Apr 24, 2026
9a185e5
fix(memos-local-plugin): per-agent legacy migration path + per-agent …
hijzy Apr 27, 2026
eb2cfa9
fix(memos-local-plugin): per-agent legacy migration path + per-agent …
hijzy Apr 27, 2026
0c86df5
fix(install.sh): comprehensive UX polish for installer output
hijzy Apr 27, 2026
9d23d8d
fix(install.sh): comprehensive UX polish for installer output (#1551)
hijzy Apr 27, 2026
904576b
fix(install.sh): comprehensive UX polish for installer output
hijzy Apr 27, 2026
606b945
refactor(skill/verifier): replace regex heuristic with structured too…
hijzy Apr 27, 2026
5143d0c
refactor(skill/verifier): replace regex heuristic with structured too…
hijzy Apr 27, 2026
ef8166a
fix(hermes): ruff lint + format fixes for memos_provider
hijzy Apr 27, 2026
2ea96b9
fix(hermes): ruff lint + format fixes for memos_provider (#1553)
hijzy Apr 27, 2026
ac44d43
chore: add AGENTS_*.md to .gitignore
hijzy Apr 27, 2026
db8f37b
chore: add AGENTS_*.md to .gitignore (#1554)
hijzy Apr 27, 2026
2636557
feat(viewer): auto-restart OpenClaw gateway after config save
hijzy Apr 28, 2026
63109ae
feat(viewer): auto-restart OpenClaw gateway after config save (#1556)
hijzy Apr 28, 2026
e3ccf98
fix(core): emit warn logs when LLM is unavailable instead of silent d…
hijzy Apr 28, 2026
e16107d
fix(core): emit warn logs when LLM unavailable + configurable tool-he…
hijzy Apr 28, 2026
e2d0918
fix(core): eagerly null-out LLM client when host bridge is missing
hijzy Apr 28, 2026
d48c2d3
fix(core): eagerly null-out LLM client when host bridge is missing (#…
hijzy Apr 28, 2026
b06dbe4
fix: memory tools are not registered
Apr 28, 2026
46dae0e
fix: memory tools are not registered (#1561)
whipser030 Apr 28, 2026
8d9763d
feat(viewer): UI improvements, i18n fixes, global search, markdown chat
hijzy Apr 28, 2026
0afea35
feat(bridge): Hermes daemon mode for persistent Memory Viewer
hijzy Apr 28, 2026
4b29dda
fix(bridge): reliable Hermes daemon restart via delayed respawn
hijzy Apr 28, 2026
1159484
feat(viewer): UI improvements, global search, Hermes daemon mode (#1562)
hijzy Apr 28, 2026
55345d5
fix(bridge): clear-data also spawns daemon, agent-aware error hints
hijzy Apr 28, 2026
766e009
fix(bridge): clear-data also spawns daemon, agent-aware error hints (…
hijzy Apr 28, 2026
47e11df
fix(import): preserve content-type case for multipart boundary matching
hijzy Apr 28, 2026
cefd957
fix(import): preserve content-type case for multipart boundary matchi…
hijzy Apr 28, 2026
b6346c1
fix(viewer): localize legacy DB migration scan results
hijzy Apr 28, 2026
0531542
fix: orphan abandon
Apr 28, 2026
6970292
Merge branch 'mem-agent-0424' into mem-agent-0424-niu0428
Apr 28, 2026
a72dc05
fix(viewer): localize legacy DB migration scan results (#1566)
hijzy Apr 28, 2026
aea1b03
fix: orphan abandon (#1567)
whipser030 Apr 28, 2026
05ec2e5
feat(viewer): remove role filter on memories page, unified 20 per page
hijzy Apr 28, 2026
e204449
feat(viewer): remove role filter on memories page, unified 20 per pag…
hijzy Apr 28, 2026
90bec4b
fix: exposure all tool to hermes
Apr 28, 2026
65801ab
fix: exposure all tool to hermes (#1570)
whipser030 Apr 28, 2026
80f0d0f
feat(viewer): per-turn memory grouping, hermes thinking capture, sett…
hijzy Apr 28, 2026
1fb9669
feat(viewer): per-turn memory grouping, hermes thinking capture, sett…
hijzy Apr 28, 2026
6993f23
chore(config): lower default thresholds for faster skill evolution
hijzy Apr 28, 2026
2fbfc64
chore(config): lower default thresholds for faster skill evolution (#…
hijzy Apr 28, 2026
80cee41
fix:hermes session abandoned session
Apr 28, 2026
eea28f2
fix:hermes session abandoned session
Apr 28, 2026
8517120
fix:hermes session abandoned session (#1573)
whipser030 Apr 28, 2026
5df92a8
fix:keep trace_ids
Apr 28, 2026
a2c260f
Merge branch 'mem-agent-0424' into mem-agent-0424-niu0428
Apr 28, 2026
955375a
Mem agent 0424 niu0428 (#1574)
whipser030 Apr 28, 2026
fb0d7fc
fix:L3 drop L2 data
Apr 29, 2026
3028387
fix:L3 drop L2 data (#1576)
whipser030 Apr 29, 2026
411be3a
chore(session): raise arbitration threshold 0.65 → 0.8
hijzy Apr 29, 2026
ac276cb
chore(session): raise arbitration threshold 0.65 → 0.8 (#1577)
hijzy Apr 29, 2026
87139b2
fix: "那换个话题"
Apr 29, 2026
e121a0e
Merge mem-agent-0424-niu0428 into mem-agent-0424 (#1579)
whipser030 Apr 29, 2026
4653ed8
fix: repair skill zip downloads
Apr 29, 2026
5392715
fix: repair skill zip downloads
Apr 29, 2026
08f929a
test: update HTTP route stubs
Apr 29, 2026
63ee38d
fix: repair skill zip download and YAML frontmatter (#1580)
whipser030 Apr 29, 2026
7418638
fix:skill distill failed -> model reject and warning
Apr 29, 2026
034dc03
fix:skill distill failed -> model reject and warning
Apr 29, 2026
0c4803e
fix:skill distill failed -> model reject and warning (#1581)
whipser030 Apr 29, 2026
48f2e9f
fix(hermes): stabilize plugin viewer and turn persistence
Apr 29, 2026
41bf651
Merge upstream/mem-agent-0424 into Hermes plugin fixes
Apr 29, 2026
a44482c
fix(hermes): fix memory persistence and viewer bugs (#1582)
hijzy Apr 29, 2026
ba05f7c
fix(hermes): stabilize model fallback and viewer diagnostics
hijzy Apr 29, 2026
c4cacfd
fix(hermes): stabilize model fallback and viewer diagnostics (#1584)
hijzy Apr 29, 2026
8dd307f
fix: capture Hermes tool thinking in order
whipser030 Apr 29, 2026
409571e
fix: align Hermes restart UX
hijzy Apr 29, 2026
978161d
fix: align Hermes restart UX (#1586)
hijzy Apr 29, 2026
bb46078
fix:subagent record
Apr 29, 2026
bfe3247
style: format Hermes provider Python code
whipser030 Apr 29, 2026
b73f27d
fix: preserve Hermes tool timing during merge
whipser030 Apr 29, 2026
cbfb419
Merge branch 'mem-agent-0424' into mem-agent-0424-zgm
MatthewZhuang Apr 29, 2026
57a7e12
Fix Hermes tool thinking capture order (#1587)
MatthewZhuang Apr 29, 2026
a316bde
fix:subagent record & start connect bridge overtime
Apr 29, 2026
564d228
fix(hermes): ignore skill review prompt variants
hijzy Apr 29, 2026
ed0337d
fix(hermes): ignore skill review prompt variants (#1588)
hijzy Apr 29, 2026
a0f85f3
fix:subagent record & start connect bridge overtime
Apr 29, 2026
8cd51ae
fix:subagent record & start connect bridge overtime (#1589)
whipser030 Apr 29, 2026
daeb864
fix: preserve topic tasks across session restarts
hijzy Apr 29, 2026
50cbc19
fix: preserve topic tasks across session restarts (#1590)
hijzy Apr 29, 2026
9053d75
fix:embedder fail process
Apr 30, 2026
4d0f84e
Merge remote-tracking branch 'origin/mem-agent-0424' into mem-agent-0…
Apr 30, 2026
ab642d7
fix:embedder fail process (#1598)
whipser030 Apr 30, 2026
1358bf8
fix: llm response delete html and santize
Apr 30, 2026
91ee77c
fix: llm response delete html and santize (#1599)
whipser030 Apr 30, 2026
812cb00
fix:Rerank Function Issue
Apr 30, 2026
000d69f
fix:Rerank Function Issue (#1600)
whipser030 Apr 30, 2026
22ccacb
fix: web signal light for bridge connected
Apr 30, 2026
aaf245e
Merge remote-tracking branch 'origin/mem-agent-0424' into mem-agent-0…
Apr 30, 2026
84f736d
fix: web signal light for bridge connected (#1601)
whipser030 Apr 30, 2026
4c6be84
fix: preserve Hermes tool context in viewer
whipser030 Apr 30, 2026
03d1d45
Merge mem-agent-0424 into mem-agent-0424-zgm
MatthewZhuang Apr 30, 2026
ad528e2
fix: align viewer trace ordering
MatthewZhuang Apr 30, 2026
8e317a9
Preserve Hermes tool context in MemOS viewer (#1602)
MatthewZhuang Apr 30, 2026
87dda11
fix: stabilize MemOS trace ordering and scoring
MatthewZhuang May 1, 2026
ac7312c
fix: stabilize MemOS trace ordering and scoring (#1610)
MatthewZhuang May 1, 2026
6ee98b2
fix: improve MemOS task recovery and diagnostics
MatthewZhuang May 2, 2026
4894592
fix: improve MemOS task recovery and diagnostics (#1613)
MatthewZhuang May 2, 2026
ae7f48c
fix: keep task user message before tools
MatthewZhuang May 3, 2026
e1bba25
fix: keep task user message before tools (#1614)
MatthewZhuang May 3, 2026
b953111
fix: stabilize MemOS memory lifecycle
MatthewZhuang May 4, 2026
ef9f149
fix: stabilize MemOS memory lifecycle (#1615)
MatthewZhuang May 4, 2026
665785d
feat: correlate pipeline LLM calls to episodes in Logs viewer
MatthewZhuang May 5, 2026
12f9cff
feat: correlate pipeline LLM calls to episodes in Logs viewer (#1618)
MatthewZhuang May 5, 2026
cb3e21f
release: 2.0.0-beta.5
MatthewZhuang May 5, 2026
d7d7832
fix: align sharing visibility tags
hijzy May 6, 2026
45faf66
fix: align sharing visibility tags (#1621)
hijzy May 6, 2026
4c7247f
feat: isolate MemOS memory by agent namespace
hijzy May 6, 2026
68056a2
feat: isolate MemOS memory by agent namespace (#1623)
hijzy May 6, 2026
f55ca94
fix:topk input search
May 6, 2026
3ea9b59
fix:topk input search (#1625)
whipser030 May 6, 2026
477de47
fix: package memos plugin runtime assets
hijzy May 6, 2026
f53cd6c
fix: package memos plugin runtime assets (#1626)
hijzy May 6, 2026
b9d1469
fix: llmFilterMaxKeep dynamic input
May 7, 2026
df93353
Merge remote-tracking branch 'origin/mem-agent-0424' into mem-agent-0…
May 7, 2026
c8da078
fix: llmFilterMaxKeep dynamic input (#1628)
whipser030 May 7, 2026
b60d3f2
fix: stabilize Hermes v2 regression behavior
May 7, 2026
2c36f89
fix: stabilize Hermes v2 regression behavior (#1629)
hijzy May 7, 2026
3600f80
feat: implement ARMS telemetry for Hermes v2 plugin
May 7, 2026
2080be3
merge: resolve conflict with upstream/mem-agent-0424
May 7, 2026
b86d573
feat: implement ARMS telemetry for Hermes v2 plugin (#1631)
hijzy May 7, 2026
fa505ee
fix: logs view text invisible in light theme
May 7, 2026
8775a28
fix: logs view text invisible in light theme (#1632)
syzsunshine219 May 7, 2026
7900084
feat: collapsible chat messages for long user/assistant text
May 7, 2026
1630f34
feat: collapsible chat messages for long user/assistant text (#1633)
syzsunshine219 May 7, 2026
2823191
fix: improve memos plugin memory workflows
MatthewZhuang May 7, 2026
f10ee55
feat: add feedback experience retrieval (#1634)
hijzy May 7, 2026
911b93b
fix: improve memos plugin memory workflows (#1635)
MatthewZhuang May 7, 2026
fdd81ef
fix: trim retrieval prompt metadata (#1636)
hijzy May 7, 2026
bf38d34
Merge remote-tracking branch 'origin/mem-agent-0424-dev' into mem-age…
MatthewZhuang May 7, 2026
18c6bd5
fix: localize task skip reasons (#1640)
hijzy May 8, 2026
aa2bec4
fix: Modify the name of the memory channel signal light
May 8, 2026
7a03d76
Merge remote-tracking branch 'origin/mem-agent-0424' into mem-agent-0…
May 8, 2026
d442d4d
fix: Modify the name of the memory channel signal light (#1641)
whipser030 May 8, 2026
48684b5
fix: improve memos local plugin OpenClaw behavior (#1643)
hijzy May 8, 2026
6e34443
feat: add detailed log controls (#1644)
hijzy May 8, 2026
3706cd8
fix: improve memos recall and viewer lifecycle
MatthewZhuang May 8, 2026
7f543e2
fix: apply per-tier topK truncation in searchMemory (#1646)
syzsunshine219 May 8, 2026
596e8af
Merge origin/mem-agent-0424 into mem-agent-0424-zgm
MatthewZhuang May 8, 2026
96d2f4b
Improve MemOS plugin memory workflows (#1645)
MatthewZhuang May 8, 2026
896e250
Add keyword recall for experiences (#1647)
hijzy May 8, 2026
681364e
fix: Rendering markdown
May 8, 2026
94234a8
Merge origin/mem-agent-0424 into mem-agent-0424-niu0428
May 8, 2026
d47b657
fix: Rendering markdown (#1649)
whipser030 May 8, 2026
0d8a9d8
Merge mem-agent-0424-dev into mem-agent-0424
hijzy May 8, 2026
d790956
Merge remote-tracking branch 'upstream/mem-agent-0424' into cursor/me…
hijzy May 8, 2026
e17ca40
fix: Rendering markdown
May 8, 2026
81c892a
Merge remote-tracking branch 'origin/mem-agent-0424' into mem-agent-0…
May 8, 2026
2f3f1e5
fix: Rendering markdown (#1651)
whipser030 May 8, 2026
e6c1603
fix: reflection language
May 8, 2026
4b23185
Merge remote-tracking branch 'origin/mem-agent-0424' into mem-agent-0…
May 8, 2026
2113544
fix: reflection language (#1652)
whipser030 May 8, 2026
f44781c
Add native memory import flows (#1653)
hijzy May 8, 2026
7edce53
Improve overview activity dashboard (#1654)
hijzy May 8, 2026
285a692
Prune memos plugin package contents (#1655)
hijzy May 8, 2026
cbd431f
Cursor/prune package docs (#1656)
hijzy May 8, 2026
1e608f6
fix: improve grouped memory summaries
MatthewZhuang May 8, 2026
6b0cdc2
fix: improve grouped memory summaries (#1657)
MatthewZhuang May 8, 2026
6e7ad22
feat: streamline model provider options and add inherit/local hints (…
syzsunshine219 May 8, 2026
9511935
Revamp Help page and de-emphasise Live Activity shadow (#1659)
hijzy May 8, 2026
8bd758c
chore(memos-local-plugin): bump version to 2.0.0-beta.11 and tidy REA…
hijzy May 8, 2026
34916ff
Merge branch 'main' into mem-agent-0424
hijzy May 8, 2026
9d19ecb
fix(memos-local-plugin): satisfy ruff isinstance union checks
hijzy May 8, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
7 changes: 7 additions & 0 deletions .github/workflows/hermes-plugin-publish.yml
Original file line number Diff line number Diff line change
Expand Up @@ -92,6 +92,13 @@ jobs:
- name: Install dependencies (skip native build)
run: npm install --ignore-scripts

- name: Generate telemetry credentials
run: node scripts/generate-telemetry-credentials.cjs
env:
MEMOS_ARMS_ENDPOINT: ${{ secrets.MEMOS_ARMS_ENDPOINT }}
MEMOS_ARMS_PID: ${{ secrets.MEMOS_ARMS_PID }}
MEMOS_ARMS_ENV: ${{ secrets.MEMOS_ARMS_ENV }}

- name: Bump version
run: npm version ${{ inputs.version }} --no-git-tag-version --allow-same-version

Expand Down
5 changes: 5 additions & 0 deletions .test1.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
import jieba.analyse


res = jieba.analyse.extract_tags("我爱旅游和烧烤", topK=12)
print(res)
2 changes: 2 additions & 0 deletions apps/memos-local-plugin/.gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -16,3 +16,5 @@ coverage/
# Local notes (developer scratch)
.notes/
TODO.local.md
AGENTS_*.md
.test_*
139 changes: 0 additions & 139 deletions apps/memos-local-plugin/AGENTS.md

This file was deleted.

76 changes: 23 additions & 53 deletions apps/memos-local-plugin/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,17 +41,19 @@ apps/memos-local-plugin/
└── tests/ # unit / integration / e2e (vitest)
```

For the full structural breakdown read [`ARCHITECTURE.md`](./ARCHITECTURE.md).
For the full structural breakdown read `[ARCHITECTURE.md](./ARCHITECTURE.md)`.

## Where data lives

The source code never writes to the user's home directly. At install time,
`install.sh` creates a per-agent home folder for runtime state:

| Agent | Code installed to | Runtime data + config in |
|----------|------------------------------------------------|----------------------------------------------|
| OpenClaw | `~/.openclaw/plugins/memos-local-plugin/` | `~/.openclaw/memos-plugin/` |
| Hermes | `~/.hermes/plugins/memos-local-plugin/` | `~/.hermes/memos-plugin/` |

| Agent | Code installed to | Runtime data + config in |
| -------- | ----------------------------------------- | --------------------------- |
| OpenClaw | `~/.openclaw/plugins/memos-local-plugin/` | `~/.openclaw/memos-plugin/` |
| Hermes | `~/.hermes/plugins/memos-local-plugin/` | `~/.hermes/memos-plugin/` |


Inside the runtime folder:

Expand All @@ -68,63 +70,31 @@ Upgrading or uninstalling the plugin **never** touches `data/`, `skills/`,

## Quick start

```bash
# 1) Install the npm package
npm install -g @memtensor/memos-local-plugin

# 2) Run the install script for your agent
memos-local-plugin install openclaw # or: hermes
# (this is a thin wrapper around install.sh)
Use the installer script to deploy or upgrade the plugin. Do not install the
package directly with `npm install`; the script downloads the package, deploys it
to the right agent directory, installs production dependencies, writes the
initial `config.yaml`, and restarts the agent runtime when needed.

# 3) Edit your config (optional)
$EDITOR ~/.openclaw/memos-plugin/config.yaml
From this repository:

# 4) Open the viewer (started automatically by the agent on first turn)
open http://127.0.0.1:18910/
```bash
cd apps/memos-local-plugin
bash install.sh --version 2.0.0
```

For the full hands-on walkthrough see [`site/content/docs/getting-started.md`](./site/content/docs/getting-started.md).

## Validating end-to-end

Once everything is up, follow the scripted checklist in
[`docs/FRONTEND-VALIDATION.md`](./docs/FRONTEND-VALIDATION.md): each line is
"say X to the agent, expect Y on the viewer". Use it to convince yourself the
loop (capture → reward → induce → crystallize → retrieve) is actually working.

## Local development
Or run against the latest published package:

```bash
# 1) Install workspace deps
npm install

# 2) Run unit tests
npm test

# 3) Develop the viewer
npm run web:dev

# 4) Develop the marketing/docs site (local preview only)
npm run site:dev

# 5) Type-check the whole core
npm run lint
bash install.sh
```

## Releasing

Every published version must ship with a release-note markdown:
The installer auto-detects OpenClaw and Hermes. In an interactive terminal it
asks which agent to install for; in non-interactive environments it installs for
the detected agent(s). To test a local package before publishing, pass the
tarball path instead of a registry version:

```bash
npm run release:new -- 2.0.0-beta.2
# edits site/content/releases/2.0.0-beta.2.md
npm run release:index # regenerates site/content/releases/index.json
npm run release:check # CI: package.json version <-> release md
npm publish
npm pack
bash install.sh --version ./memtensor-memos-local-plugin-1.0.0-beta.1.tgz
```

See [`docs/RELEASE-PROCESS.md`](./docs/RELEASE-PROCESS.md).

## License

MIT
5 changes: 2 additions & 3 deletions apps/memos-local-plugin/adapters/hermes/install.hermes.sh
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@ cd "$PREFIX"

# ── 1. node_modules ───────────────────────────────────────────────────────────
if command -v npm >/dev/null 2>&1; then
command -v node > .memos-node-bin
if [[ -d "node_modules" ]]; then
log "node_modules already present — skipping install"
else
Expand All @@ -38,12 +39,10 @@ else
warn "npm not found on PATH; bridge.cts requires Node.js ≥ 20."
fi

# ── 2. viewer + site bundles ──────────────────────────────────────────────────
# ── 2. viewer bundle ──────────────────────────────────────────────────────────
if [[ -x "./node_modules/.bin/vite" ]]; then
log "Building viewer bundle → web/dist/"
./node_modules/.bin/vite build --config vite.config.ts >/dev/null
log "Building site bundle → site/dist/"
( cd site && ../node_modules/.bin/vite build >/dev/null )
else
warn "vite not found in node_modules; skipping bundle build"
fi
Expand Down
Loading
Loading