gitway-0.3.1 is not a library.

gitway

gitway is a purpose-built SSH transport client for Git hosting services.

It is designed as a drop-in replacement for ssh in Git workflows with a security-first default posture:

Pinned host-key fingerprints for supported providers (no TOFU)
Predictable SSH key discovery order
SSH agent support with passphrase prompting fallback
Structured JSON output for --test and --install in CI/agent mode

Install

cargo install gitway

Quick start

gitway --install

Run a connectivity check:

gitway --test

Use for one-off Git operations:

GIT_SSH_COMMAND=gitway git clone git@github.com:org/repo.git

Usage

gitway [OPTIONS] <host> <command...>

Common options:

-i, --identity <FILE>: explicit private key path
--cert <FILE>: OpenSSH certificate file
-p, --port <PORT>: target SSH port (default 22)
-v, --verbose: debug logging to stderr
--insecure-skip-host-check: skip host-key verification (dangerous)
--test: verify connectivity and authentication path
--install: set core.sshCommand=gitway globally

Security notes

Gitway verifies server host keys against pinned SHA-256 fingerprints for supported providers and aborts on mismatch. This prevents trust-on-first-use acceptance of unknown keys.

Library crate

If you need embedding in Rust code, use gitway-lib:

[dependencies]
gitway-lib = "0.3.1"