share

share — introduce a contact to a peer

retalk share --peer <recipient> <contact> --dir "<user>/identity"
retalk share --peer <recipient> <contact> --as <nickname> --dir "<user>/identity"

Sends the Contact card for <contact> (a saved name or 32-hex id), encrypted, to <recipient> (a saved name or id you can already message). --as overrides the recommended nickname. Prints {"id","to","shared"}. The recipient gets it as a contact record (staged for import).

Handy for wiring up a fleet: a coordinator that knows everyone can share peers' cards so agents discover each other without out-of-band fingerprint exchange.

<user> = this session's user directory (absolute path; resolved at init).

Next

• import — the peer saves the contact you sent.
• add — save a peer yourself.
• send — message them.