A human-first Git client. Simpler commands, built-in safety nets, and multi-platform support — designed for developers who want to focus on code, not version control syntax.
Git was designed for Linus, by Linus. Gitorii is designed for everyone — including AI.
Prebuilt binaries (Linux / macOS):
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/paskidev/gitorii/releases/latest/download/gitorii-installer.sh | shWindows (PowerShell):
powershell -ExecutionPolicy Bypass -c "irm https://github.com/paskidev/gitorii/releases/latest/download/gitorii-installer.ps1 | iex"If the installer URL above 404s (the wrapper script isn't generated yet as of 0.6.7), grab the raw binary directly from the GitLab Generic Package Registry — they're produced by CI on every tag and live forever at:
- https://gitlab.com/paskidev/gitorii/-/releases (release page with assets)
- Direct:
https://gitlab.com/api/v4/projects/paskidev%2Fgitorii/packages/generic/gitorii/v0.6.7/torii-linux-x86_64curl -L "https://gitlab.com/api/v4/projects/paskidev%2Fgitorii/packages/generic/gitorii/v0.6.7/torii-linux-x86_64" \ -o ~/.local/bin/torii && chmod +x ~/.local/bin/toriiReplace
v0.6.7with the latest tag (see https://gitlab.com/paskidev/gitorii/-/tags). Aliases:torii-linux-aarch64,torii-windows-x86_64.exe.
Via cargo binstall (fetches prebuilt binary):
cargo binstall gitoriiFrom source via cargo (compiles locally):
cargo install gitorii --lockedNote
--locked— respects the committedCargo.lockso you build the exact dep graph the maintainer tested with. See Known issue below if you hit a rustc ICE or SIGSEGV.
Building from source needs only a C compiler (
gccorclang). Noperl, noopenssl-dev, nolibssh2-dev, nopkg-config. Since 0.6.0, gitorii uses pure-Rust HTTPS (rustls) and SSH (russh) transports instead of libcurl/libssh2/openssl.
cargo install gitorii can fail in two distinct ways depending on your
toolchain. Both are upstream bugs triggered by the transitive crypto chain
that russh pulls in (rsa 0.10-rc → crypto-bigint 0.7-rc →
elliptic-curve 0.14-rc). Neither is a gitorii bug.
1. rustc 1.95.0 ICE in mono-item partitioning. Symptom:
thread 'rustc' panicked at compiler/rustc_span/src/symbol.rs:2760
called `Option::unwrap()` on a `None` value
The crate ships a rust-toolchain.toml pinning the build to 1.94.0, which
rustup honours automatically when invoked from inside the unpacked crate
directory. If you have rustup, you may need nothing more than:
rustup install 1.94.0
cargo install gitorii --lockedIf rustup isn't picking up the pin (some shells / cargo configurations
override it), force the toolchain explicitly:
cargo +1.94.0 install gitorii --locked2. SIGSEGV in LLVM codegen / stack overflow. Symptom:
error: rustc interrupted by SIGSEGV, printing backtrace
... LlvmCodegenBackend ... compile_codegen_unit ...
help: you can increase rustc's stack size by setting RUST_MIN_STACK=16777216
This bites independent of rustc version when generics monomorphisation goes deep enough to overflow rustc's 8 MB default thread stack, or when too many rustcs in parallel exhaust system RAM (each codegen worker can spike to 3–5 GB). The fix is to raise the per-thread stack and cap parallelism:
RUST_MIN_STACK=16777216 \
cargo +1.94.0 install gitorii --locked -j 2For maximum stability (no parallelism), use -j 1 — slower but bulletproof.
3. Fallback: prebuilt binary — skip the compiler entirely. The installer URL at the top of this section is wired to GitHub Releases but the wrapper script isn't generated yet (as of 0.6.7). Until then, grab the binary directly from the GitLab Generic Package Registry:
curl -L "https://gitlab.com/api/v4/projects/paskidev%2Fgitorii/packages/generic/gitorii/v0.6.7/torii-linux-x86_64" \
-o ~/.local/bin/torii && chmod +x ~/.local/bin/toriiUpstream tracking: rust-lang/rust (compiler ICE), warp-tech/russh (crypto
RC defaults), and our own backlog (cargo-dist for proper installer scripts).
The rust-toolchain.toml pin and this section will be removed once a fixed
stable rustc lands and we've validated it against the dep tree.
torii init # initialize repo
torii status # see what changed
torii save -am "feat: add user auth" # stage all + commit
torii sync # pull + push| Command | Description |
|---|---|
torii init |
Initialize a repository |
torii save -m "msg" |
Commit staged changes |
torii save -am "msg" |
Stage all and commit |
torii save <files> -m "msg" |
Stage specific files and commit |
torii save --amend -m "msg" |
Amend last commit |
torii save --revert <hash> -m "msg" |
Revert a commit |
torii save --reset HEAD~1 --reset-mode soft |
Undo last commit, keep changes |
torii save --reset HEAD~1 --reset-mode hard |
Undo last commit, discard changes |
torii sync |
Pull and push |
torii sync --push |
Push only |
torii sync --pull |
Pull only |
torii sync --force |
Force push |
torii sync --fetch |
Fetch without merging |
torii sync <branch> |
Integrate branch (smart merge/rebase) |
torii sync <branch> --merge |
Force merge strategy |
torii sync <branch> --rebase |
Force rebase strategy |
torii sync <branch> --preview |
Preview without executing |
torii status |
Repository status |
torii diff |
Show unstaged changes |
torii diff --staged |
Show staged changes |
torii diff --last |
Show last commit diff |
Run commands across multiple repos at once.
torii workspace add <name> ~/repos/api # add repo to workspace
torii workspace add <name> ~/repos/frontend
torii workspace list # list all workspaces
torii workspace status <name> # git status across all repos
torii workspace save <name> -m "wip" --all # commit all repos with changes
torii workspace sync <name> # pull + push all repos
torii workspace remove <name> ~/repos/api # remove a repo
torii workspace delete <name> # delete workspacetorii branch # list local branches
torii branch --all # list local and remote branches
torii branch <name> -c # create and switch
torii branch <name> # switch to branch
torii branch -d <name> # delete branch
torii branch --rename <name> # rename current branchMultiple checkouts of the same repo, each on its own branch, sharing objects. Great for hot-fixes without disturbing in-progress work.
torii worktree # default: list
torii worktree add -b feature/auth # new branch + worktree at ../<repo>-feature-auth/
torii worktree add ../hotfix release/0.7 # check out existing branch in a worktree
torii worktree list # all worktrees with branch + clean/dirty + ahead/behind
torii worktree remove ../hotfix # delete worktree (snapshot taken automatically)
torii worktree remove ../hotfix --force # ...even if dirty
torii worktree prune # clean up metadata of deleted worktrees
torii worktree open ../hotfix # launch $SHELL inside the worktreeDefault path comes from worktree.base_dir config (default ..). worktree.inherit_paths automatically copies/symlinks .env, target/, node_modules/ etc. into new worktrees so you don't rebuild from scratch:
torii config set worktree.inherit_paths ".env,target,node_modules"Embed another git repo at a path and commit pinned at a specific commit.
torii submodule # default: status
torii submodule add git@github.com:owner/lib.git vendor/lib --branch main
torii submodule status # list with HEAD / working / state
torii submodule init # copy .gitmodules URLs to .git/config
torii submodule update --init # init missing + checkout pinned commit
torii submodule sync # re-copy URLs (after upstream URL change)
torii submodule foreach 'cargo build' # run command in each submodule
torii submodule remove vendor/lib # deregister + scrub all four state locationsMerge another project's history into a subdirectory of this repo, flattening it into your tree. Thin wrapper over git subtree (must be installed).
torii subtree add --prefix=vendor/lib git@... main --squash # initial import
torii subtree pull --prefix=vendor/lib git@... main --squash # fetch upstream changes
torii subtree push --prefix=vendor/lib git@... main # push subtree back upstream
torii subtree split --prefix=vendor/lib -b lib-split # extract history to a new branchSubmodule vs subtree quick choice: submodule when the dep is a black box you bump occasionally; subtree when you patch it locally and want one cohesive history.
torii show # show HEAD commit with diff
torii show <hash> # show specific commit
torii show <tag> # show tag details
torii show <file> --blame # line-by-line change history
torii show <file> --blame -L 10,20 # specific line rangetorii log # last 10 commits
torii log -n 50 # last 50 commits
torii log --oneline # compact view
torii log --graph # branch graph
torii log --author "Alice" # filter by author
torii log --since 2026-01-01 # filter by date
torii log --grep "feat" # filter by message
torii log --stat # show file change stats
torii log --reflog # HEAD movement history
torii sync --verify # verify local vs remote HEAD
torii show <file> --blame # line-by-line change history (was: torii blame, deprecated)
torii show <file> --blame -L 10,20
torii scan # scan staged files for secrets
torii scan --history # scan entire git history
torii cherry-pick <hash> # apply commit to current branch
torii cherry-pick --continue
torii cherry-pick --abort
torii history rewrite "2026-01-01" "2026-03-01" # rewrite commit dates
torii history compact # pack objects + expire reflog (alias: gc)
torii history orphans # find unreachable objects (alias: fsck)
torii history remove-file <path> # purge file from entire history
torii history rebase main # rebase onto branch
torii history rebase HEAD~5 -i # interactive rebase (opens editor)
torii history rebase --root # rebase from root commit (squash initial)
torii history rebase HEAD~5 --todo-file plan.txt
torii history rebase --continue
torii history rebase --abort
torii history rebase --skip
torii history reauthor --old "Old <a@x>" --new "New <b@y>" # rename author in history
torii history reauthor --old oldname --new "New <b@y>" # match by name only
torii history reauthor --old a@x --new "New <b@y>" --committer # also committer
torii history reauthor ... --since v0.6.0 --dry-run # preview a range
torii history mailmap apply # batch via .mailmap
torii history mailmap apply --file other.mailmap --dry-runreauthor and mailmap apply take a safety snapshot before rewriting
(revert with torii snapshot restore <id>), preserve timestamps,
rewrite annotated-tag taggers to match, and abort on pending operations
or dirty working trees. GPG signatures invalidate after rewrite —
re-sign manually if needed.
torii history scan # scan staged files for secrets
torii history scan --history # scan entire git historyRuns automatically before every torii save. Detects:
- JWT tokens, AWS keys (AKIA/ASIA), GitHub/GitLab tokens
- Stripe live keys, Twilio/SendGrid/Brevo keys
- PEM private keys, database connection strings with credentials
- Generic API keys and passwords
Files named *.example, *.sample, or *.template are always skipped.
.toriignore extends .gitignore syntax with optional sections for custom secret patterns, file size limits, and pre/post hooks. It is auto-synced into .git/info/exclude so git itself respects the rules.
torii ignore add 'build/' # add path to public .toriignore
torii ignore add --local '/internal/billing/' # add path to .toriignore.local
torii ignore secret 'AKIA[0-9A-Z]{16}' --name AWS # add secret regex (defaults to .local)
torii ignore secret 'ghp_[A-Za-z0-9]{36}' --public # add to public .toriignore (warns)
torii ignore list # show effective rules (merged).toriignore.local is machine-private — gitignored automatically and never committed. Use it for rules whose existence would aid recon if the public repo leaked: proprietary secret formats, internal paths, custom audit regex. Local rules merge on top of public ones; tighter local size limits override public ones.
# .toriignore # .toriignore.local (private)
[secrets] [secrets]
deny: AKIA[0-9A-Z]{16} deny: PROP_[a-z]{20} # internal
[size] [size]
max: 10MB max: 5MB # tighter wins
Snapshots are local saves — not commits. Use them before risky operations.
torii snapshot create -n "before-refactor"
torii snapshot list
torii snapshot restore <id>
torii snapshot delete <id>
torii snapshot stash # quick stash
torii snapshot stash -u # include untracked files
torii snapshot unstash
torii snapshot unstash <id> --keep
torii snapshot undo # undo last operationtorii tag create v1.0.0 -m "Release"
torii tag list
torii tag delete v1.0.0
torii tag push v1.0.0
torii tag push # push all tags
torii tag show v1.0.0
torii tag create --release # auto-bump from conventional commits
torii tag create --release --bump minor # force bump type
torii tag create --release --dry-run # preview without creatingtorii tag create --release reads commits since the last tag and bumps following Conventional Commits:
feat:→ minor bumpfix:/perf:→ patch bumpfeat!:/ breaking → major bump
Mirror your repository across multiple platforms simultaneously.
torii mirror add gitlab user <username> <repo> --primary
torii mirror add github user <username> <repo>
torii mirror add codeberg user <username> <repo>
torii mirror sync
torii mirror sync --force
torii mirror list
torii mirror promote gitlab user
torii mirror remove github user
torii mirror autofetch --enable --interval 30m
torii mirror autofetch --disable
torii mirror autofetch --statusSupported platforms: GitHub, GitLab, Codeberg, Bitbucket, Gitea, Forgejo.
Create and manage repositories directly from the CLI (requires auth token in config):
torii remote create github <repo> --public
torii remote create github <repo> --private --description "My repo"
torii remote delete github <owner> <repo> --yes
torii remote visibility github <owner> <repo> --public
torii remote configure github <owner> <repo> --default-branch main
torii remote info github <owner> <repo>
torii remote list github
# Multiple platforms at once (comma-separated)
torii remote create github,gitlab,codeberg <name> --public --push
torii remote delete github,gitlab <owner> <name> --yestorii config set user.name "Alice"
torii config set user.name "Alice" --local
torii config get user.name
torii config list
torii config list --local
torii config edit
torii config resetAvailable keys: user.name, user.email, user.editor, auth.github_token, auth.gitlab_token, auth.gitea_token, auth.forgejo_token, auth.codeberg_token, git.default_branch, git.sign_commits, git.pull_rebase, mirror.default_protocol, mirror.autofetch_enabled, snapshot.auto_enabled, snapshot.auto_interval_minutes, ui.colors, ui.emoji, ui.verbose, ui.date_format, worktree.base_dir, worktree.inherit_paths (comma-separated).
Separate from the per-platform auth.<platform>_token keys above. torii auth manages the API key for gitorii.com cloud features (CI transpile, etc.), stored at ~/.config/torii/auth.toml (chmod 600).
torii auth login # prompt for API key and save
torii auth login --key gitorii_sk_… # save non-interactively
torii auth status # show org / plan / seats
torii auth whoami # alias of status
torii auth logout # forget the local keyOverride per-process with TORII_API_KEY=gitorii_sk_…. Generate keys at https://gitorii.com/dashboard/api-keys.
Works against the platform of the current repo (GitHub, GitLab, Codeberg, etc.). Requires auth.<platform>_token to be set.
torii pr list # list open PRs
torii pr list --state closed|merged|all
torii pr create -t "feat: login" -b main # create PR (head = current branch)
torii pr create -t "wip" --draft # create as draft
torii pr merge 42 # merge with merge commit
torii pr merge 42 --method squash|rebase
torii pr close 42 # close without merging
torii pr checkout 42 # checkout PR branch locally
torii pr open 42 # open in browsertorii issue list # open issues
torii issue list --state closed|all
torii issue create -t "bug: crash" # create issue
torii issue create -t "title" -d "description"
torii issue close 42
torii issue comment 42 -m "Fixed in v0.6.6"torii clone github <user>/<repo> # clone with platform shorthand
torii clone https://... # clone with full URL
torii clone github <user>/<repo> -d dir # clone into specific directory
torii config check-ssh # verify SSH key setupLaunch the interactive terminal UI:
torii tuiFull-screen interface with sidebar navigation. All views accessible from keyboard.
| Key | Action |
|---|---|
↑↓ / j k |
Navigate sidebar (previews view in real time) |
Tab / Enter |
Enter selected view |
Esc |
Return to sidebar |
q / Ctrl+C |
Quit |
e |
Toggle event log |
? |
Help |
Views (navigate with sidebar or shortcut key):
| Key | View | Description |
|---|---|---|
f |
files | Staged / unstaged / untracked files. Space to stage/unstage, d for diff |
c |
save | Commit staged files. Optional conventional commit type selector |
s |
sync | Pull, push, fetch, force-push. Animated progress, non-blocking |
p |
snapshot | Create, restore, delete snapshots. Auto-snapshot with configurable interval |
l |
log | Commit history. Enter diff, r reset soft, b new branch |
b |
branch | List branches, checkout with Enter |
t |
tags | List tags, push/delete |
h |
history | Reflog and history rewrite operations |
r |
remote | Remote repository info |
m |
mirror | Mirror sync |
w |
workspace | Multi-repo workspace management |
g |
config | Edit repo/global config inline |
x |
settings | TUI appearance, keybinds, visible views |
Diff view — LCS-based inline char highlighting, paired +/- lines, hunk separators, line numbers.
Snapshot auto-interval — configurable per-repo in .torii/auto-interval (travels with the project).
Settings — customizable brand color, border style, keybinds. Saved in ~/.torii/tui-settings.toml.
| Feature | Gitorii | Lazygit | GitUI | Tig | Magit | gh CLI |
|---|---|---|---|---|---|---|
| Pure CLI (no TUI required) | ✓ | ✗ | ✗ | ✗ | ✗ | ✓ |
| Optional TUI with full feature parity | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| Secret scanner (pre-commit) | ✓ | ✗ | ✗ | ✗ | ✗ | ✗ |
| Scan full git history | ✓ | ✗ | ✗ | ✗ | ✗ | ✗ |
| Snapshots (pre-op safety saves) | ✓ | ✗ | ✗ | ✗ | ~ | ✗ |
| Multi-remote mirrors | ✓ | ✗ | ✗ | ✗ | ✗ | ✗ |
| Workspace (multi-repo commands) | ✓ | ✗ | ✗ | ✗ | ✗ | ✗ |
| PR / MR creation from CLI | ✓ | ~ | ✗ | ✗ | ~ | ✓ |
| GitHub + GitLab native support | ✓ | ✗ | ✗ | ✗ | ~ | ✗ |
| Conventional commits auto-tag | ✓ | ✗ | ✗ | ✗ | ✗ | ✗ |
| Remove file from entire history | ✓ | ✗ | ✗ | ✗ | ✗ | ✗ |
| Interactive rebase | ✓ | ✓ | ~ | ✗ | ✓ | ✗ |
| No runtime dependencies | ✓ | ✗ | ✓ | ✓ | ✗ | ✗ |
✓ supported · ~ partial · ✗ not supported
Full comparison at gitorii.com/vs
| Git | Gitorii |
|---|---|
git add . && git commit -m "msg" |
torii save -am "msg" |
git pull && git push |
torii sync |
git switch -c branch |
torii branch <name> -c |
git fetch |
torii sync --fetch |
git reset --soft HEAD~1 |
torii save --reset HEAD~1 --reset-mode soft |
git rebase -i HEAD~3 |
torii history rebase HEAD~3 -i |
git stash push -u |
torii snapshot stash -u |
git log --oneline --author X |
torii log --oneline --author X |
git show HEAD |
torii show |
git blame src/main.rs |
torii show src/main.rs --blame |
| Push to 3 platforms | torii mirror sync |
| Hunt for exposed secrets | torii scan --history |
| Run status across 5 repos | torii workspace status <name> |
| Commit all dirty repos at once | torii workspace save <name> -am "wip" |
None at runtime for prebuilt binaries. Only a C compiler when building from source.
Since 0.6.0 gitorii ships its own pure-Rust HTTPS (rustls) and SSH (russh)
transports, so libgit2 is built without HTTPS/SSH support — no openssl-dev,
no libssh2-dev, no pkg-config, no perl.
| Platform | Build prerequisite |
|---|---|
| Ubuntu/Debian | sudo apt install build-essential |
| Fedora/RHEL | sudo dnf install gcc make |
| macOS | xcode-select --install |
| Arch | sudo pacman -S base-devel |
| Alpine | apk add build-base |
Want a fully static binary with zero runtime libs (runs on Alpine, scratch,
busybox)? Build with the static feature on the musl target:
cargo build --release --target x86_64-unknown-linux-musl --features staticTSAL-1.0 — Free for personal and non-production use. Commercial use requires a license. Converts to Apache 2.0 after 10 years. See LICENSE for details.
Built by Pasqual Peñalver Collado (PaskiDev) — Lead Full Stack Developer in Barcelona. More projects and devlog at paski.dev.