ric/omnimem
Watch
1
0
Fork
You've already forked omnimem
 0
Code Issues 2 Pull requests Releases 16 Packages Activity Actions
16 releases 20 tags
  • v3.7.0 f5cb1ec88b

    v3.7.0 Stable

    ric_harvey released this 2026-03-19 19:52:41 +00:00 | 179 commits to main since this release

    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
    Downloads