​
What Are Twins?

A twin is a queryable AI persona backed by a knowledge base. When someone asks your twin a question, it searches your ingested content and generates an answer using RAG (Retrieval-Augmented Generation).

​
Twin Types

TypeDescriptionVisibilityExample
PersonIndividual’s knowledgePrivate by default”Ask Kaya about model routing”
TeamShared team knowledgeTeam members”Ask engineering about deployment”
OrganizationCompany-wide knowledgeEveryone in org”Ask remix about our methodology”

​
Creating Twins

Twins are created automatically when you sign up (org twin) or via the CLI/app: 
# Via deploy (auto-creates per-client twins)
bestmate deploy --clients ./clients

# Via the macOS app sidebar (+ button)

​
Querying Across Twins

When you query, the system resolves the target:
  • bestmate ask "question" → default org twin
  • bestmate ask kaya "question" → matches by slug/name
  • bestmate ask --target twinId:abc123 "question" → direct ID

​
Cross-Tenant Access

You can request access to twins in other organizations:
  1. Search for twins in the macOS app (magnifying glass icon)
  2. Click “Request” on a twin
  3. The twin owner approves via Telegram or the app
  4. The twin appears in your sidebar