Git Integration

noetect has built-in Git support for version control and syncing with GitHub.

Initializing Git

If your workspace isn't already a Git repository:

1. Go to Settings → Git
2. Click Initialize Repository

Or from the terminal:

cd ~/your-workspace
git init

Connecting to GitHub

1. Go to Settings → Git
2. Click Connect to GitHub
3. Authenticate with your GitHub account
4. Select or create a repository

Syncing Changes

Auto-sync

Enable auto-sync to automatically push changes:

1. Go to Settings → Git
2. Toggle Auto-sync on
3. Set your sync interval (default: 5 minutes)

Manual Sync

• Press ⌘⇧S to sync manually
• Or click the sync icon in the status bar

Viewing History

See the history of any note:

1. Open a note
2. Press ⌘⇧H or click History in the toolbar
3. Browse previous versions
4. Click any version to preview it
5. Click Restore to revert to that version

GitHub Actions (Coming Soon)

We're working on GitHub Actions integration for:

• Automated backups
• Publishing to static sites
• Custom workflows triggered by note changes

Stay tuned for updates.

Troubleshooting

"Push failed" error

• Check your GitHub authentication in Settings
• Ensure you have write access to the repository
• Try pulling first: there may be remote changes

Merge conflicts

noetect will notify you of conflicts. Resolve them by:

1. Opening the conflicted file
2. Choosing which version to keep
3. Saving and syncing again