Questions & answers
A few things
to know.
Getting started with 1git, your native Git client for Mac.
What is 1git?
1git is a native Git client for macOS, made by 1bye. Review diffs, commit selected files, manage branches and worktrees, browse commit history, and keep multiple repositories open in tabs. Its native interface is GPU rendered using GPUI and Metal.
Which Macs can run 1git?
1git requires macOS 13 or later, an Apple Silicon Mac, and Git installed on your Mac. The desktop download is for macOS; Linux and Intel machines can be used as remote SSH hosts, with the requirements below.
Do I need a GitHub or GitLab account?
No. You can open and work with existing Git repositories without connecting a hosting account. 1git supports optional GitHub and GitLab connections for hosting features such as browsing repositories. Git authentication stays separate and uses your Git credentials or SSH configuration.
Can I connect with an existing GitHub CLI account?
Yes. Choose GitHub CLI when adding a GitHub account. 1git detects accounts already signed in with gh and lets you choose one. GitHub CLI keeps managing the credentials; 1git does not copy its tokens into the app's credential store or change the CLI's active account.
Can I work with repositories over SSH?
Yes. Add an SSH machine to browse and open its repositories in the same workspace. 1git supports Linux and macOS hosts on x64 and ARM64, with Git, an SSH command shell, gzip, and sha256sum or shasum. It installs a small helper on the remote machine, where Git operations run using that machine's identity and credentials.
What is the difference between spaces and tabs?
Each repository opens in its own tab. Spaces group repositories into separate contexts, such as Work and Personal, and remember their tabs, commit drafts, and layout. The same repository can belong to several spaces without moving or copying its files.
How do AI commit drafts work?
AI is optional and off by default. Connect an AI provider in Settings, choose a model and default account, then request a draft for your selected changes. Generation sends context from those changes to the selected provider. The suggestion remains editable, and you review it before committing.
Can 1git keep history for ignored files?
Yes, when you opt in for specific ignored files or folders in a local repository's settings. 1git keeps encrypted, device-local versions that you can review and restore. This history is separate from Git commits and cannot recover changes made before monitoring was enabled.