Full Sync Command

The bee sync command exports your Bee data to local markdown files, creating a portable backup of your conversations, facts, todos, and daily summaries.

For incremental polling of recent changes instead of full snapshots, use Agentic Sync.

Usage

bee sync

This creates a bee-sync/ directory in your current location with all your data.

Hint: You can rerun bee sync anytime. Existing files in the output directory are overwritten with the latest synced content.

Options

--output <directory>

Specify a custom output directory:

bee sync --output ~/my-bee-data

--only <target>

Limit sync to specific data types:

# Only sync facts
bee sync --only facts
 
# Only sync todos
bee sync --only todos
 
# Only sync conversations
bee sync --only conversations
 
# Only sync daily summaries
bee sync --only daily

Output Structure

After running bee sync, your data is organized as follows:

• bee-sync
  • facts.md
  • todos.md
  • daily
    • 2024-01-15
      • summary.md
      • conversations
        • 123.md
        • 124.md
        • 125.md
    • 2024-01-14

File Contents

facts.md

Contains all your personal facts and preferences in markdown format:

# Facts
 
## Preferences
- Prefers morning meetings
- Likes coffee, not tea
 
## Personal
- Lives in San Francisco
- Works at Acme Corp

todos.md

Your todos organized by status:

# Todos
 
## Pending
- [ ] Review Q4 budget
- [ ] Call mom
 
## Completed
- [x] Submit report
- [x] Book flight

daily/YYYY-MM-DD/summary.md

Daily summary including key events and insights:

# Daily Summary - January 15, 2024
 
## Overview
Today you had 5 conversations and 2 meetings.
 
## Key Topics
- Project planning
- Team sync
- Client call

daily/YYYY-MM-DD/conversations/*.md

Individual conversation transcripts:

# Conversation 123
 
**Date:** January 15, 2024 10:30 AM
**Duration:** 15 minutes
**Participants:** You, Sarah
 
## Transcript
...

Automation

You can automate sync with a cron job:

# Add to crontab (runs daily at midnight)
0 0 * * * cd ~/bee-backup && bee sync

Or use a shell alias for quick syncing:

# Add to ~/.bashrc or ~/.zshrc
alias bee-backup="bee sync --output ~/Dropbox/bee-backup"