v3.7.0 #2

Merged

ric_harvey merged 0 commits from refs/pull/2/head into main

2026-03-19 19:51:44 +00:00

ric_harvey commented

2026-03-19 19:51:20 +00:00

(Migrated from codeberg.org)

Title: v3: Web UI dashboard, telemetry, auto-maintenance, and MCP instructions

Description:

Summary

This is the full v3 branch, covering versions 3.0.0 through 3.7.0. The headline feature is a web UI dashboard for browsing and managing memories outside of Claude Code,
but there's a lot more in here.

Web UI dashboard (Starlette + Jinja2 + htmx) — browse memories with filters and pagination, semantic search, memory detail views, lifecycle management, create new
memories with inline duplicate detection, project management (list/detail/edit/create/delete), RSS feeds CRUD with download/upload, experience tracking and graveyard
views, duplicate scanning, contradiction detection, suppression management, and backup management with create/download/upload/delete
Telemetry and Prometheus metrics — per-memory recall_count and last_recalled counters updated on every recall, telemetry dashboard page in the web UI, and a
Prometheus-compatible /metrics endpoint for Grafana integration
Auto-maintenance — automatic deduplication and contradiction scanning triggered every N briefing() calls per project (configurable via AUTO_MAINTENANCE_INTERVAL, default

MCP instructions injection — OmniMem now injects its own usage instructions automatically when Claude Code connects, so users no longer need to manually copy CLAUDE.md
into every project
compile_project_context tool — auto-generates project context from stored episodic memories, useful for bootstrapping context on projects that already have memories but
no explicit set_project_context() call
version() tool — returns the current OmniMem version
RSS worker file watcher — mtime polling with configurable interval and misfire_grace_time for robustness on sleeping machines
Reverse proxy docs — Traefik and Caddy examples covering both web UI and MCP server endpoints
Startup index migration — compares field counts against definitions and drops stale indexes so they get recreated with new fields

Stats

45 new files, 73 files changed, ~5,800 lines added
43 commits
New Docker service: web_ui on port 8080
New test suites for recall counters, maintenance, and briefing maintenance

Test plan

cd mcp_server && pytest tests/ — all existing and new tests pass
docker compose up -d — all four containers start and stay healthy
Web UI accessible at http://localhost:8080 — dashboard loads, navigation works
Browse memories, search, create, view detail, lifecycle actions all functional
RSS feeds page: list, create, edit, delete, download, upload
Projects page: list, detail, edit, create, delete
Telemetry page shows recall counts; /metrics returns Prometheus format
briefing() triggers auto-maintenance after configured interval
MCP instructions appear in Claude Code without manual CLAUDE.md setup
Reverse proxy docs: Traefik and Caddy configs work for both endpoints

Title: v3: Web UI dashboard, telemetry, auto-maintenance, and MCP instructions Description: Summary This is the full v3 branch, covering versions 3.0.0 through 3.7.0. The headline feature is a web UI dashboard for browsing and managing memories outside of Claude Code, but there's a lot more in here. - Web UI dashboard (Starlette + Jinja2 + htmx) — browse memories with filters and pagination, semantic search, memory detail views, lifecycle management, create new memories with inline duplicate detection, project management (list/detail/edit/create/delete), RSS feeds CRUD with download/upload, experience tracking and graveyard views, duplicate scanning, contradiction detection, suppression management, and backup management with create/download/upload/delete - Telemetry and Prometheus metrics — per-memory recall_count and last_recalled counters updated on every recall, telemetry dashboard page in the web UI, and a Prometheus-compatible /metrics endpoint for Grafana integration - Auto-maintenance — automatic deduplication and contradiction scanning triggered every N briefing() calls per project (configurable via AUTO_MAINTENANCE_INTERVAL, default 10) - MCP instructions injection — OmniMem now injects its own usage instructions automatically when Claude Code connects, so users no longer need to manually copy CLAUDE.md into every project - compile_project_context tool — auto-generates project context from stored episodic memories, useful for bootstrapping context on projects that already have memories but no explicit set_project_context() call - version() tool — returns the current OmniMem version - RSS worker file watcher — mtime polling with configurable interval and misfire_grace_time for robustness on sleeping machines - Reverse proxy docs — Traefik and Caddy examples covering both web UI and MCP server endpoints - Startup index migration — compares field counts against definitions and drops stale indexes so they get recreated with new fields Stats - 45 new files, 73 files changed, ~5,800 lines added - 43 commits - New Docker service: web_ui on port 8080 - New test suites for recall counters, maintenance, and briefing maintenance Test plan - cd mcp_server && pytest tests/ — all existing and new tests pass - docker compose up -d — all four containers start and stay healthy - Web UI accessible at http://localhost:8080 — dashboard loads, navigation works - Browse memories, search, create, view detail, lifecycle actions all functional - RSS feeds page: list, create, edit, delete, download, upload - Projects page: list, detail, edit, create, delete - Telemetry page shows recall counts; /metrics returns Prometheus format - briefing() triggers auto-maintenance after configured interval - MCP instructions appear in Claude Code without manual CLAUDE.md setup - Reverse proxy docs: Traefik and Caddy configs work for both endpoints ---

No reviewers

No labels

No milestone

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference

ric/omnimem!2

No description provided.

Rows
Columns