Syncing

Sync keeps your thoughts repository current with your latest work and with your team’s.

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, so there’s nothing to push
• notion and 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 every file
2. Stages all changes. Runs git add in the thoughts repository
3. Commits. Creates a timestamped commit if anything changed
4. Pulls. Pulls the 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

hyprlayer thoughts init installs a post-commit hook that syncs thoughts after each code commit. The sync runs in the background, so it never slows you down.

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

The thoughts repository uses git pull --rebase, so conflicts are rare. Resolve one like this:

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