FAQ

FinderGit is a native macOS application that works as a Git-aware file browser. Think of it as Finder’s list view, but with Git status, branch info, inline diffs, and commit/push/pull actions built in.

Yes, FinderGit is currently free. If you find it useful, consider sponsoring the project.

macOS 15 (Sequoia) or later. FinderGit is built with SwiftUI and uses APIs available from macOS 15+.

Not entirely. FinderGit is great for everyday operations (status check, commit, push, pull) across many repos at once. For advanced workflows (interactive rebase, cherry-pick, complex merges), you’ll still want a full Git client or the terminal.

FinderGit is not yet signed with an Apple Developer ID certificate. To open it, right-click the app, choose "Open", then click "Open" in the confirmation dialog. You only need to do this once.

When you add a root folder, FinderGit recursively scans for directories containing .git/. The scan depth is configurable in Settings (default: 5 levels). Heavy directories like node_modules and DerivedData are automatically skipped.

Only when you explicitly perform an action (commit, push, pull, stage, etc.). FinderGit reads your repository state via git status and git diff — it never modifies anything without your command.

FinderGit uses macOS FSEvents to monitor file system changes in real time. When a file changes inside a watched repository, the status is automatically refreshed within ~300ms.

Please open a Bug Report on GitHub. Include your FinderGit version, macOS version, and steps to reproduce the issue. Screenshots are very helpful!

We'd love to hear your ideas! Open a Feature Request on GitHub and describe what you'd like FinderGit to do. The more detail you provide, the better we can evaluate and prioritize it.