OpenMates Docs Open Chat

Embeds & Sharing

Embeds & Sharing View decrypted embed content, create encrypted share links, and search available @mentions. Embeds are rich content blocks (code snippets, s...

[T:documentation.sender_name]

Embeds & Sharing

View decrypted embed content, create encrypted share links, and search available @mentions. Embeds are rich content blocks (code snippets, search results, transcripts, etc.) attached to chat messages.

Viewing an Embed

openmates embeds show <embed-id>
openmates embeds show a3f2b1c4
openmates embeds show a3f2b1c4 --json

Displays the full decrypted content of an embed in the terminal. The embed ID can be a full UUID or the first 8 characters. Embed IDs are shown when viewing chat conversations with openmates chats show.

Remotion Video Create Embeds

videos/create embeds render as terminal-native status cards. While a Remotion render is processing, rendering, or needs_rerender, the CLI refreshes the embed content from the video status endpoint before printing it. Run the command again after rendering finishes to get the rendered video link and QR code.

Sharing an Embed

openmates embeds share <embed-id>
openmates embeds share a3f2b1c4 --expires 604800
openmates embeds share a3f2b1c4 --password mypass
openmates embeds share a3f2b1c4 --json

Creates an encrypted share link for a single embed.

Option Description
--expires <seconds> Link expiration time (0 = no expiry)
--password <pwd> Password-protect the link (max 10 characters)

Sharing a Chat

Chat share links are created via the chats share command. See chats.md for details.

openmates chats share <chat-id>
openmates chats share last --expires 604800 --password mypass

Share links use zero-knowledge encryption. The decryption key is embedded in the URL fragment (after the #), which is never sent to the server. This means:

  • The server stores only encrypted data and cannot read shared content.
  • Anyone with the full URL can decrypt the content.
  • Optional password protection adds a second layer – the recipient must know both the URL and the password.
  • Expiration is enforced server-side by deleting the encrypted blob after the specified duration.

See shareEncryption.ts for the encryption implementation and client-side-encryption.md for the broader architecture.

Mentions

@mentions let you invoke models, mates, skills, or attach files when sending chat messages.

Listing Available Mentions

openmates mentions list
openmates mentions list --type model_alias
openmates mentions list --type skill
openmates mentions list --json
Type Description Examples
model_alias Model shortcuts @Best, @Fast
model Specific AI models @Claude-Opus-4.6, @GPT-5.4
mate AI mates/personas @Sophia, @Finn
skill App skills @Web-Search, @Code-Get-Docs
focus_mode Focus modes @Web-Research
settings_memory Memories @Code-Projects

Searching Mentions

openmates mentions search "web"
openmates mentions search "sophia" --json

Using Mentions in Chat

openmates chats new "@Sophia tell me about React hooks"
openmates chats send --chat abc "@best what's the weather?"
openmates chats new "@Web-Search latest AI news"
openmates chats new "@Code-Projects review my architecture"

File Mentions

Attach local files to chat messages using @/path/to/file or @./relative/path:

openmates chats new "@best review @./src/app.ts"
openmates chats new "@best review @/home/user/project/.env"

Security rules for file mentions:

  • Sensitive files (.env) are scrubbed locally before upload – only variable names and the last 3 characters of values are sent.
  • Private keys (.pem, .key, SSH keys) are blocked by default.

Key Files