​
Usage

bestmate export-chats --output <path>

​
Examples

# Export all twin conversations
bestmate export-chats --output ./clients

# Export for a specific twin
bestmate export-chats --output ./clients --twin acme

# Export as JSON
bestmate export-chats --output ./logs --format json

​
Flags

FlagShortDescription
--output-oOutput directory (required)
--twinExport only for a specific twin
--formatOutput format: md (default) or json

​
Output

Creates a subfolder per twin with a chat-log.md (or .json): 
clients/
├── acme-corp/
│   └── chat-log.md
├── globex/
│   └── chat-log.md
└── kaya/
    └── chat-log.md

​
Markdown Format

# Chat Log — Acme Corp

*Exported 2026-04-01 14:30*

---

### 2026-03-28T10:15
*From: Justin (macos)*

**Q:** What's our engagement timeline?

**A:** The typical Kickstart engagement runs 3 phases over 60 days...

---