Km 0 · Git Repository Manager
Merathon: graphical Git client for Linux and Windows
"Your code is a marathon."
Graph, commits, branches and pull requests in a single window. Free and open source.
Km 5 · In motion
Merathon in 2 min
Nothing starts by itself. The video has music but no voice: everything written on screen is repeated as text on this page. On a phone, switch it to full screen and rotate your device to read it more easily.See the interactive version
Km 8 · For real
The application, on a demo repository
What the demo shows
- The commit graph, a commit's details and diff, the repository tabs.
- A branch's menu, solo mode and comparing two commits.
- Pull requests, reviewing changed files, sync and notifications, with the dot on the tab of the repository concerned.
- Creating and deleting a worktree, then the preferences.
- Creating a pull request linked to an issue chosen by typing "#".
- Setting up SSH for an account, creating a Git profile for a projects folder, and the alert on a repository that signs with a different email.
- The Git Cheat Sheet and its Worktrees section, a commit, the built-in terminal and the operation log.
Km 10 · The promise
A Git client made to stay open all day
Fast
Native Git engine in Rust: the interface stays smooth during a fetch or a rebase, even on a large history.
Safe
Tokens stay in the system keyring. Opening an unknown repository runs no hooks.
Light
A .deb package of about 8 MB and little memory at rest, thanks to the system's web engine.
Complete
From line-by-line commits to pull request review, with GitHub and GitLab.
Km 21 · Features
The whole Git workflow, without leaving the window
Repositories: One tab per repository
Open, initialize or clone from your accounts' list. Each tab keeps its state. Submodules and Git LFS supported.
Graph: All branches
Local branches, remote branches and tags on one canvas graph. Solo mode shows only the branches you choose, or hides some.
Right-click: The graph menu
Checkout, merge, rebase and fast-forward without checkout. Cherry-pick several commits, compare two commits, amend or undo the last commit.
Commits: Precise down to the line
Stage by file, by block or line by line, then amend. Right-clicking a folder handles all its files at once, or adds it to .gitignore.
Rebase: Interactive and graphical
Reorder, rename, squash, delete. Flatten merges or preserve them. A timeline follows each step: done, in progress, skipped or in conflict. Can be canceled at any time.
Sync: Automatic or on demand
Fetch every 5 minutes, or one click on the sync button, next to the branch name.
Notifications: What's happening on your PRs
New PR to handle, commits, comments, CI, approval. System notification, badge on the application icon and dot on the tab of the repository concerned.
PRs and MRs: From creation to merge
Description pre-filled with the repository's template, line-by-line review with search for files and within a file, rebase and safe force push. Title, description, target branch, reviewers and assignees can be changed afterwards. The PRs of all your projects in the Accounts tab.
Review: Threads addressed by a commit
Link a commit to the review comments it fixes. On push, each thread gets a "Handled in" reply with the link to the commit, then resolves if you asked it to.
Issues: Closes #12, without looking up the number
Type "#" in the description: the project's issues appear, filtered by number or title. Shift+Enter inserts "Closes #12" to close the issue on merge.
Markdown: Readable PRs in the application
Description and comments display as Markdown, including tables and task lists, with no scripts or active content. Images become links to their source: the interface has no network access.
Emojis: Type ":" and choose
In a description, a comment or a commit message, ":rocket" suggests the matching emojis. The picker offers search, recent emojis and categories.
Worktrees: Several branches at the same time
An urgent fix with no stash or branch switch: each worktree has its own folder and opens in its own tab. A branch checked out elsewhere is protected, and its menu leads to its worktree.
Git profiles: Work and personal, by folder
One identity, account and SSH key for each projects folder, with the native includeIf rule: command-line git follows them too. An alert flags a repository that would sign with a different email.
SSH: A key set up with a right-click
Reuses or creates a key, registers it on your GitHub or GitLab account, checks the server fingerprint and tests the connection. No existing key is overwritten.
Git Cheat Sheet: A built-in reference
More than fifty entries: the command, what it does, a use case and the steps to follow in the application.
Terminal: And operation log
A real shell in the repository, and each action in the application shown as the equivalent git command.
Accounts: Tokens in the keyring
GitHub, GitLab.com or self-hosted GitLab, by OAuth or token. API calls come from the Rust backend, never from the interface.
Language: In English or French
The interface and the Git Cheat Sheet exist in both languages. Merathon asks which one you want on first launch, and you can change it at any time in the preferences.
Preferences: Theme, zoom, density
Light theme, dark theme or the system's. Interface size from 80 to 200%. Graph density and keyboard shortcuts.
Accessibility: By keyboard as well as by mouse
Internal audit against RGAA 4.1.2, the French accessibility standard: no non-compliant criterion, in light and dark themes. The last two criteria remain to be tested with a screen reader.
Updates: Signed and explained
Signature verified before each installation. If you skipped versions, the update window lists what is new in each one.
Km 27 · Tutorial
The Git Cheat Sheet: learn Git by clicking
In the application, the Merathon menu opens the "Git Cheat Sheet", a reference for people discovering Git. Here are its 57 entries, with the same search. Warnings point out the actions that lose data or rewrite history.
The entries to know
- git reset: --soft, --mixed or --hard
- git revert: undo a published commit
- Interactive rebase: git rebase -i
- Resolve a Git conflict
- git cherry-pick: take a commit
- git push --force: force a push
- git stash: set your changes aside
- git worktree: several branches at the same time
- Set up an SSH key for GitHub and GitLab
- includeIf: one Git identity per folder
Each entry also has its own page, with command-line variants and frequently asked questions: all the Git Cheat Sheet entries.
Km 32 · Useful links
Everything you need to get started
- DownloadsLinux and Windows installers, release notes and SHA256SUMS.txt checksums.
github.com/J-Dudek/merathon/releases - Source codeThe project's repository, under the MIT license.
github.com/J-Dudek/merathon - Report a problemA bug, a feature idea: open an issue.
github.com/J-Dudek/merathon/issues - Release notesWhat changed in each version, generated from the commits (in French).
github.com/J-Dudek/merathon/blob/main/CHANGELOG.md - Accessibility of the applicationMerathon's RGAA 4.1.2 audit grid, criterion by criterion (in French).
github.com/J-Dudek/merathon/…/grille-rgaa.md - Comparison of Git clients on LinuxMerathon, GitKraken, SmartGit, git-cola and others: systems, price and license.
/en/client-git-linux/ - An alternative to GitKrakenPrivate repositories, free and open source. What Merathon does, and its limits.
/en/alternative-gitkraken/ - GitHub Desktop on LinuxNo official version: the community fork and the other options.
/en/github-desktop-linux/ - Interactive animationThe 2-minute presentation as a web page: scene by scene, adjustable size, with or without music.
animation.html - The authorJulien Dudek (J6N), software engineer: other projects and background (in French).
me.byj6n.fr
Km 42 · Finish line
Ready for the marathon?
Linux
.deb (Debian, Ubuntu) or .AppImage
Ubuntu 22.04, Debian 12 or any distribution with glibc 2.35 or later. x86_64 architecture. The .deb installs WebKitGTK 4.1 by itself.
Windows
.msi or .exe
Windows 10 or 11, 64-bit. WebView2 is already there on Windows 11, and downloaded by the installer on Windows 10 if it is missing.
WSL
Linux version, run in WSL
The .deb installs in the distribution (WSLg). Windows notifications and a badge in the taskbar. The Windows version also opens a WSL repository, but much more slowly.
After that, the application updates itself: signed packages, signature verified before installation. Windows: the installers are not signed yet. On first launch, click "More info" then "Run anyway".
