Skip to main content
A share link is a read-only link to one agent. Anyone who has the link opens the agent’s live view in their browser — its timeline, session, and outputs — without a Murmur account and without signing in. Use it to show progress to a stakeholder, customer, or teammate outside your tenant. Each share link grants read access to exactly one agent. It carries no other access: the recipient cannot send follow-ups, change settings, control the VM, open other agents, or see anything else in your tenant. You create share links from the dashboard, on the agent you want to share.
  1. Open the agent in the dashboard.
  2. In the header, open the … menu and choose Share link.
  3. Click Create link.
  4. Copy the link. It is shown once — see The link is shown once below.
The link has this shape:
The ?key= value is the secret that authorizes the read-only view. Anyone with the full link can open the agent, so treat the link like a password. After the page loads, the dashboard removes the key from the browser’s address bar so it does not linger in history. Murmur returns the link’s key a single time — when you create it. The dashboard displays the full link once so you can copy it; Murmur stores only a fingerprint of the key, never the key itself, so it cannot show you the link again. If you lose it, create a new share link. A share link is immutable. You cannot edit one after creating it — create a new link instead.

​
What the recipient sees

Opening a share link shows the agent’s detail view in read-only form, with no sign-in:
  • The timeline of the agent’s lifecycle — phases, commits, pushes, and uploads.
  • The session stream — messages, tool calls, and results.
  • The agent’s outputs and live status, updating as the agent works.
The recipient has no controls: no follow-up composer, no VM actions, no settings, and no navigation to other agents or to the rest of your tenant. Deleting the share link revokes it. The link stops working immediately — anyone who opens it afterward gets an authentication error. A share link has no expiry. It stays valid until you delete it. To revoke access, delete the link with murmur rm share-link (see Revoke a share link below).

​
Fields

Creating a share link requires permission to edit the target agent. You can share any agent you can edit — typically the agents you spawned. See the permission reference for share-link.create and agent.edit.

​
Examples

Share links are named <agent-catalog-name>/<key_id>. List every share link in the tenant with murmur get:
The key itself is not returned — only its metadata.
Deletion is immediate and permanent. The link stops working at once, and there is no undo. To share the agent again, create a new link.

​
Errors