Documentation

Installing Falcongit

Opening Your First Repository

Getting started with Falcongit is easy. Here's how to open your first repository:

1. Launch Falcongit - Open the application from your system menu
2. Add a Repository - Click the "+" button or use Ctrl/Cmd + O
3. Navigate to your Git repository - Select any folder that contains a .git directory
4. Start working! - Your repository will load instantly, showing current status and changes

Understanding the UI

Falcongit's interface is designed to be intuitive and efficient. Here's a breakdown of the main areas:

Making Commits

Creating commits in Falcongit is straightforward and visual:

1. Review Changes - Modified files appear in the Status panel with a yellow indicator
2. Stage Files - Click the "+" icon next to files to stage them, or use Ctrl/Cmd + S
3. Write Commit Message - Enter a clear, descriptive message in the commit input
4. Commit - Click "Commit" or press Ctrl/Cmd + Enter

Branching & Merging

All branch operations live in the left sidebar, grouped into Local and Remote. You can filter long lists with the search box at the top.

Creating a branch

• Click + New Branch in the sidebar, or press Cmd/Ctrl + B.
• Right-click any commit in the journal and choose Create branch from here to branch off a specific point in history.
• Right-click any tag to create a branch that tracks it.

Switching, renaming and deleting

• Double-click a branch to check it out. A confirmation modal protects you from accidental switches when there are uncommitted changes.
• Right-click a local branch for Rename, Delete, or Push.
• Remote branches can be checked out directly — Falcongit creates the local tracking branch for you.
• Delete remote branches from the same context menu; you'll be asked to confirm before the push.

Merging

Right-click the branch you want to merge into the current one and choose Merge. If Git detects a conflict, the 3-way conflict resolver opens automatically. If you'd rather back out, an Abort merge button stays visible in the header until the merge is resolved or aborted.

Viewing History

The Journal panel shows your repository's commit history as a color-coded graph. Lanes are deterministic (each branch gets the same color every time) so patterns are easy to spot, and the view is virtualized — scrolling through ten thousand commits stays smooth.

Navigating the graph

• Click any commit to see its details, message, and file changes in the Diff panel.
• Shift-click a second commit to select a range, then right-click to copy the combined diff.
• Click a commit's lane to highlight its path through the graph — useful for tracing where a branch diverged.
• Unpulled commits from the remote are marked with an indicator so you know when to fetch.

Searching & filtering

• Use the filter box above the journal to search by commit message.
• Right-click a file in any diff and choose Filter history by this file to see only the commits that touched it.
• Branch and tag labels appear directly on their tip commits, so you can jump between refs without leaving the graph.

Working with commits

Every commit has a context menu with Revert, Cherry-pick, Reset to here, Edit message, Create branch from here, and Copy hash. Reverts and cherry-picks can be applied to several commits at once and aborted safely if a conflict appears.

Visual Diff Viewer

The diff viewer is powered by the same editor that runs VS Code (Monaco), which means full syntax highlighting for 300+ languages, smooth scrolling, and support for very large files.

What you can do

• Side-by-side or inline — compare before and after in whichever view suits the change.
• Hide unchanged regions — collapse the parts of the file that didn't change to focus on the delta.
• Auto-scroll to first change — open a diff and land on the first hunk immediately.
• Edit in place — type directly into the "after" pane; your edits stage back into Git when you save.
• Line-level revert — right-click any line to revert just that line without affecting the rest of the file.
• Fullscreen mode — press Shift + F to expand the diff; Esc to exit.
• Binary files — images are shown as a before/after preview; other binaries show a compact summary.
• Copy diffs — copy a single commit's diff, or a range of commits, ready to paste into a review tool.

Multi-Repository Management

Falcongit is built to have all your repositories open at the same time. Switching between them is instant because each repository keeps its own status, branch state, and panel layout in memory.

Adding repositories

• Open an existing repo: Cmd/Ctrl + O or the + button in the repository sidebar.
• Clone from a URL: the clone dialog shows a live progress bar and respects any stored OAuth or SSH credentials.
• Initialize a new repo: point at an empty folder and Falcongit runs git init for you.

Switching and organizing

• Click any repository in the sidebar to switch; a file watcher picks up on-disk changes in real time.
• Right-click a repository for Reveal in Finder / Explorer, Open in IDE, or Remove.
• Removing a repository only removes it from Falcongit — your files on disk are never touched.

Per-repository identities

If you contribute to more than one project, open Manage Identities to define multiple name + email pairs and assign a specific identity to each repository. Work commits will always use your work email, personal commits your personal one — without editing .gitconfig.

Performance Tips

Falcongit is designed to stay fast on large repositories. The native Rust backend does the heavy lifting, and the UI virtualizes long lists so rendering cost stays constant. A few tips to get the best of it:

• Keep your .gitignore tidy. The file watcher honors it, so ignoring build output and caches translates directly into lower CPU usage.
• Use filters instead of scrolling. The journal, branch, tag, and stash panels all have search boxes at the top — far faster than scrolling a huge list.
• Close repositories you're not working on. They'll still be there in your history the next time you open Falcongit, but closed repositories don't consume a file watcher.
• Use the diff's "hide unchanged regions" option for huge files — it skips rendering untouched lines entirely.
• Line-by-line revert and inline edits are optimized on the Rust side, so there's no penalty for using them on big files.

Keyboard Shortcuts

Speed up your workflow with these essential keyboard shortcuts:

Settings & Configuration

Most Falcongit settings are discoverable right where you need them — in the repository context menu, the commit modal, or the identity manager. Here's a quick tour of what lives where.

Git identities

Open Manage Identities from the footer to add, edit, or remove identities (name + email). Assign a default per repository from the same dialog. The current identity is always visible in the footer so you can spot a mismatch before committing.

OAuth connections

Sign in to GitHub, GitLab, or Bitbucket from the account menu. Falcongit uses Device Flow where possible, so you never paste a personal access token. Tokens are stored in your operating system keychain — never on disk in plain text — and you can remove a connection at any time.

IDE integration

Right-click any file and choose Open in IDE. Falcongit auto-detects common editors (VS Code, JetBrains IDEs, Sublime, Vim, and more). You can change the preferred IDE per file or system-wide.

Layout & theme

Drag any panel divider to resize — Falcongit saves the layout automatically per repository. Use Reset layout from the view menu to return to defaults. The dark theme is the default (optimized for long sessions), with a light theme available.

License Activation

Activating your Falcongit license is simple:

1. Purchase a License - Choose your plan from our pricing page
2. Check Your Email - You'll receive your license key immediately after purchase
3. Open Falcongit - Launch the application
4. Enter License Key - Click "Enter License" in the app and paste your key
5. Done! - Your Pro features are now unlocked

Troubleshooting

The most common hiccups and how Falcongit helps you out of them.

Reporting Bugs

Found something that doesn't work the way it should? We'd love to hear about it. Bug reports that include the context below are the ones we can fix fastest.

What to include

• Falcongit version — visible in the app footer.
• Operating system and version — e.g. macOS 14.4 (Apple Silicon), Windows 11, Ubuntu 22.04.
• What you were trying to do and what actually happened.
• Steps to reproduce, if you can pin them down.
• Screenshots or a short screen recording whenever possible — they save a lot of back-and-forth.
• Repository type — does it happen on small repos, large monorepos, or both?

Where to send it

Pro subscribers can reply directly to their license email for priority support. For anyone else — trial users included — we're happy to hear from you at support@falcongit.com.

Recent Updates

A quick look at what's shipped recently. Falcongit updates automatically — you'll get these the next time you restart the app.