​
Requesting Access

  1. Open the macOS app
  2. Click the magnifying glass or “Search org twins…” in the sidebar
  3. Find the twin you want to query
  4. Click “Request”
  5. The twin owner receives a notification

​
Approving Requests

​
Via macOS App

Pending requests appear in the sidebar under “Requests” with accept/decline buttons:
  • ✅ Approve — grants access and notifies the requester
  • ❌ Decline — denies the request

​
Via Telegram

Reply to the access request notification:
  • YES — approves access
  • NO — denies access

​
What Happens on Approval

  1. A twin_access_grants record is created
  2. A cross-tenant membership is created (role: guest)
  3. The requester is notified (Telegram + in-app)
  4. The twin appears in the requester’s sidebar within 15 seconds
  5. The requester can now query the twin

​
Security

  • Twin owners control who gets access
  • Access can be revoked at any time
  • Guest members can only query — they cannot modify the KB
  • Content visibility rules still apply (private content stays private)