How CLI Sync Works

This guide explains what happens when you run workrail sync.

What sync reads

Workrail reads git metadata from your local repository, including:

• commit hash and timestamp
• commit message text
• branch/ref text
• changed file paths
• aggregate change counts

It does not read or upload source code content.

What sync sends

The CLI sends metadata to Workrail so entries can be grouped and summarized.

How entries are created

Workrail groups related commits into higher-signal entries by looking for:

• shared files or areas
• similar commit intent
• timing proximity
• repeated themes across commits

What affects quality

Higher-quality sync output usually comes from:

• clear commit messages
• consistent naming for features/areas
• regular sync cadence

Recommended cadence

• Run workrail sync after a coding block
• Use workrail sync --since 7d only for intentional backfill
• Enable autosync on your main machine if preferred