bestmate twin

A twin is a scoped assistant with its own memory. You have one by default, named after you; create more for teams, clients, or purpose-built assistants.

List

bestmate twin list

Lists every twin visible to your account across all workspaces, marking which one is active.

Switch

bestmate twin switch <slug>

Sets the active twin. This is the target for ask, ingest, and the connectors unless you override it per-command.

Create

bestmate twin create "Acme Advisory" \
  --type person \
  --description "Everything we know about the Acme engagement" \
  --visibility private

Flag	Values	Default
`--type`	`person`, `team`, `organization`	`person`
`--description`	Free text — what this twin is for	—
`--visibility`	`private`, `team`, `tenant`	`private` for person twins

This creates a twin inside your existing workspace — unlike the web app’s first-run flow, it never spins up a fresh workspace. Team twins need a teamId this command doesn’t collect; create those in the app.

Twin types

Type	What it’s for	Default visibility
`person`	An individual’s knowledge	Private
`team`	Shared team knowledge, with a member roster	Team
`organization`	Company-wide knowledge	Tenant-wide

Members (team twins)

A team twin has a roster: the people allowed to ask it over their own channel. A member’s phone is fenced to exactly that one twin.

bestmate twin members list                          # roster for the active twin
bestmate twin members list --twin acme              # or a specific twin

bestmate twin members invite --phone +13125551234 --role member
bestmate twin members invite --email jeff@acme.com --role admin

bestmate twin members revoke --phone +13125551234

Flag	Description
`--twin`	Twin slug or id (defaults to the active twin)
`--phone`	Phone in E.164, e.g. `+13125551234`
`--email`	Email address
`--role`	`member` or `admin` — admins can manage the roster too

How a phone invite activates: the member’s first WhatsApp message to the twin’s number claims the invite. Their membership flips from invited to active and the ask runs member-scoped against that twin, attributed to them. A revoke is a hard deny from the member’s next ask onward.

How members actually reach the twin day to day.

Getting Started

CLI Reference

Platform

Integrations

macOS App

List

Switch

Create

Archive

Twin types

Members (team twins)

WhatsApp

​List

​Switch

​Create

​Archive

​Twin types

​Members (team twins)

WhatsApp

List

Switch

Create

Archive

Twin types

Members (team twins)