Primeros pasos

Instala el binario, inicializa un repositorio y haz tu primer commit. Todo lo de esta página funciona contra un repositorio de Git corriente — torii escribe los mismos objetos, así que puedes dejar de usarlo en cualquier momento y git no se enterará.

Instalación

El camino más rápido y que siempre lleva la versión actual es crates.io:

cargo install gitorii --locked

--locked importa: sin él, el resolvedor ignora el lockfile publicado y puede arrastrar una cadena de cripto rota en versión candidata.

Los binarios ya construidos no necesitan compilador y los genera la CI para linux x86_64, linux aarch64 y windows x86_64:

curl -L "https://gitlab.com/api/v4/projects/paskidev%2Fgitorii/packages/generic/gitorii/<tag>/torii-linux-x86_64" \
  -o ~/.local/bin/torii && chmod +x ~/.local/bin/torii

Mira en la página de releases cuál es el <tag> más nuevo que de verdad tenga artefactos — los binarios publicados pueden ir por detrás del crate. En Arch, yay -S gitorii instala desde el AUR, que se mantiene a mano y también puede ir atrasado. torii --version después de instalar te dice qué tienes.

Compilar desde fuente necesita un compilador de C y nada más. Desde 0.6.0 los transportes HTTPS y SSH son Rust puro — rustls y russh — y libgit2 va vendorizada con los suyos compilados fuera, así que no hay perl, ni openssl-dev, ni libssh2-dev, ni pkg-config que instalar antes.

Tus primeros cuatro comandos

torii init                            # initialise a repository
torii status                          # see what changed
torii save -am "feat: add user auth"  # stage everything and commit
torii sync                            # pull, then push

torii save ejecuta el escáner de secretos antes de escribir nada. Si encuentra algo, el commit se aborta y se imprimen el fichero y la línea. Cuando el hallazgo es un falso positivo —un ejemplo de documentación, un fixture de test— pasa --yes, o siléncialo para siempre en .toriignore.

Identidad

torii lee user.name y user.email primero de su propia configuración y luego de la de Git. Ponlos una vez:

torii config set user.name "Alice"
torii config set user.email "alice@example.com"

No hay ningún valor por defecto tipo «Torii User». Si ninguna configuración tiene un nombre, el commit falla con un mensaje que lo dice en vez de escribir el autor equivocado en tu historia.

Hablar con una plataforma

Clonar con atajo de plataforma y abrir una pull request necesitan un token de la plataforma en cuestión:

torii auth set github            # stores the token in ~/.config/torii/auth.toml
torii clone github alice/api
torii pr create -t "feat: login" -b main

El fichero se escribe con permisos 600. Los tokens son por plataforma: GitHub, GitLab, Codeberg, Gitea, Forgejo, Bitbucket, Sourcehut, Radicle y Azure DevOps tienen cada uno el suyo.

Si cargo install revienta

cargo install gitorii puede morir con rustc interrupted by SIGSEGV. Eso es rustc desbordando su pila de hilo de 8 MB al monomorfizar la cadena de cripto transitiva, no un fallo del crate. Sube la pila y baja el paralelismo:

RUST_MIN_STACK=67108864 cargo install gitorii --locked -j 1

-j 1 es el ajuste que siempre funciona. Si prefieres saltarte el compilador entero, coge un binario ya construido de la página de releases.