CLI Reference

thresh provides a comprehensive set of commands for managing WSL development environments, AI-powered blueprint generation, and MCP server integration.

New in v1.4.0

Thresh v1.4.0 introduces grouped blueprint commands for better organization:

• thresh blueprints → thresh blueprint list
• thresh generate → thresh blueprint generate
• New: thresh blueprint delete to remove generated blueprints

Quick Overview

Command	Description
up	Provision a new environment from a blueprint
list	List all thresh-managed environments
destroy	Remove an environment
blueprint	Manage blueprints (list, generate, delete)
blueprint list	List available blueprints
blueprint generate	Generate custom blueprint using AI
blueprint delete	Delete a generated blueprint
chat	Interactive AI chat for environment planning
distros	List available distributions
distro	Manage custom distributions
config	Manage configuration settings
serve	Start MCP server
metrics	Show performance metrics
version	Show version information

Command Categories

Environment Management

• up - Create new environments
• list - View all environments
• destroy - Remove environments

Blueprint Management

• blueprint - Manage blueprints (parent command)
• blueprint list - List available blueprints
• blueprint generate - Generate custom blueprints with AI
• blueprint delete - Delete generated blueprints

AI Features

• chat - Interactive AI assistant

Configuration

• config - Manage settings
• distro - Custom distributions
• distros - View distributions

Integration

• serve - MCP server for AI editors

Information

• metrics - Performance monitoring
• version - Version info

Global Options

All commands support these global options:

Option	Description
--help, -h	Show help information
--verbose, -v	Enable verbose output
--quiet, -q	Suppress non-error output
--version	Show version information

Getting Help

For any command, use --help to see detailed usage:

thresh --help               # Show all commands
thresh up --help           # Show help for 'up' command
thresh config --help       # Show help for 'config' command

Exit Codes

thresh uses standard exit codes:

Code	Meaning
0	Success
1	General error
2	Invalid arguments
3	WSL not available
4	Environment not found
5	Configuration error

Examples

See individual command pages for detailed examples and use cases.