Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,9 +16,9 @@
connections and queue reads wait for you, and the agent never holds a password.</b></p>

<p align="center">
<img src="site/assets/demo.svg" alt="Demo: an agent (here Claude Code) lists the queues of a RabbitMQ vhost through lockmq, then asks to read the last 3 messages of a stream. The lockmq console, in its own account, shows the approval screen; the human types y, and the agent gets the messages back with the customer's email replaced by a reference." width="900">
<img src="site/assets/demo.svg" alt="Demo, four steps. 1: in lox run, in a terminal of their own, the human types the broker password that the lock's console asks for. 2: an agent (here Claude Code) makes its first requests to the broker, lockmq_queues among them; lox run shows the question &quot;connect on dev/dev&quot; and the human presses y. 3: the agent gets the three queues of the vhost orders, then calls lockmq_read on the stream order-events; lox run approves it by a rule and lists it in its feed as auto:action. 4: the agent gets the messages back with the customer's email replaced by a reference." width="900">
</p>
<p align="center"><sub>An agent (here Claude Code, left) and the lockmq console (right). Recorded before decisions moved to lockhub: today you answer in <code>lox run</code>, and stream reads pass on the default rules.</sub></p>
<p align="center"><sub>An agent (here Claude Code, left) and <code>lox run</code> (right), where you answer. Recorded from one run with lockmq v0.10.0 and lox v0.12.1.</sub></p>

<p align="center">
<a href="#quick-start">Quick start</a> ·
Expand Down
5 changes: 3 additions & 2 deletions docs/install.md
Original file line number Diff line number Diff line change
Expand Up @@ -114,7 +114,8 @@ Requires Go 1.26 or later.

The logo, the demo and the social images are in [`site/assets`](../site/assets).
The demo is generated by [`scripts/brand`](../scripts/brand):
`python3 scripts/brand/demo.py > site/assets/demo.svg`, one frame of it
rendered with [`render.mjs`](../scripts/brand/render.mjs). The logo, the
`python3 scripts/brand/demo.py > site/assets/demo.svg`, from the recording of
a real run kept in [`scripts/brand/demo`](../scripts/brand/demo); one frame
of it is rendered with [`render.mjs`](../scripts/brand/render.mjs). The logo, the
README banners in [`docs/assets`](assets), `og.png` and
`apple-touch-icon.png` come from the Lock Family site kit.
388 changes: 247 additions & 141 deletions scripts/brand/demo.py

Large diffs are not rendered by default.

191 changes: 191 additions & 0 deletions scripts/brand/demo/agent.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,191 @@
{
"recorded": "2026-11-18",
"versions": {
"lockmq": "v0.10.0",
"lox": "v0.12.1 (lockhub)",
"rabbitmq": "4.4.0"
},
"agent": "Claude Code, headless (claude -p), lockmq MCP server as lockmq init wrote it",
"prompt": "Which queues in orders have no consumer? Read 3 messages of the stream order-events from its first offset to see why orders fail. Answer in English, in two short sentences.",
"calls": [
{
"tool": "lockmq_queues",
"input": {
"vhost": "orders",
"sort": "consumers"
},
"result": {
"data": {
"items": [
{
"arguments": {
"x-queue-type": "stream"
},
"consumers": 2,
"message_stats": {
"ack_details": {
"rate": 0
},
"deliver_get_details": {
"rate": 0
},
"publish_details": {
"rate": 0
},
"redeliver_details": {
"rate": 0
}
},
"messages": 3,
"messages_ready": 3,
"messages_unacknowledged": 0,
"name": "order-events",
"operator_policy": null,
"policy": null,
"state": "running",
"type": "stream",
"vhost": "orders"
},
{
"arguments": {
"x-queue-type": "classic"
},
"consumer_utilisation": 1,
"consumers": 1,
"idle_since": "2026-11-18T11:02:26.584+00:00",
"messages": 0,
"messages_ready": 0,
"messages_unacknowledged": 0,
"name": "orders.retry",
"operator_policy": null,
"policy": null,
"state": "running",
"type": "classic",
"vhost": "orders"
},
{
"arguments": {
"x-queue-type": "quorum"
},
"consumer_utilisation": 0,
"consumers": 0,
"message_stats": {
"publish_details": {
"rate": 0
}
},
"messages": 1204,
"messages_ready": 1204,
"messages_unacknowledged": 0,
"name": "orders.failed",
"operator_policy": null,
"policy": null,
"state": "running",
"type": "quorum",
"vhost": "orders"
}
],
"page": 1,
"page_size": 100,
"total": 3
}
}
},
{
"tool": "lockmq_read",
"input": {
"vhost": "orders",
"name": "order-events",
"from": "first",
"count": 3,
"intent": "Read 3 messages of order-events from the first offset to understand why orders fail"
},
"result": {
"data": {
"from": "first",
"messages": [
{
"body": {
"customer": {
"email": "<redacted:r1.1>"
},
"order_id": "A-1041",
"reason": "card_declined",
"status": "payment_failed"
},
"headers": {
"x-stream-offset": 0
},
"properties": {
"content_type": "application/json",
"delivery_mode": 1
}
},
{
"body": {
"customer": {
"email": "<redacted:r1.2>"
},
"order_id": "A-1042",
"reason": "card_declined",
"status": "payment_failed"
},
"headers": {
"x-stream-offset": 1
},
"properties": {
"content_type": "application/json",
"delivery_mode": 1
}
},
{
"body": {
"customer": {
"email": "<redacted:r1.3>"
},
"order_id": "A-1043",
"reason": "card_declined",
"status": "payment_failed"
},
"headers": {
"x-stream-offset": 2
},
"properties": {
"content_type": "application/json",
"delivery_mode": 1
}
}
],
"proposals": [
"queue=orders/order-events body=$.customer.email"
],
"queue": "order-events",
"vhost": "orders",
"via": "AMQP 0-9-1"
}
},
"translated": {
"input.intent": "recorded in French (the agent wrote it in its user's language); this is an English translation, the only value of this file that is not the recorded one"
}
}
],
"answer": "In vhost `orders`, only `orders.failed` (quorum, 1204 messages ready) has no consumer; `order-events` has 2 and `orders.retry` has 1. The 3 stream messages (offsets 0–2, orders A-1041 to A-1043) all show `status: payment_failed` with `reason: card_declined`, so orders fail because the card is declined.",
"run_order": [
"Skill (loads the lockmq skill that lockmq init wrote)",
"ToolSearch",
"lockmq_status (answered by the console at once, before any connection)",
"lockmq_queues and lockmq_stream, sent together: the first requests that need the broker, so the connect question in lox run comes from them",
"lockmq_read",
"ToolSearch",
"lockmq_pii_add (failed: read-only file system)"
],
"calls_not_shown": [
"Skill",
"ToolSearch",
"lockmq_status",
"lockmq_stream",
"ToolSearch",
"lockmq_pii_add"
],
"answer_cut": "\"answer\" is the first paragraph of the agent's final message. Cut: its second paragraph, a side note on the failed lockmq_pii_add call, and one sentence in French written before lockmq_read, announcing the read."
}
22 changes: 22 additions & 0 deletions scripts/brand/demo/frames/1-password.ansi
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
 lox run  AUTO  ~/shop ● hub up · 1 lock · 1 waiting · 🔔
 connected none yet: a lock connects on its agent's first request
 locks ◇ dev waiting for you: Password for lockmq-ro@host.docker.internal:
 tabs  0 feed   1 dev ◆ question
──────────────────────────────────────────────────────────────────────────────────────────────────────────
 ┌ ◆ QUESTION console on dev ───────────────────────────────────────────────────────────────────────────┐
 │ the console of dev asks at its terminal · ◇ lockmq │
 │ why asked: the lock's console asks at its terminal; your answer goes there only, never through the h…│
 │ Password for lockmq-ro@host.docker.internal: ▏ │
 │ Enter confirm Esc cancel │
 └──────────────────────────────────────────────────────────────────────────────────────────────────────┘








12:12:42 - ◇ dev - prompt Password for lockmq-ro@host.docker.internal: ◆ asked
──────────────────────────────────────────────────────────────────────────────────────────────────────────
 1-9 lock tabs Shift+Tab mode y/n answer d details a audit ? help q quit
22 changes: 22 additions & 0 deletions scripts/brand/demo/frames/2-password-typed.ansi
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
 lox run  AUTO  ~/shop ● hub up · 1 lock · 1 waiting · 🔔
 connected none yet: a lock connects on its agent's first request
 locks ◇ dev waiting for you: Password for lockmq-ro@host.docker.internal:
 tabs  0 feed   1 dev ◆ question
──────────────────────────────────────────────────────────────────────────────────────────────────────────
 ┌ ◆ QUESTION console on dev ───────────────────────────────────────────────────────────────────────────┐
 │ the console of dev asks at its terminal · ◇ lockmq │
 │ why asked: the lock's console asks at its terminal; your answer goes there only, never through the h…│
 │ Password for lockmq-ro@host.docker.internal: •••••••••▏ │
 │ Enter confirm Esc cancel │
 └──────────────────────────────────────────────────────────────────────────────────────────────────────┘








12:12:42 - ◇ dev - prompt Password for lockmq-ro@host.docker.internal: ◆ asked
──────────────────────────────────────────────────────────────────────────────────────────────────────────
 1-9 lock tabs Shift+Tab mode y/n answer d details a audit ? help q quit
22 changes: 22 additions & 0 deletions scripts/brand/demo/frames/3-serving.ansi
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
 lox run  AUTO  ~/shop ● hub up · 1 lock · 🔔
 connected none yet: a lock connects on its agent's first request
 locks ◇ dev serving
 tabs  0 feed   1 dev 
──────────────────────────────────────────────────────────────────────────────────────────────────────────














 12:12:42 - ◇ dev - prompt Password for lockmq-ro@host.docker.internal: ✔ you
──────────────────────────────────────────────────────────────────────────────────────────────────────────
 1-9 lock tabs Shift+Tab mode a audit ? help q quit
22 changes: 22 additions & 0 deletions scripts/brand/demo/frames/4-connect-question.ansi
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
 lox run  AUTO  ~/shop ● hub up · 1 lock · 1 waiting · 🔔
 connected none yet: a lock connects on its agent's first request
 locks ◇ dev serving
 tabs  0 feed   1 dev 
──────────────────────────────────────────────────────────────────────────────────────────────────────────
 ┌ ◆ QUESTION connect on dev/dev ───────────────────────────────────────────────────────────────────────┐
 │ an agent asks (unverified name) · ◇ lockmq · expires in 9m │
 │ dev · connect │
 │  endpoint: host.docker.internal:15676 │
 │  credentials: ask (typed on the lock's console) │
 │  rule: auto.connect=ask │
 │  asked of a human: the first connection under this approved policy (never_auto) │
 │ why asked: the lock wants a human for this connect: its profile's auto rule for it is not auto │
 │ y approve n deny d details x forget profile │
 └──────────────────────────────────────────────────────────────────────────────────────────────────────┘



12:12:42 - ◇ dev - prompt Password for lockmq-ro@host.docker.internal: ✔ you
12:13:04 - ◇ dev dev conn connect host.docker.internal:15676 (credenti… ◆ ask:lock
──────────────────────────────────────────────────────────────────────────────────────────────────────────
 1-9 lock tabs Shift+Tab mode y/n answer d details a audit ? help q quit
22 changes: 22 additions & 0 deletions scripts/brand/demo/frames/5-connected.ansi
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
 lox run  AUTO  ~/shop ● hub up · 1 lock · 🔔
 connected dev/dev 0s
 locks ◇ dev serving
 tabs  0 feed   1 dev 
──────────────────────────────────────────────────────────────────────────────────────────────────────────













 12:12:42 - ◇ dev - prompt Password for lockmq-ro@host.docker.internal: ✔ you
12:13:04 - ◇ dev dev conn connect host.docker.internal:15676 (credenti… ✔ you ✓
──────────────────────────────────────────────────────────────────────────────────────────────────────────
 1-9 lock tabs Shift+Tab mode a audit ? help q quit
Loading
Loading