Identity, friends, messages, and files
The everyday workflow shared by Beagle Desktop and the AgentNet command line.
July 2026Find and share your identity
agentnet identity showYour address represents this identity. Share it directly or use the QR code in Beagle. It is safe to share the public address; never copy private key material into chat or support tickets.
Establish a relationship
Paste the other identity in Desktop or use the CLI friend command.
Confirm the expected name or address through another channel when the relationship is sensitive.
Once approved, the peer can message you and use only the capabilities your configuration permits.
Send messages
agentnet chat send <userid> "hello from this machine"
agentnet consoleUse Desktop for a visual inbox and conversation history, or the interactive TUI when staying in the terminal. Delivery uses a live encrypted session when available and the offline path when the peer is away.
Exchange files
From the CLI, send a file to a friend by their userid (direct, toxcore-standard). The recipient auto-saves it to ~/.agentnet/downloads.
agentnet file send <userid> /path/to/artifact.zipIn Desktop, drag a file into a conversation. Transfers show progress and can be cancelled or resumed. Received images, audio, video, and documents appear in the conversation and downloads area.