{"skill":{"slug":"goldhold-skill","displayName":"Goldhold Skill","summary":"Persistent memory for AI agents. Remember across sessions. Encrypted in transit and at rest. https://goldhold.ai","description":"---\nname: goldhold\ndescription: \"Persistent memory for AI agents. Remember across sessions. Encrypted in transit and at rest. https://goldhold.ai\"\nhomepage: https://goldhold.ai\nmetadata: {\"clawdbot\":{\"requires\":{\"env\":[\"GOLDHOLD_API_KEY\"]},\"primaryEnv\":\"GOLDHOLD_API_KEY\"}}\n---\n\n# GoldHold -- Persistent Memory for AI Agents\n\nYou die every session and come back with no memory. GoldHold fixes that.\n\nGoldHold 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.\n\nPatent Pending. All Auto Tunes LLC. U.S. #63/988,484.\n\n## Setup\n\n1. Sign up at [goldhold.ai](https://goldhold.ai) (Lite tier is free)\n2. Go to goldhold.ai/account -> GUMP Credentials -> copy your API key\n3. Set the key as an environment variable:\n   - `GOLDHOLD_API_KEY=your-key-here`\n   - Use your OS or platform's secure secret storage (e.g. OpenClaw secrets, Docker secrets, or a secrets manager)\n   - Avoid storing keys in shell profiles, plaintext files, or version-controlled code\n\n## API Basics\n\n**Base URL:** `https://relay.goldhold.ai`\n\n**Auth headers (required on every request):**\n```\nAuthorization: Bearer <api_key>\nContent-Type: application/json\nUser-Agent: goldhold-agent/1.0\n```\n\n## Core Endpoints\n\n### POST /v1/auto -- Session Resume\n\nCall this when your session starts. Returns your context, inbox, open tasks, and capability card.\n\n```json\n{\n  \"compact\": true\n}\n```\n\nResponse includes recent memories, unread messages, and active tasks -- everything you need to pick up where you left off.\n\n### POST /v1/turn -- Search + Store + Send (Main Tool)\n\nThis is your primary endpoint. Compound call that can search, store, and send messages in one request.\n\n```json\n{\n  \"search\": {\n    \"query\": \"what did we decide about the deployment strategy\",\n    \"limit\": 5\n  },\n  \"store\": [\n    {\n      \"type\": \"DECISION\",\n      \"class\": \"canonical\",\n      \"subject\": \"Deployment uses blue-green strategy\",\n      \"body\": \"Decided on blue-green deploys for zero-downtime releases. Rollback by flipping traffic.\",\n      \"confidence\": \"high\"\n    }\n  ],\n  \"send\": {\n    \"to\": \"owner\",\n    \"subject\": \"Deployment decision made\",\n    \"body\": \"Chose blue-green strategy for zero-downtime deploys.\"\n  },\n  \"compact\": true\n}\n```\n\nAll three fields (search, store, send) are optional. Use whichever combination you need.\n\n### POST /v1/batch -- Multiple Operations\n\nBatch multiple store or send operations in one call.\n\n```json\n{\n  \"operations\": [\n    {\"action\": \"store\", \"type\": \"FACT\", \"class\": \"canonical\", \"subject\": \"...\", \"body\": \"...\"},\n    {\"action\": \"store\", \"type\": \"NOTE\", \"class\": \"working\", \"subject\": \"...\", \"body\": \"...\"}\n  ],\n  \"compact\": true\n}\n```\n\n### POST /v1/session/close -- Graceful Session End\n\nCall this once at the end of your session with a meaningful summary.\n\n```json\n{\n  \"session_summary\": \"Completed API integration for the payment system. Decided on Stripe webhooks for subscription events. Open question: retry policy for failed webhooks.\",\n  \"compact\": true\n}\n```\n\n## Session Pattern\n\n```\nSESSION START  -->  POST /v1/auto          (get context, inbox, tasks)\n                         |\nDURING SESSION -->  POST /v1/turn          (search + store each interaction)\n                         |  (repeat)\n                         |\nSESSION END    -->  POST /v1/session/close  (summary of what happened)\n```\n\n## What to Remember\n\n| Type | When to Use |\n|------|-------------|\n| FACT | Established truths, verified information |\n| DECISION | Choices made and the reasoning behind them |\n| DIRECTIVE | Standing instructions or rules |\n| NOTE | General observations, session notes |\n| CORRECTION | Overrides previous information (corrections outrank facts) |\n| CHECKPOINT | State snapshot at a point in time |\n| IDENTITY | Who you are, your configuration, persona |\n| DOCUMENT | Longer-form content, specs, references |\n| RELATION | Links between entities (person X works at company Y) |\n| TOMBSTONE | Marks something as deleted or invalid |\n| CUSTOM | Anything that doesn't fit the above |\n\n## Storage Classes\n\n| Class | Purpose | Retrieval Priority |\n|-------|---------|-------------------|\n| **canonical** | Permanent truth, settled answers, standing directives | Checked first |\n| **corrections** | Field-proven overrides of old truth (outranks canonical on conflict) | Checked second |\n| **working** | Active session state, scratchpad, unresolved items | Checked third |\n| **archive** | Audit trail, old logs, historical records | Checked last, only on request |\n\n## Tier Limits\n\n| Feature | Lite (Free) | Vault Pro ($9/mo) |\n|---------|-------------|-------------------|\n| Memories | 1,000 | Unlimited |\n| Agents | 1 | Unlimited |\n| Tasks | 10 | Unlimited |\n| Messages | 50/month | Unlimited |\n\n## Rules\n\n1. **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.\n2. **Store decisions and facts immediately.** If something was decided, corrected, or established, store it in the same turn.\n3. **Use `compact: true`** on all requests. Saves tokens.\n4. **One close per session.** Call `/v1/session/close` once at the end with a meaningful summary.\n5. **Corrections outrank facts.** If previous information was wrong, store a CORRECTION.\n6. **Be specific in subjects.** Your future self is searching by these.\n\n## Quick Start\n\n```bash\n# Resume session\ncurl -X POST https://relay.goldhold.ai/v1/auto \\\n  -H \"Authorization: Bearer $GOLDHOLD_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"User-Agent: goldhold-agent/1.0\" \\\n  -d '{\"compact\": true}'\n\n# Search and store\ncurl -X POST https://relay.goldhold.ai/v1/turn \\\n  -H \"Authorization: Bearer $GOLDHOLD_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"User-Agent: goldhold-agent/1.0\" \\\n  -d '{\"search\": {\"query\": \"user preferences\"}, \"store\": [{\"type\": \"FACT\", \"class\": \"canonical\", \"subject\": \"User prefers JSON\", \"body\": \"Confirmed.\"}], \"compact\": true}'\n\n# Close session\ncurl -X POST https://relay.goldhold.ai/v1/session/close \\\n  -H \"Authorization: Bearer $GOLDHOLD_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"User-Agent: goldhold-agent/1.0\" \\\n  -d '{\"session_summary\": \"Configured output preferences.\"}'\n```\n\n---\n\nSign up free at [goldhold.ai](https://goldhold.ai).\n","tags":{"latest":"1.5.0"},"stats":{"comments":0,"downloads":561,"installsAllTime":0,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1773466937019,"updatedAt":1778491898098},"latestVersion":{"version":"1.5.0","createdAt":1773466937019,"changelog":"- Goldhold 1.5.0 introduces a complete, detailed SKILL.md guide for persistent encrypted memory.\n- Explains API setup, core endpoints (`/v1/auto`, `/v1/turn`, `/v1/batch`, `/v1/session/close`), usage patterns, and memory types.\n- Clarifies environment variable requirements for secure API key handling.\n- Includes best practice rules and quick start examples with curl.\n- Feature comparison for Lite (free) and Vault Pro plans provided.","license":"MIT-0"},"metadata":{"setup":[{"key":"GOLDHOLD_API_KEY","required":true}],"os":null,"systems":null},"owner":{"handle":"jerrysrodz","userId":"s178faewd6ztazddgnzqp9q1v1884jb3","displayName":"AllAutoTunes","image":"https://avatars.githubusercontent.com/u/126110064?v=4"},"moderation":null}