📦 Installation (macOS & Linux)

The easiest route, on both macOS and Linux:

brew install LebedevKondakovSergeyVach/tap/tspm

To upgrade later:

brew upgrade tspm

Requires Rust 1.88 or newer (the project uses edition 2024). Install a toolchain from rustup.rs, then:

cargo install tspm

This puts tspm in ~/.cargo/bin, which rustup normally adds to your PATH. If that command is not found afterwards, see PATH setup below.

To build a git revision instead of the crates.io release:

cargo install --git https://github.com/LebedevKondakovSergeyVach/Terminal-Session-Proxy-Manager.git

Download an archive for your platform from the releases page. Builds are published for macOS (x86_64, arm64) and Linux (x86_64, arm64).

Each archive ships with a .sha256 file. Verify before installing:

shasum -a 256 -c tspm-macos-arm64.tar.gz.sha256

tar -xzf tspm-macos-arm64.tar.gz
sudo mv tspm /usr/local/bin/

On macOS, Gatekeeper may quarantine a downloaded binary. Clear it with:

xattr -d com.apple.quarantine /usr/local/bin/tspm

🛠️ Building from source

git clone https://github.com/LebedevKondakovSergeyVach/Terminal-Session-Proxy-Manager.git
cd Terminal-Session-Proxy-Manager

# Install into ~/.cargo/bin
cargo install --path .

# Or just build, leaving the binary in target/release/
cargo build --release

🔧 PATH setup

If the binary is installed but not found, add its directory to your PATH.

For a Cargo install (~/.zshrc or ~/.bashrc):

export PATH="$HOME/.cargo/bin:$PATH"

For a manual install into /usr/local/bin, that directory is usually on PATH already. Confirm which binary is being used with:

which tspm

🐚 Shell integration (required)

Zsh (~/.zshrc):

eval "$(tspm init zsh)"

Bash (~/.bashrc):

eval "$(tspm init bash)"

Restart your terminal or run source ~/.zshrc to apply. Details and the full list of functions are in SHELL_INTEGRATION.md.

🔍 Verifying the installation

tspm --version
type proxy          # should report a shell function
proxy config path   # shows which config.json is in use
proxy status

🗑️ Uninstalling

# Homebrew
brew uninstall tspm

# Cargo (crates.io)
cargo uninstall tspm

# Manual
sudo rm /usr/local/bin/tspm

Then remove the eval "$(... init ...)" line from your shell rc file.

Configuration is left behind on purpose. Remove it too if you want:

# macOS
rm -rf ~/Library/Application\ Support/tspm
# Linux
rm -rf ~/.config/tspm