Gitorii ⛩️

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.

Install

Prebuilt binaries — no toolchain or system libraries needed.

Linux / macOS:

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/paskidev/gitorii/releases/latest/download/gitorii-installer.sh | sh

Windows (PowerShell):

powershell -ExecutionPolicy Bypass -c "irm https://github.com/paskidev/gitorii/releases/latest/download/gitorii-installer.ps1 | iex"

Via cargo binstall (also fetches a prebuilt binary):

cargo binstall gitorii

From source via cargo (compiles locally, slower):

cargo install gitorii

Building from source requires perl, pkg-config and OpenSSL headers (only for cargo install, not for the prebuilt binaries above):

Platform Command

Ubuntu/Debian sudo apt install perl libssl-dev pkg-config

Fedora/RHEL sudo dnf install perl openssl-devel pkg-config

macOS brew install openssl

Arch sudo pacman -S perl openssl pkgconf

Quick start

torii init                            # initialize repo
torii status                          # see what changed
torii save -am "feat: add user auth"  # stage all + commit
torii sync                            # pull + push

Command reference

Core

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

Workspaces

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 workspace

Branches

torii 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 branch

Inspect

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 range

History

torii 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 blame <file>                  # line-by-line change history
torii blame <file> -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 clean                 # expire reflogs + remove backup refs
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

Security scanner

torii history scan            # scan staged files for secrets
torii history scan --history  # scan entire git history

Runs 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.

Ignore rules (`.toriignore` + `.toriignore.local`)

.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

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 operation

Mirrors

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 --status

Supported platforms: GitHub, GitLab, Codeberg, Bitbucket, Gitea, Forgejo.

Remote repository management

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> --yes

Config

torii 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 reset

Available keys: user.name, user.email, user.editor, auth.github_token, auth.gitlab_token, git.default_branch, git.sign_commits, git.pull_rebase, mirror.default_protocol, snapshot.auto_enabled, ui.colors, ui.emoji, ui.verbose.

Other

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 setup

TUI

Launch the interactive terminal UI:

torii tui

Full-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.

Gitorii vs other Git clients

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

Why Gitorii?

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 blame src/main.rs`
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"`

System dependencies

Required to build from source. Pre-built binaries have no dependencies.

Platform	Command
Ubuntu/Debian	`sudo apt install perl libssl-dev pkg-config`
Fedora/RHEL	`sudo dnf install perl openssl-devel pkg-config`
macOS	`brew install openssl`
Arch	`sudo pacman -S perl openssl pkgconf`

Links

License

TSAL-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.

Author

Built by Pasqual Peñalver Collado (PaskiDev) — Lead Full Stack Developer in Barcelona. More projects and devlog at paski.dev.

Name		Name	Last commit message	Last commit date
Latest commit History 183 Commits
.github/workflows		.github/workflows
docs		docs
src		src
.gitlab-ci.yml		.gitlab-ci.yml
.pr-test		.pr-test
.toriignore		.toriignore
.toriignore.template		.toriignore.template
CHANGELOG.md		CHANGELOG.md
COMMANDS.md		COMMANDS.md
CONTRIBUTING.md		CONTRIBUTING.md
Cargo.lock		Cargo.lock
Cargo.toml		Cargo.toml
DEFENSIVE_PUBLICATION.md		DEFENSIVE_PUBLICATION.md
DEVELOPMENT.md		DEVELOPMENT.md
LICENSE		LICENSE
README.md		README.md
ROADMAP.md		ROADMAP.md
SECURITY.md		SECURITY.md
TESTING.md		TESTING.md

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Gitorii ⛩️

Install

Quick start

Command reference

Core

Workspaces

Branches

Inspect

History

Security scanner

Ignore rules (`.toriignore` + `.toriignore.local`)

Snapshots

Tags

Mirrors

Remote repository management

Config

Other

TUI

Gitorii vs other Git clients

Why Gitorii?

System dependencies

Links

License

Author

About

Uh oh!

Releases 7

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

Gitorii ⛩️

Install

Quick start

Command reference

Core

Workspaces

Branches

Inspect

History

Security scanner

Ignore rules (.toriignore + .toriignore.local)

Snapshots

Tags

Mirrors

Remote repository management

Config

Other

TUI

Gitorii vs other Git clients

Why Gitorii?

System dependencies

Links

License

Author

About

Topics

Resources

License

Contributing

Security policy

Uh oh!

Stars

Watchers

Forks

Releases 7

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Ignore rules (`.toriignore` + `.toriignore.local`)

Packages