TPT Open Source

tpt-env

Rust

Safe, cross-platform manager for PATH, SDKs, and environment variables — with automatic backups, validation/repair, project auto-loading, shell hooks, and native GUI + CLI for Windows and Linux.

1 stars0 forks1 watchersApache License 2.0
View on GitHub

Languages

Rust98.3%NSIS1.3%PowerShell0.3%
README

tpt-env

Developer Environment & PATH Variable Manager

CI License: MIT OR Apache-2.0

Safely manage PATH, SDKs, and environment variables across Windows, Linux, and Archon.

The Problem

Managing PATH, SDKs, and environment variables is a cross-platform nightmare. Messing it up breaks builds and requires tedious manual fixes.

The Solution

A safe GUI + CLI for managing environment states, validating broken paths, and auto-loading project-specific .env files.

  • Windows: Registry integration (HKCU/HKLM), PowerShell hooks, native GUI
  • Linux: Shell file editing (.bashrc/.zshrc), direnv interop, native GUI
  • Archon: Microkernel namespace isolation (design phase)

Installation

From pre-built binaries (recommended)

Download the latest archive from GitHub Releases:

PlatformArchive
Windows x86_64tpt-env-x86_64-pc-windows-msvc.zip
Linux x86_64tpt-env-x86_64-unknown-linux-gnu.tar.gz

Extract and add the binary directory to your PATH.

From source

# Prerequisites: Rust 1.85+
cargo install tpt-env --locked
# Or build from the repo:
cargo build --release --workspace

Quickstart

# Check your PATH health
tpt-env doctor

# Fix issues with preview
tpt-env fix --dry-run

# Initialize project config
tpt-env init

# Load project environment
tpt-env load

# Launch the GUI
tpt-env-gui-windows   # Windows
tpt-env-gui-linux     # Linux

Documentation

Full user guide: docs/user-guide.md

License

Dual-licensed under MIT and Apache-2.0.