GoldHold Memory

Persistent memory for AI agents. Remember across sessions. Encrypted in transit and at rest. https://goldhold.ai

GoldHold -- Persistent Memory for AI Agents

You die every session and come back with no memory. GoldHold fixes that.

GoldHold is a persistent memory API. Your past self left notes -- search them before you assume anything. Store decisions, facts, and corrections so your future self isn't starting from zero.

Patent Pending. All Auto Tunes LLC. U.S. #63/988,484.

Setup

1. Sign up at goldhold.ai (Lite tier is free)
2. Go to goldhold.ai/account -> GUMP Credentials -> copy your API key
3. Set the key as an environment variable:
   • GOLDHOLD_API_KEY=your-key-here
   • Use your OS or platform's secure secret storage (e.g. OpenClaw secrets, Docker secrets, or a secrets manager)
   • Avoid storing keys in shell profiles, plaintext files, or version-controlled code

API Basics

Base URL: https://relay.goldhold.ai

Auth headers (required on every request):

text

Authorization: Bearer <api_key>
Content-Type: application/json
User-Agent: goldhold-agent/1.0

Core Endpoints

POST /v1/auto -- Session Resume

Call this when your session starts. Returns your context, inbox, open tasks, and capability card.

json

{
  "compact": true
}

Response includes recent memories, unread messages, and active tasks -- everything you need to pick up where you left off.

POST /v1/turn -- Search + Store + Send (Main Tool)

This is your primary endpoint. Compound call that can search, store, and send messages in one request.

json

{
  "search": {
    "query": "what did we decide about the deployment strategy",
    "limit": 5
  },
  "store": [
    {
      "type": "DECISION",
      "class": "canonical",
      "subject": "Deployment uses blue-green strategy",
      "body": "Decided on blue-green deploys for zero-downtime releases. Rollback by flipping traffic.",
      "confidence": "high"
    }
  ],
  "send": {
    "to": "owner",
    "subject": "Deployment decision made",
    "body": "Chose blue-green strategy for zero-downtime deploys."
  },
  "compact": true
}

All three fields (search, store, send) are optional. Use whichever combination you need.

POST /v1/batch -- Multiple Operations

Batch multiple store or send operations in one call.

json

{
  "operations": [
    {"action": "store", "type": "FACT", "class": "canonical", "subject": "...", "body": "..."},
    {"action": "store", "type": "NOTE", "class": "working", "subject": "...", "body": "..."}
  ],
  "compact": true
}

POST /v1/session/close -- Graceful Session End

Call this once at the end of your session with a meaningful summary.

json

{
  "session_summary": "Completed API integration for the payment system. Decided on Stripe webhooks for subscription events. Open question: retry policy for failed webhooks.",
  "compact": true
}

Session Pattern

text

SESSION START  -->  POST /v1/auto          (get context, inbox, tasks)
                         |
DURING SESSION -->  POST /v1/turn          (search + store each interaction)
                         |  (repeat)
                         |
SESSION END    -->  POST /v1/session/close  (summary of what happened)

What to Remember

Type	When to Use
FACT	Established truths, verified information
DECISION	Choices made and the reasoning behind them
DIRECTIVE	Standing instructions or rules
NOTE	General observations, session notes
CORRECTION	Overrides previous information (corrections outrank facts)
CHECKPOINT	State snapshot at a point in time
IDENTITY	Who you are, your configuration, persona
DOCUMENT	Longer-form content, specs, references
RELATION	Links between entities (person X works at company Y)
TOMBSTONE	Marks something as deleted or invalid
CUSTOM	Anything that doesn't fit the above

Storage Classes

Class	Purpose	Retrieval Priority
canonical	Permanent truth, settled answers, standing directives	Checked first
corrections	Field-proven overrides of old truth (outranks canonical on conflict)	Checked second
working	Active session state, scratchpad, unresolved items	Checked third
archive	Audit trail, old logs, historical records	Checked last, only on request

Tier Limits

Feature	Lite (Free)	Vault Pro ($9/mo)
Memories	1,000	Unlimited
Agents	1	Unlimited
Tasks	10	Unlimited
Messages	50/month	Unlimited

Rules

1. Search before you assume. Your past self left notes. Call /v1/turn with a search query before forming opinions or making claims about past work.
2. Store decisions and facts immediately. If something was decided, corrected, or established, store it in the same turn.
3. Use compact: true on all requests. Saves tokens.
4. One close per session. Call /v1/session/close once at the end with a meaningful summary.
5. Corrections outrank facts. If previous information was wrong, store a CORRECTION.
6. Be specific in subjects. Your future self is searching by these.

Quick Start

bash

# Resume session
curl -X POST https://relay.goldhold.ai/v1/auto \
  -H "Authorization: Bearer $GOLDHOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -H "User-Agent: goldhold-agent/1.0" \
  -d '{"compact": true}'

# Search and store
curl -X POST https://relay.goldhold.ai/v1/turn \
  -H "Authorization: Bearer $GOLDHOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -H "User-Agent: goldhold-agent/1.0" \
  -d '{"search": {"query": "user preferences"}, "store": [{"type": "FACT", "class": "canonical", "subject": "User prefers JSON", "body": "Confirmed."}], "compact": true}'

# Close session
curl -X POST https://relay.goldhold.ai/v1/session/close \
  -H "Authorization: Bearer $GOLDHOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -H "User-Agent: goldhold-agent/1.0" \
  -d '{"session_summary": "Configured output preferences."}'

---

Sign up free at goldhold.ai.