HMG — Agent Memory That Actually Works

Holographic Memory Graph — branch-aware, auditable, governable long-term memory for AI coding agents.
Every session forgets. HMG makes sure the next one remembers.

🌐 Docs · 📦 Releases · 🏠 Website · 🚀 Quick Start · ✨ What's New

---

The Problem

Your AI coding agent is brilliant — and amnesiac.

Every new session starts with a blank slate. It re-reads the same files, re-asks the same questions, re-litigates decisions you already settled. "Why are we using Postgres?" gets answered six times across six sessions. A bug fix from last week? Forgotten. The API key it shouldn't commit? Committed again.

The cost isn't just keystrokes — it's trust. You can't delegate to an agent that keeps losing the thread.

Why HMG?

HMG gives an agent the one thing it's missing: a durable, queryable, governable memory.

Without HMG	With HMG
Re-reads the whole repo to relearn context	Wakes up with a one-shot brief: status, decisions, risks, next steps
Re-argues settled architecture questions	Knows why a choice was made — and what was rejected
Silently overwrites the old answer when it's wrong	Keeps full correction history; the new answer is canonical, the old is never lost
Commits secrets and sensitive context	Governance quarantines, seals, or derives safe lessons
Forgets your branch the moment you switch	Memories are branch-scoped: tenant → workspace → repository → branch

One tool call returns complete context. No prompt-stuffing. No context window limits. No forgetting.

Quick Start

# Install (Linux / macOS)
curl -fsSL https://github.com/HMG-AI/HMG-public/releases/latest/download/install.sh | sh

# The installer performs setup, starts or replaces the daemon, and proves
# required core readiness before it exits successfully.
hmg doctor

# Install (Windows PowerShell)
irm https://github.com/HMG-AI/HMG-public/releases/latest/download/install.ps1 | iex

# Setup and daemon readiness are automatic on a successful installer exit.
hmg doctor

Install and hmg update return exit 0 only after the selected binary bundle, automatic setup, daemon takeover, and required core readiness checks succeed. Failure returns non-zero and attempts to restore the previous working runtime; users should never need a manual hmg init or daemon restart to repair a successful install. Re-running the installer is the idempotent update path.

hmg uninstall removes the runtime and HMG-owned integration wiring while preserving stores, observations, audit history, and key material by default. Destructive removal requires hmg uninstall --purge-data --confirm-purge PURGE-HMG-DATA.

Store your first memory and pull it back — same works for any HTTP client:

# Store a decision
curl -s -X POST http://127.0.0.1:7654/api/memorize \
  -H 'Content-Type: application/json' \
  -d '{"content": "Decision: use Rust for performance-critical paths"}'

# Recall it later
curl -s http://127.0.0.1:7654/api/recall \
  -d '{"query": "what language for perf?"}'

# Verify your setup is healthy
hmg doctor

Community Edition is free — 100,000 memory atoms, all core features, no license key. No account, no telemetry, no cloud. Data stays local.

The Agent Memory Loop

capture → canonicalize → recall → correct → govern → consolidate → brief next session

Every session becomes context for the next. Decisions persist. Corrections leave a traceable history. Governance controls what gets remembered — and what gets forgotten.

# Store a decision with rationale
memory_memorize(content="Use Rust for performance-critical paths", source="ADR-001")

# Next session: the agent wakes up with full context
memory_agent_brief(domain_pack_id="software-engineering")
# → scope, current status, prior decisions, unresolved risks, next steps

# Correct stale knowledge — the old version is kept in history
memory_correct(target_atom="01ABC...", action="replace", new_content="Use Rust + WASM")

# Govern sensitive data so it never leaks into recall
memory_govern(target_atom="01DEF...", action="seal", reason="contains API key")

Core Capabilities

Not a vector database. Not a key-value store. HMG models memory as a typed graph — every atom carries polarity, epistemic state, governance tags, and a correction lineage.

• 🧲 One-Shot Recall — A single MCP call returns complete context: current status, prior decisions, unresolved risks, and next steps. No re-reading, no re-asking.
• 🌿 Branch-Aware Scope — tenant → workspace → repository → branch. Memories stay isolated per branch and become traceable on merge — your feature/auth work doesn't bleed into feature/payments.
• 🛡️ Governance Control Plane — Quarantine, seal, tombstone, or derive lessons. Policy tags and audit context flow through every operation. Normal recall skips governed content; audit recall still sees it.
• 🏠 Local-First — Embedded storage, zero external dependencies. Your memory lives on your machine, works offline, and never phones home.
• 🔌 49 MCP Tools — Memorize, recall, correct, govern, history, handoff, agent-brief, MemoryQL, observation capture, vault, panorama, and graph-health workflows — all over a single standard interface.
• 📜 Open Protocol — hmg-protocol (Apache-2.0) is a standalone crate defining types and serialization for every memory operation. Implement it, verify against it, build on it.

What's New in v1.6

• 🤝 Cross-Client Reliability — Spec-correct MCP ping + capability probes, and a transparent daemon-proxy fallback when a direct server hits a store-lock collision. Works smoothly with strict clients like opencode and the Hermes gateway.
• 🧬 Agent-Native Extraction — A dedicated DomainLens registry lets recall and anchoring lenses evolve independently of the coarser extraction profile. Caller-supplied entities and relations thread straight through the memorize pipeline.
• 🎯 Answer vs Context — Recall now flags the top-ranked answer cluster as primary, distinct from same-scope supporting context — so agents surface the answer first instead of drowning in context.
• 🔐 Two-Tier Source License — HMG is proprietary commercial software. The 19 core/product crates ship under the HMG Proprietary Source License; the 3 ecosystem-edge crates (hmg-domain-packs, hmg-sdk, hmg-evals) stay Apache-2.0.

See CHANGELOG.md and Releases for the full history.

Editions

	Community (Free)	Developer ($9/mo)	Enterprise
Memory atoms	100,000	Unlimited	Unlimited
Semantic search	✓	✓	✓
One-Shot Recall	✓	✓	✓
Correction + Governance	✓	✓	✓
Observation capture	✓	✓	✓
Domain pack	software-engineering	software-engineering	All
Consolidation	—	✓ (auto)	✓ (full)
Intelligent lifecycle	—	✓	✓
SSO / RBAC	—	—	✓

One binary, runtime edition detection. No reinstall, no migration. Start free on Community and upgrade anytime with hmg license apply <key>.

Agent Adapters

HMG works with the agent you already use. Wire any of the 19 supported adapters — each is doctor-verifiable:

Agent	Init command
pi	hmg init --agent pi
Codex CLI	hmg init --agent codex
Cursor	hmg init --agent cursor
Claude Code	hmg init --agent claude
VS Code	hmg init --agent vscode
opencode	hmg init --agent opencode
Continue	hmg init --agent continue
Cline	hmg init --agent cline
Roo Code	hmg init --agent roo-code
Windsurf	hmg init --agent windsurf
Zed	hmg init --agent zed
Aider	hmg init --agent aider
OpenHands	hmg init --agent openhands
Goose	hmg init --agent goose
Gemini CLI	hmg init --agent gemini-cli
Qwen Code	hmg init --agent qwen-code
OpenClaw	hmg init --agent openclaw
Hermes	hmg init --agent hermes
Any MCP client	hmg init --agent generic-mcp

Run hmg doctor to verify every adapter's lifecycle wiring, store path, and MCP readiness, or hmg integrations detect to see which agents are installed in your environment.

SDKs

# Python
pip install hmg-sdk

import hmg
client = hmg.HmgClient()
client.memorize("key decision: use Rust for perf")

# TypeScript
npm install @hmg_ai/sdk-ts

import { HmgClient } from "@hmg_ai/sdk-ts";
const client = new HmgClient();
await client.memorize({ content: "decision noted" });

What's in This Repository

This repository holds the public artifacts for HMG — everything you need to install, integrate, verify, and implement compatible protocols. The memory intelligence engine itself is proprietary.

Path	What it is
protocol/	hmg-protocol (Apache-2.0) — standalone crate defining all memory types & serialization
mcp/schemas/	MCP tool definitions for all 49 public tools
openapi/	HTTP API specification
sdk-python/ · sdk-ts/	Official Python and TypeScript SDKs
certification/	Conformance tests for compatible implementations
docs/	Multilingual documentation (10 languages) + live site
scripts/	Installers — install.sh, install.ps1

Documentation

Getting Started	Install → first memory in 5 minutes
Concepts	Memory atoms, correction, governance, scope
API Reference	MCP tools and HTTP endpoints
Architecture	System overview
FAQ	Common questions
Upgrade Guide	Version-to-version migration notes

Links

• Website: hmg1ai.com
• Docs: hmg-ai.github.io/HMG-public
• Releases: GitHub Releases
• Issues: GitHub Issues
• Security: GitHub Security
• Contributing: CONTRIBUTING.md

License

HMG uses a two-tier license model:

• Protocol & SDK artifacts (this repo): Apache-2.0 — open, implementable, verifiable
• Community Edition binary: LICENSE-COMMUNITY — free to use, no redistribution
• Memory intelligence engine: proprietary (HMG Proprietary Source License)

Copyright © HMG AI, Inc.