Syncing

Syncing ensures your thoughts repository stays up to date with your latest work and synchronized with your team.

Note

The commands on this page apply to the git backend only. On obsidian, notion, and anytype, hyprlayer thoughts sync is a no-op:

• obsidian — files live in your vault; nothing to push
• notion / anytype — the AI agent writes directly via MCP See Storage Backends.

Manual Sync

hyprlayer thoughts sync

This command:

1. Creates a searchable index — Builds thoughts/searchable/ with hard links to all files
2. Stages all changes — Runs git add in the thoughts repository
3. Commits — Creates a timestamped commit if there are changes
4. Pulls — Pulls latest changes from the remote (with rebase)
5. Pushes — Pushes your changes to the remote

Custom Commit Message

hyprlayer thoughts sync --message "Added research on auth system"

Automatic Sync

When you run hyprlayer thoughts init, a post-commit hook is installed that automatically syncs thoughts after each code commit. The sync runs in the background so it doesn’t slow down your workflow.

The auto-sync commit message includes the code commit message:

Auto-sync with commit: Add user authentication

Check Status

hyprlayer thoughts status

Shows the current state of the thoughts repository, including any uncommitted changes.

Conflict Resolution

Since the thoughts repository uses git pull --rebase, conflicts are rare. If they occur:

1. Navigate to your thoughts repository (e.g., cd ~/thoughts)
2. Resolve conflicts manually
3. Run git rebase --continue
4. Run hyprlayer thoughts sync to push the resolution