What It Is
GitButler is a git client that makes branching, committing, and pushing visual and intuitive. Instead of memorizing git commands, you drag changes into branches, write commit messages, and push — all from a GUI.
We use GitButler for daily git workflow. You don't need to learn raw git commands to contribute at Hyprnote.
Why Not Just Use Git in the Terminal?
You can, and some people do. But GitButler is better for most workflows because:
- You can see all your changes at a glance
- You can organize changes into multiple branches simultaneously (virtual branches)
- Committing and pushing is one click, not three commands
- It handles merge conflicts visually
Install
Download from gitbutler.com or install via Homebrew:
brew install --cask gitbutler
First Launch
- Open GitButler
- Sign in with your GitHub account
- Add the Hyprnote repo: click "Add Repository" and select your
hyprnotefolder - GitButler will detect the existing git state and show your workspace
Key Concepts
Virtual Branches — GitButler lets you have multiple branches active at the same time. Changes in your working directory can be dragged between branches. This is different from traditional git where you switch between branches.
Workspace — Your current set of active virtual branches. Everything you see in GitButler is your workspace.
Commit and Push — Select files or hunks, write a commit message, click commit. Then push to get it to GitHub.
Daily Workflow
- Open GitButler to see what files you've changed
- Drag changes into the right branch (or create a new one)
- Write a commit message and commit
- Push when ready for review
For Non-Engineers
If you're editing content (blog posts, docs, handbook):
- Make your edits in Cursor
- Open GitButler — your changed files will appear
- Write a short description of what you changed (e.g., "Updated blog post about product launch")
- Click commit, then push
- GitButler will create a PR on GitHub automatically if configured, or you can create one from GitHub