​
Usage

bestmate ask [question]
bestmate ask [twin-name] "[question]"

​
Examples

# Query the default org twin
bestmate ask "What's our onboarding process?"

# Query a specific twin by name
bestmate ask kaya "How does model routing work?"

# Query with an image
bestmate ask "What's in this screenshot?" --image ./screenshot.png

# Target a specific twin
bestmate ask --target engineering "What's the deployment process?"

# List available twins
bestmate ask --list

​
Flags

FlagShortDescription
--target-tTarget twin (name or ID)
--image-iPath to image file (screenshot, diagram, etc.)
--list-lList available twins

​
Response Format

🏢 twin-name (type)

Answer text here.

📚 Sources:
1. Source Document Title
2. Another Source

Confidence: 85%

​
How It Works

  1. Your question is sent to the target twin’s knowledge base
  2. RAG retrieval finds relevant chunks from ingested content
  3. LLM generates an answer using the retrieved context
  4. If confidence is below 30%, the question is escalated to the twin owner