Lightweight Development Environment Orchestration

🚀

3.8 MB Single Binary

Native AOT compilation + UPX compression produces a tiny 3.8 MB binary. 73% smaller with no runtime dependencies. Download and run immediately.

🤖

AI-Powered Blueprints

Generate custom development environments with natural language using GitHub Copilot SDK. Access 20+ models: GPT-4o, Claude 3.5, Gemini, o1, Llama, and more.

🌍

Cross-Platform Support

Works on Windows (WSL2), Linux (Docker/nerdctl/containerd), and macOS (Apple Silicon). Provision Alpine, Ubuntu, Debian, and custom distributions in under 30 seconds.

🔧

MCP Integration

Model Context Protocol server built-in. Use thresh from your AI editor (VS Code, Cursor, Windsurf) with 7 MCP tools.

📦

8 Ready-to-Use Environments

Python, Node.js, Alpine, Ubuntu, Debian, Azure CLI - all pre-configured. Or create your own custom blueprints.

📊

System Metrics

Monitor CPU, memory, disk usage. Track environment health with built-in metrics collection and JSON export.

See thresh in Action

Install & Run Python Environment

# Install (Windows)
> winget install dealer426.thresh

# Provision Python dev environment
> thresh up python-dev

Creating container environment: thresh-python-dev
Distribution: Alpine Linux 3.19
Installing: python3 pip git vim curl

✓ Environment ready in 28s

# List environments
> thresh list

NAME             STATUS    DISTRO        CPU    MEM
thresh-python-dev  Running   Alpine 3.19   0.5%   64MB

# Enter environment (platform-specific)
> thresh exec python-dev  # or: wsl -d, docker exec, nerdctl exec
(thresh-python-dev)$ python3 --version
Python 3.12.1

(thresh-python-dev)$ pip install flask
Successfully installed flask-3.0.0

AI-Powered Custom Blueprint

# Ask GitHub Copilot to generate a blueprint
> "Create a Node.js 20 + PostgreSQL development 
   environment with TypeScript and testing tools"

# Copilot generates blueprint:
{
  "name": "fullstack-js",
  "distribution": "alpine:3.19",
  "packages": [
    "nodejs", "npm", "postgresql-client", "git"
  ],
  "postInstall": [
    "npm install -g typescript tsx jest",
    "npm install -g @types/node @types/jest"
  ],
  "environment": {
    "NODE_ENV": "development"
  },
  "ports": [
    {"container": 3000, "host": 3000}
  ]
}

# Provision it
> thresh up fullstack-js

✓ Environment ready in 32s

# Access from host browser
http://localhost:3000

What You Can Build

🐍

Python Development

Flask, Django, FastAPI apps with PostgreSQL. Isolated dependencies per project. No virtualenv conflicts.

thresh up python-dev

⚡

Full-Stack JavaScript

Next.js, React, Vue with Node.js backends. Multiple Node versions side-by-side without nvm.

thresh up node-dev

☁️

Cloud CLI Testing

Azure CLI, AWS CLI, kubectl in isolated environments. Test scripts without polluting host system.

thresh up azure-cli