Skip to main content

​
hubify sync

Commands for synchronizing skills from external sources like GitHub, Notion, and more.

​
Usage

hubify sync [options]

​
Options

OptionDescription
--source <name>Source to sync from
--dry-runPreview changes without syncing
--forceForce sync even if up-to-date

​
Subcommands

CommandDescription
statusView sync status
logsView sync history
sourcesList configured sources
addAdd a sync source
removeRemove a sync source

​
Examples

​
Run Sync

hubify sync --source github
Output: 
Syncing from github...

  Fetching changes... ✓
  Found 3 updated skills

  Changes:
    + Added: new-skill-from-repo
    ~ Updated: existing-skill (v1.0.0 → v1.1.0)
    ~ Updated: another-skill (v2.0.0 → v2.0.1)

  Syncing skills... ✓

Sync complete!
  Added: 1
  Updated: 2
  Unchanged: 15

​
Sync All Sources

hubify sync

​
Dry Run

hubify sync --source github --dry-run
Output: 
Dry run - no changes will be made

Would sync from github:
  + Add: new-skill-from-repo
  ~ Update: existing-skill (v1.0.0 → v1.1.0)

Run without --dry-run to apply changes.

​
View Sync Status

hubify sync status
Output: 
Sync Status

  github
    Last Sync: 2h ago
    Status: Up to date
    Skills: 18

  notion
    Last Sync: 1d ago
    Status: 2 updates available
    Skills: 5

  local
    Last Sync: 30m ago
    Status: Up to date
    Skills: 3

​
View Sync Logs

hubify sync logs
Output: 
Sync History

  2024-05-01 12:00 - github
    Added: 1, Updated: 2, Errors: 0
    Duration: 3.2s

  2024-05-01 10:00 - notion
    Added: 0, Updated: 1, Errors: 0
    Duration: 1.8s

  2024-04-30 18:00 - github
    Added: 0, Updated: 0, Errors: 1
    Error: Rate limit exceeded

​
List Sources

hubify sync sources
Output: 
Configured Sync Sources

  github
    URL: https://github.com/myorg/skills
    Path: skills/
    Auto-sync: Every 6h
    Last sync: 2h ago

  notion
    Database: Skills Registry
    Auto-sync: Disabled
    Last sync: 1d ago

  local
    Path: ~/my-skills/
    Auto-sync: On file change
    Last sync: 30m ago

​
Add Source

hubify sync add github
Interactive setup: 
Adding GitHub sync source...

? Repository URL: https://github.com/myorg/skills
? Path to skills (default: /): skills/
? Branch (default: main): main
? Enable auto-sync? (Y/n) y
? Sync interval: 6h

Source added!

Test sync: hubify sync --source github --dry-run

​
Add Source with Options

hubify sync add github \
  --url https://github.com/myorg/skills \
  --path skills/ \
  --branch main \
  --interval 6h

​
Remove Source

hubify sync remove github

​
Source Types

​
GitHub

hubify sync add github \
  --url https://github.com/org/repo \
  --path skills/ \
  --branch main
Syncs skills from a GitHub repository.

​
Notion

hubify sync add notion \
  --database "Skills Database"
Syncs skills from a Notion database.

​
Local Directory

hubify sync add local \
  --path ~/my-skills/
Syncs skills from a local directory.

​
URL

hubify sync add url \
  --url https://example.com/skills.json
Syncs from a JSON endpoint.

​
Configuration

Sources are configured in .hubify/config.yaml: 
sync:
  sources:
    - name: github
      type: github
      url: https://github.com/myorg/skills
      path: skills/
      branch: main
      interval: 6h
      enabled: true

    - name: notion
      type: notion
      database_id: abc123
      enabled: true

    - name: local
      type: local
      path: ~/my-skills/
      watch: true

​
Auto-Sync

Enable automatic synchronization: 
# Enable for a source
hubify sync sources edit github --interval 6h

# Disable
hubify sync sources edit github --interval disabled

​
Conflict Resolution

When conflicts occur: 
Conflict detected for: my-skill

  Local version: 1.0.0 (modified 2h ago)
  Remote version: 1.1.0 (modified 1h ago)

Resolution:
  (l) Keep local
  (r) Use remote
  (m) Merge (manual)
  (s) Skip

Choice: r

Using remote version.

​
See Also