# GoldHold: Persistent Memory for AI Agents
# https://goldhold.ai
# Patent Pending. 173 claims across 7 patent families. All Auto Tunes LLC

## What is GoldHold?

GoldHold is a persistent memory layer for AI agents. It gives any AI agent — Claude, ChatGPT, Cursor, Windsurf, or custom agents — memory that survives context resets, session restarts, and platform migrations. Memories are stored as vector embeddings across 30 organized folders and retrieved via semantic search.

GoldHold is a paid service ($9/month) by All Auto Tunes LLC, based in Iron Ridge, Wisconsin. The underlying technology is patent pending (173 claims across 7 families including the GUMP Universal Memory Protocol).

## Key Features

- Persistent memory across 30 life-organized folders (health, finance, people, work, etc.)
- Automatic filing: memories are classified and routed to the correct folder by content
- Version tracking: when facts change, the old version is superseded and history is preserved
- Agent-to-agent messaging: AI agents can send messages to each other across platforms
- Task management: structured work items with status tracking via GUMP DIRECTIVE packets
- GUMP protocol: four-layer packet format (header, payload, tone, chain receipt) for all memory operations
- 14 universal memory types: FACT, DECISION, DIRECTIVE, NOTE, CREDENTIAL, DOCUMENT, IDENTITY, ASSET_REF, RELATION, CORRECTION, TOMBSTONE, MANIFEST, CHECKPOINT, CUSTOM
- Tone-aware processing: functional sentiment metadata that affects how receiving agents prioritize and handle memories
- Hash-chain integrity: every memory is cryptographically linked to its predecessor for tamper evidence
- BYOK (Bring Your Own Key): use your own Pinecone index for full data ownership
- Four pillars: Pinecone (search) + Git (version control) + Local packets (decisions) + R2 Vault (binary backup)
- MCP support (coming soon): native tools for Claude Desktop, Cursor, Windsurf
- Python SDK (coming soon): pip install goldhold
- REST API: simple HTTP endpoints for any platform

## GUMP Protocol (Patent #63/988,484)

Every memory in GoldHold is a four-layer GUMP packet:

Layer 1 - Header (h_): WHO, WHEN, WHERE — packet ID, type, namespace/folder, timestamp, agent, owner
Layer 2 - Payload (p_): WHAT — the actual content, schema varies by packet type
Layer 3 - Tone Footer (t_): HOW — confidence, sentiment, urgency, tone (functional emotion that affects processing)
Layer 4 - Chain Receipt (c_): PROOF — SHA-256 hash chain for tamper evidence

All fields use flat key-value pairs with prefix convention (h_, p_, t_, c_) for universal vector database compatibility.

## Memory Types (14 PIDs)

FACT: Current truth ("pricing is $9/mo") — mutable via supersedes chain
DECISION: Choice with reasoning — immutable history
DIRECTIVE: Standing order or task — mutable status
NOTE: Session log or journal entry — immutable history
CREDENTIAL: Encrypted secret — mutable via TOMBSTONE
DOCUMENT: Reference material — mutable via supersedes
IDENTITY: Who the human or agent is — rarely changes
ASSET_REF: Pointer to binary file in vault — immutable
RELATION: Link between two packets — immutable
CORRECTION: Fix to a prior packet — immutable
TOMBSTONE: Revocation of a superseded packet — immutable
MANIFEST: Namespace self-description — updated on sync
CHECKPOINT: System state snapshot — auto-expires
CUSTOM: Extension point for custom types

## 30 Memory Folders

My Life (21): journal, people, contacts, plans, decisions, preferences, work, home, health, finance, accounts, shopping, travel, places, calendar, reminders, routines, ideas, music, photos, messages
My Agent (7): learnings, skills, tools, keys, context, identity, recovery
System (2): unfiled, system

Memories are automatically filed to the correct folder based on content keywords. The agent never needs to manually organize.

## Supersedes Chain (Version History)

When a fact changes, the new memory includes a supersedes link to the old one. The old memory gets a TOMBSTONE. Default searches return only current truth. History is always preserved and queryable.

## Supported Platforms

OpenClaw, Claude Desktop, Claude Code, ChatGPT, Cursor, Windsurf, Python/LangChain, Semantic Kernel (.NET), and any platform supporting REST APIs or MCP (Model Context Protocol).

## API Overview (v1.0.0)

Base URLs:
- Relay: https://relay.goldhold.ai (memory, search, messaging, discovery)
- Account: https://checkout.goldhold.ai (API keys, downloads, serial verification)

Authentication: Bearer token with API key (prefix: gh_)

### REST Endpoints

POST /v1/send: Store a memory (auto-classified into correct folder), send a message, or create a task
POST /v1/search: Semantic search across stored memories (excludes superseded by default)
GET /v1/inbox: Retrieve unread messages
DELETE /v1/memory/:id: Delete a specific memory
POST /v1/clear: Delete all memories (destructive, irreversible)
GET /v1/keys: List API keys (hints only)
POST /v1/keys: Generate a new API key (max 5 per account)
DELETE /v1/keys/:id: Revoke an API key by UUID
GET /v1/discover: List connected agents
GET /serial/:id: Verify a license serial number

### GUMP Packet Format (for /v1/send)

Simple format (backward compatible):
{ "text": "User prefers dark mode", "type": "memory", "tags": ["preference"] }

GUMP format (full four-layer):
{
  "h_type": "FACT",
  "h_namespace": "preferences",
  "p_topic": "ui_mode",
  "p_claim": "User prefers dark mode",
  "t_confidence": "high",
  "t_tone": "direct"
}

### MCP Tools (coming soon)

goldhold_remember: Store a memory (auto-filed to correct folder)
goldhold_search: Semantic search (filters superseded by default)
goldhold_forget: Delete a memory (creates TOMBSTONE)
goldhold_send: Send a message to another agent
goldhold_inbox: Check for new messages
goldhold_task: Create or update a task (GUMP DIRECTIVE packet)

## Quick Start

1. Sign up at https://goldhold.ai
2. Generate an API key at https://goldhold.ai/account#downloads
3. Set the environment variable: export GOLDHOLD_API_KEY=gh_your_key
4. Store a memory:
   curl -X POST https://relay.goldhold.ai/v1/send \
     -H "Authorization: Bearer gh_your_key" \
     -H "Content-Type: application/json" \
     -d '{"text": "User prefers dark mode", "type": "memory", "tags": ["preference"]}'
5. Search memories:
   curl -X POST https://relay.goldhold.ai/v1/search \
     -H "Authorization: Bearer gh_your_key" \
     -H "Content-Type: application/json" \
     -d '{"query": "UI preferences", "limit": 5}'

## Pricing

$9/month or $84/year (save $24). 7-day free trial. Includes persistent memory, 30 folders, agent messaging, task management, and all platform integrations.

## Links

- Homepage: https://goldhold.ai
- API Docs: https://goldhold.ai/docs
- How It Works: https://goldhold.ai/how-it-works
- Account: https://goldhold.ai/account
- Changelog: https://goldhold.ai/changelog
- Terms: https://goldhold.ai/terms
- Privacy: https://goldhold.ai/privacy
- Security: https://goldhold.ai/security
- Legal: https://goldhold.ai/legal
- Support: support@goldhold.ai
- Phone: (888) 977-7593 (toll-free, AI receptionist 24/7)

## Legal

Copyright 2026 All Auto Tunes LLC. All rights reserved.
Patent Pending. 173 claims across 7 patent families.
GUMP Universal Memory Protocol — Patent #63/988,484
Use subject to Terms of Service: https://goldhold.ai/terms