| name | knowsync |
| description | Sync knowledge between local machine and cloud Use when this capability is needed. |
| metadata | {"author":"conduit-ui"} |
Knowledge Sync
Synchronize knowledge entries between local SQLite and Prefrontal cloud.
Quick Sync
know sync
know sync --push
know sync --pull
Requirements
Set your API token in ~/.zshrc:
export PREFRONTAL_API_TOKEN='your-token'
Check Sync Status
know stats
know sync --dry-run
Sync Behavior
| Direction | What Happens |
|---|
--push | Uploads local entries to cloud |
--pull | Downloads cloud entries to local |
| (default) | Push then pull (two-way merge) |
Automatic Sync
The whisper loop automatically syncs on:
- SessionEnd - When you close Claude Code
- PreCompact - Before context compaction
To verify auto-sync is configured:
jq '.hooks.SessionEnd' ~/.claude/settings.json
Cross-Machine Workflow
- Machine A creates knowledge → auto-pushes on session end
- Machine B starts session → auto-pulls latest
- Both machines stay in sync automatically
Troubleshooting
Sync fails with auth error?
echo $PREFRONTAL_API_TOKEN
curl -H "Authorization: Bearer $PREFRONTAL_API_TOKEN" \
https://your-api/api/knowledge/entries
Entries not syncing?
tail -20 ~/.claude/hooks/session-checkpoint.log
Converted and distributed by TomeVault — claim your Tome and manage your conversions.