gitorii-0.1.5 is not a library.

Torii ⛩️

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. Torii is designed for everyone — including AI.

Install

cargo install gitorii

Or build from source:

git clone https://gitlab.com/paskidev/torii.git
cd torii
cargo install --path .

Quick start

# Initialize
torii init

# Daily workflow
torii status                          # see what changed
torii save -m "feat: add user auth"   # stage all + commit
torii sync                            # pull + push

# Specific files only
torii save src/auth.rs -m "fix: null check"

# Branches
torii branch feature/login -c        # create and switch
torii sync main                      # merge main into current branch
torii branch -d feature/login        # delete when done

# Undo things
torii snapshot stash                  # stash work in progress
torii save --revert abc1234           # revert a commit
torii save --reset HEAD~1 --reset-mode soft  # undo last commit, keep changes

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 <hash> --reset-mode soft`	Reset to commit
`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

Branches

torii branch                  # list local branches
torii branch --all            # list local and remote branches
torii branch feature -c       # create and switch
torii branch main             # switch to branch
torii branch -d old-branch    # delete branch
torii branch --rename new-name

Tracked files

torii ls                      # list all tracked files
torii ls src/                 # filter by path prefix

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 "Pasqual"       # 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 history reflog               # HEAD movement history
torii history rewrite "start" "end"  # rewrite commit dates
torii history clean                # gc + reflog expire
torii history verify-remote        # verify remote state
torii history remove-file <path>   # purge file from all commits

torii history rebase main                  # rebase onto branch
torii history rebase -i HEAD~5             # interactive rebase
torii history rebase HEAD~5 --todo-file plan.txt
torii history rebase --continue
torii history rebase --abort
torii history rebase --skip

torii history cherry-pick <hash>   # apply commit to current branch
torii history cherry-pick --continue
torii history cherry-pick --abort

torii history blame <file>         # line-by-line change history
torii history blame <file> -L 10,20

Security scanner

torii history scan                 # scan staged files before committing
torii history scan --history       # scan entire git history

Runs automatically before every torii save. Detects JWT tokens, AWS keys, GitHub/GitLab tokens, Stripe keys, PEM private keys, database connection strings with credentials, and generic API keys. Files named *.example, *.sample, or *.template are always allowed.

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              # stash current work
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-primary gitlab user myrepo user
torii mirror add-replica github user myrepo user
torii mirror add-replica codeberg user myrepo user
torii mirror sync
torii mirror sync --force
torii mirror list
torii mirror set-primary 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, SourceHut, SourceForge, and any custom Git server.

Remote repository management

Create and manage repositories directly from the CLI:

torii remote create github myrepo --public
torii remote create github myrepo --private --description "My repo"
torii remote delete github owner myrepo --yes
torii remote visibility github owner myrepo --public
torii remote configure github owner myrepo --default-branch main
torii remote info github owner myrepo
torii remote list github

# Batch operations across platforms
torii repo myrepo --platforms github,gitlab --create --public
torii repo myrepo --platforms github,gitlab --delete --yes

Config

torii config set user.name "Pasqual"    # set global config
torii config set user.name "Pasqual" --local  # set local config
torii config get user.name
torii config list
torii config list --local
torii config edit
torii config reset

Other

torii clone github user/repo      # clone with platform shorthand
torii clone https://...           # clone with full URL
torii clone github user/repo -d my-dir
torii ssh-check                   # verify SSH setup

Why Torii?

Git	Torii
`git add . && git commit -m "msg"`	`torii save -am "msg"`
`git pull && git push`	`torii sync`
`git switch -c branch`	`torii branch branch -c`
`git fetch`	`torii sync --fetch`
`git reset --soft HEAD~1`	`torii save --reset HEAD~1 --reset-mode soft -m "msg"`
`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 ls-files`	`torii ls`
`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 history scan --history`

gitorii 0.1.5