smithery.ai

know:sync

Sync knowledge between local machine and cloud

Installation

$ npx skills add https://smithery.ai

Also in this package

Other skills from smithery.ai · top by installs.

npx skills add https://smithery.ai

Browse all from smithery.ai

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Skill metadata

Parsed from SKILL.md frontmatter.

Declared agents claude-code

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 1,571 B
  • docs SUMMARY.md 62 B

History

  1. First recorded snapshot · 0 installs

SKILL.md

Knowledge Sync

Synchronize knowledge entries between local SQLite and Prefrontal cloud.

Quick Sync

# Two-way sync (push local, pull remote)
know sync

# Push local to cloud only
know sync --push

# Pull cloud to local only
know sync --pull

Requirements

Set your API token in ~/.zshrc:

export PREFRONTAL_API_TOKEN='your-token'

Check Sync Status

# Local entry count
know stats

# Compare with cloud (if available)
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

  1. Machine A creates knowledge → auto-pushes on session end
  2. Machine B starts session → auto-pulls latest
  3. Both machines stay in sync automatically

Troubleshooting

Sync fails with auth error?

# Check token is set
echo $PREFRONTAL_API_TOKEN

# Test API connectivity
curl -H "Authorization: Bearer $PREFRONTAL_API_TOKEN" \
  https://your-api/api/knowledge/entries

Entries not syncing?

# Check hook logs
tail -20 ~/.claude/hooks/session-checkpoint.log