Gitot - Godot Git Tool
Gitot is a Git workflow plugin with LFS support intended for solo developers who want fast, reliable Git operations (stage/unstage, commit, stash/pop, fetch/push/pull), inline diff gutter, full diff viewer, and issue tracker without leaving Godot 4.7+ editor.
Check the wiki for full details of all git commands covered!
β Why Gitot!
Git integrations for Godot either wrap libgit2 via GDExtension or require a separate installed application. Gitot does neither:
- Pure GDScript. No GDExtension, no bundled
libgit2, no compiled binaries to trust or keep updated across platforms. - Wraps the system
gitbinary directly. If yourgitworks in a terminal, it works in Gitot (same config, same credentials, same behavior you already rely on). - Built for solo developers. No team-workflow ceremony - status, commit, and push are one click away, tuned for a single-developer loop rather than large-team review tooling.
𧬠Features (V0.17.2)
Check the repo changelog for full details.
-
Initialze Git Repo: In a project with no repository the dock offers Initialize repository button
(
git init -b mainand a default.gitignoreif not present). The first Push asks for the remote URL (https or ssh) and addsorigin, then pushes as usual. - Commit & Sync: Stage or unstage files individually, by multi-selection (Enter) or in bulk, write multiline commit messages, and Commit, Amend, Push, or Pull.
- Stash Manager (Shelf): Stash all changes (staged + unstaged + untracked) under an optional name, then pop or drop any entry from a list (limit is a setting, default 10).
- Local Branch Management: Foldable branch list (name, ahead/behind, last update). Double-click to switch. Create/delete local branches buttons. A toast warns if an open script changed on disk, or if changed files couldn't be reliably detected (see Limitations).
- Remote Branch Management: Fetch remote updates, list remote-only branches, and double-click one to check it out with automatic tracking. A delete on origin button removes a branch from origin only.
- Tag Versioning: Push with or without an annotated tag with auto-tagging settings. The tag name is validated before the push.
- Commit History: Browse recent commits (message, author, date) with a count filter (10/20/30). Click a commit to inspect its changes file-by-file in the bottom-dock diff viewer.
- Color Diff Gutter: Modified and added lines are marked directly in the script editor's gutter. Click to open the matching hunk in the bottom-dock diff viewer.
- Diff Viewer Panel: Bottom-dock full-context unified diff. Basic syntax highlighting, foldable hunk with headers, per-line +/- gutter with real source line numbers and color-coded additions/deletions. Also browses any past commit file-by-file. And a button to restore a file to its content at that commit.
-
Git LFS: Dedicated LFS bottom panel: a left dashboard (state, Download / Prune, storage stats
computed from the files list, tracked patterns with one-click Godot-aware presets) beside the files list
(path/name, size, Local/Remote/Missing status). Without git-lfs, or before
git lfs install, it shows a simple setup guide instead. - Large-File Guard: Blocks staging any file over a configurable size limit to prevent repository bloat, flagging oversized files with a warning icon. Files covered by an LFS rule are exempt (when LFS is ready), and a Track with LFS button on a flagged file adds the rule to LFS in one click.
- GitHub Issues Tracker Board: Split list/detail view of the repo's open issues (requires a PAT); opt-out in settings. Sortable column list with filters, full issue detail (metadata, colored labels, body message, open in Browser link). Create a branch directly from an issue, auto-named from its number/title/type (editable), with a base-branch picker.
- Repo Status Panel: One-line summary of the current repo, owner/repo (click opens it in the browser), branch (detached HEAD flagged in red), branch scope, and ahead/behind sync status.
-
Status Signs: Every row of the Staged / Unstaged lists shows its status (
Uuntracked,Aadded,Mmodified,Ddeleted,Cconflict) as a colored icon, or as letter with the Status letters setting. Hovering a changed file in the FileSystem dock adds its git status (staged / unstaged) to Godot's tooltip. - Large change lists: each Staged / Unstaged list draws its first 500 rows, then a Show all row. Stage All always stages every file, shown or not. The selection survives a refresh.
-
Accents & Unicode: files with accented or non-Latin names (
Lumière.mp3) can be staged, and accented text displays correctly in diffs, commit history and stash names. -
Gitot Logger: Git and Gitot output are shown in Gitot's own dock console, and echoed to Godot's Output panel unless
you switch Echo log to Output off in the settings (fatal errors always print).
The console's Info menu: Reflog (last 20), Repo size (
git count-objects -vH), Copy log, Clear log. After a big commit only the summary line (N files changed, ...) is printed, not the file list. -
Explicit messages: every result names what it concerns (e.g: Commits pushed to 'owner/repo' on 'branchName').
A failure shows what failed, git's raw error, then a
Hintline with the common causes.
π Installation
- Copy
addons/gitot/into your project'saddons/folder. - Enable Gitot under Project Settings β Plugins.
Requirements
- Godot 4.7+
gitinstalled and available on your systemPATH.git-lfs(optional but Recommended, only needed for the Gitot LFS panel).- A GitHub Personal Access Token (PAT), (optional, only needed for the Issues integration).
π§ͺ Testing
Last run (v0.17.2): 31 suites, 250 tests, 0 failures (Godot 4.7.2, Windows).
Tested working on Godot latest 4.8.
Gitot is under active, daily-use development by a solo developer. It is built and tested on Godot 4.7.2. Core workflows (stage/commit/push/pull, branching, diff gutter & viewer) are used daily in real projects and have been through several correctness/lifecycle hardening passes (see Changelog).
- This is not yet a widely-tested release. It has been validated on Windows with one developer's workflow, on small repo, not across operating systems or project sizes.
- Pure logic GdUnit4 tested. (see Testing) Gitot requires significantly more testing under everyday usage conditions!
- Commit your work / make backup before trying a new Gitot version, same as any Git tool in active development.
- Bug reports and real-world usage feedback are the most valuable contribution right now.
License
Copyright (c) 2026-present SigK - under the MIT License.
Links
Last version, source & issue tracker: GitHub repo
Changelog for version v0.17.2
2026-10-13 22:14:38
No changelog provided for this version.