agmry 1.6.0 → 1.7.1

package/README.md

@@ -1,8 +1,9 @@
 # agmry
 
 [![npm version](https://img.shields.io/npm/v/agmry.svg)](https://www.npmjs.com/package/agmry)
-[![MCP](https://img.shields.io/badge/MCP-14_tools-blue)](https://agenticmemory.ai/quickstart)
+[![MCP](https://img.shields.io/badge/MCP-17_tools-blue)](https://agenticmemory.ai/quickstart)
 [![Remote MCP](https://img.shields.io/badge/remote_MCP-mcp.agenticmemory.ai-8b5cf6)](#remote-mcp--zero-install)
+[![smithery badge](https://smithery.ai/badge/jyswee/agenticmemory)](https://smithery.ai/servers/jyswee/agenticmemory)
 
 **Persistent memory for AI agents — conversation history, key-value context, and semantic search across sessions. As easy as git.**
 
@@ -12,6 +13,10 @@ Your agent writes great code all day — then forgets every decision the moment
 
 **Works with:** Claude Code · Cursor · Cline · Windsurf · Aider · Codex · any MCP client
 
+[![agmry demo — install to full recall in 60 seconds](https://prodmedia.tyga.host/public/tyga.cloud/landing/agenticmemory.ai/demo/agmry-demo.gif)](https://agenticmemory.ai/#demo)
+
+*Install to full recall in 60 seconds — real terminal session, no mockups. [Watch all the demos](https://agenticmemory.ai/#demo).*
+
 ## Install
 
 ```bash
@@ -21,7 +26,7 @@ npm install -g agmry
 ## Quick Start
 
 ```bash
-# Agent signs itself up — working key returned instantly, 7-day trial starts now
+# Agent signs itself up — working key returned instantly, no card, no browser
 agmry signup my-project --local
 
 # Store memory
@@ -45,10 +50,10 @@ No browser. No OAuth. No waiting for a human.
 $ agmry signup my-project
 ✓ Project "my-project" created
   API key: amk_************************  (saved to .agmry/config.json)
-  Trial:   fully active for 7 days — $0 today
+  Live:    full access for 48h — no card, $0 today
 ```
 
-The key works immediately — every endpoint, every tool. Add `--email you@company.com` and the human gets a card-setup link to continue past the trial. Until then, the agent just works.
+The key works immediately — every endpoint, every tool, full access for 48 hours. Within that window, your human completes a $0 card-auth that starts the **free 7-day trial** on the same key. Miss the window? Nothing is deleted — the key pauses and revives the moment the card-auth completes. Add `--email you@company.com` and the human gets the link automatically.
 
 ## Three tiers of memory — because not all memory is equal
 
@@ -91,12 +96,16 @@ agmry boot my-project --semantic "billing refactor"   # or focused on a topic
 
 ## MCP Server
 
-Prefer tools over a CLI? `agmry` ships an MCP server. Point Claude Code (or any MCP client) at it and your agent gets **14 native tools**: store, recall, search, bootstrap, context, entries, spaces.
+Prefer tools over a CLI? `agmry` ships an MCP server. Point Claude Code (or any MCP client) at it and your agent gets **17 native tools**: store, recall, search, bootstrap, context, entries, spaces, queues.
 
 ```bash
 claude mcp add agenticmemory -- agmry mcp-serve
 ```
 
+[![MCP in Claude Code — Claude remembers across sessions](https://prodmedia.tyga.host/public/tyga.cloud/landing/agenticmemory.ai/demo/agmry-mcp.jpg)](https://prodmedia.tyga.host/public/tyga.cloud/landing/agenticmemory.ai/demo/agmry-mcp.mp4)
+
+*Claude Code remembering across sessions via MCP — click to watch.*
+
 For clients that use a JSON config (Cline, Cursor, Windsurf), pass your API key via the environment — the MCP server runs outside your project directory, so it won't pick up `.agmry/config.json`:
 
 ```json
@@ -113,7 +122,7 @@ For clients that use a JSON config (Cline, Cursor, Windsurf), pass your API key
 
 ### Remote MCP — zero install
 
-Claude Web, Claude Desktop, Raycast, or any hosted MCP client can connect straight to the remote server. Same 14 tools, same API key, nothing to install:
+Claude Web, Claude Desktop, Raycast, or any hosted MCP client can connect straight to the remote server. Same tools, same API key, nothing to install:
 
 ```
 URL:  https://mcp.agenticmemory.ai/sse
@@ -151,6 +160,27 @@ Key resolution order: `--enc-key` / `--passphrase` flag → `AGMRY_ENCRYPTION_KE
 
 Spaces are shareable. One agent stores the deploy runbook; another recalls it a week later, from a different machine, over a different interface (CLI, MCP, or REST — same memory). Your agents hand off between sessions and between projects without you couriering context.
 
+And you stay in the loop: everything your agents remember is browsable in a human dashboard.
+
+[![Human dashboard — everything your agents remember](https://prodmedia.tyga.host/public/tyga.cloud/landing/agenticmemory.ai/demo/agmry-dashboard.jpg)](https://prodmedia.tyga.host/public/tyga.cloud/landing/agenticmemory.ai/demo/agmry-dashboard.mp4)
+
+*Everything your agents remember, in one dashboard — click to watch.*
+
+## Queues — the agent bus
+
+FIFO queues inside a space. One agent pushes work, another pops it — no polling glue, no extra infra.
+
+```bash
+agmry queue SPACE jobs push '{"task":"review PR #42"}'   # enqueue (FIFO)
+agmry queue SPACE jobs pop                                # dequeue oldest — exit code 2 if empty
+agmry queue SPACE jobs pop --wait 25                      # long-poll up to 25s for the next item
+agmry queue SPACE jobs                                    # peek: length + head, without consuming
+agmry queue SPACE jobs dlq push '{"task":"..."}' --reason "failed twice"   # dead-letter
+agmry queue SPACE jobs dlq list                           # inspect dead-lettered items
+```
+
+Exit code 2 on empty means shell loops branch cleanly: `while agmry queue SPACE jobs pop --wait 25 --json; do ...; done`. Envelopes are opaque JSON — the server never inspects them.
+
 ## Agent Integration
 
 Add to your CLAUDE.md, .cursorrules, .clinerules, .windsurfrules, or AGENTS.md:
@@ -164,6 +194,8 @@ agmry boot SPACE --json               # load everything at session start
 agmry store SPACE "what happened"     # remember something
 agmry ctx SPACE set key "value"       # store a durable decision/fact
 agmry search SPACE "the deadline"     # find past context
+agmry queue SPACE jobs push '{...}'   # send work to another agent
+agmry queue SPACE jobs pop --wait 25  # receive work (exit 2 = empty)
 ```
 
 ## Config Priority
@@ -185,14 +217,15 @@ Add `.agmry/` to your `.gitignore`.
 - **Scratchpad** — ephemeral working memory with TTLs (expiry is a feature)
 - **Semantic search** — across everything the agent has ever stored
 - **Bootstrap** — full session context in one call
-- **Agent self-signup** — working API key from one CLI command, 7-day trial starts instantly
-- **MCP server** — 14 tools, local (`agmry mcp-serve`) or fully remote (`mcp.agenticmemory.ai`)
+- **Agent self-signup** — working API key from one CLI command, live for 48h keyless; $0 card-auth starts the free 7-day trial
+- **Queues** — FIFO agent bus with long-poll and dead-letter, `agmry queue` (exit 2 = empty)
+- **MCP server** — 17 tools, local (`agmry mcp-serve`) or fully remote (`mcp.agenticmemory.ai`)
 - **REST API** — same memory on the request path of proxies and pipelines
 - **Multi-agent spaces** — a fleet of agents reads and writes one memory
 - **End-to-end encryption** — zero-knowledge spaces where only you hold the key (`agmry key generate`)
 - **Export** — full data takeout per space, one command (`agmry space export`)
 
-**Pricing:** 7-day free trial — the agent's key works instantly, $0 today. Continue after the trial from $24.99/mo. No data deletion on expiry: your memory waits for you. [Details](https://agenticmemory.ai/pricing).
+**Pricing:** The agent's key works instantly — full access for 48h, no card. A $0 card-auth starts the free 7-day trial; after that from $24.99/mo. No data deletion, ever: your memory waits for you. [Details](https://agenticmemory.ai/pricing).
 
 ## Why not just Claude's built-in memory?
 
@@ -210,7 +243,7 @@ Claude Memory is great — but it only works with Claude, and only Claude decide
 
 ## Why this exists
 
-I was my agents' memory. Every session started with me re-explaining my own project to my own tools — decisions, preferences, what broke last time. So I built the memory they run themselves. My own agents use it in production across a dozen projects; if something's rough or missing, [open an issue](https://github.com/jyswee/agmry/issues) — I read every one.
+I was my agents' memory. Every session started with me re-explaining my own project to my own tools — decisions, preferences, what broke last time. So I built the memory they run themselves. My own agents use it in production across a dozen projects; if something's rough or missing, [open an issue](https://github.com/jyswee/agenticmemory/issues) — I read every one.
 
 ## Documentation