thresh blueprint

Manage environment blueprints - list, generate, and delete blueprint configurations.

Synopsis

thresh blueprint <command> [options]

Description

The blueprint command is the parent command for all blueprint-related operations. It provides subcommands for listing available blueprints, generating new ones with AI, and deleting custom blueprints.

New in v1.4.0

The blueprint command introduces a grouped command structure, replacing the flat commands from previous versions:

• thresh blueprints → thresh blueprint list
• thresh generate → thresh blueprint generate

Subcommands

Subcommand	Description
list	List all available blueprints
generate	Generate blueprint from natural language using AI
delete	Delete a generated blueprint

Options

Option	Description
--help, -h	Show help information

Subcommand Details

thresh blueprint list

List all available environment blueprints (built-in and custom).

Synopsis:

thresh blueprint list [options]

Options:

• --json - Output in JSON format
• --verbose, -v - Show detailed information

Example:

# List all blueprints
thresh blueprint list

# JSON output for scripting
thresh blueprint list --json

Output:

Available blueprints:

  alpine-minimal       - Alpine Linux minimal environment
  alpine-python        - Alpine Linux with Python
  ubuntu-dev           - Ubuntu development environment
  python-dev           - Python development with pip and venv
  node-dev             - Node.js development environment
  ...

See: Complete list documentation

---

thresh blueprint generate

Generate custom blueprint from natural language description using AI.

Synopsis:

thresh blueprint generate <prompt> [options]

Arguments:

• <prompt> - Natural language description of desired environment

Options:

• --output <name>, -o - Save blueprint with specified name
• --model <name>, -m - Use specific AI model
• --verbose, -v - Show detailed AI reasoning

Examples:

# Generate and display blueprint
thresh blueprint generate "Python ML environment with Jupyter"

# Generate and save with custom name
thresh blueprint generate "nginx web server" --output nginx

# Use specific model
thresh blueprint generate "Redis cache" --model gpt-4o

Generated blueprints are automatically saved to the blueprints directory and become immediately available via thresh blueprint list.

See: Complete generate documentation

---

thresh blueprint delete

Delete a generated blueprint by name.

Synopsis:

thresh blueprint delete <name> [options]

Arguments:

• <name> - Blueprint name to delete

Options:

• --help, -h - Show help information

Examples:

# Delete a generated blueprint
thresh blueprint delete nginx-test

# List blueprints to find name
thresh blueprint list
thresh blueprint delete my-custom-env

Notes:

• Only deletes user-generated blueprints (not built-in)
• Blueprints are deleted from ~/.local/bin/blueprints/ (Linux/macOS) or %USERPROFILE%\.local\bin\blueprints\ (Windows)
• Shows confirmation message with available blueprints if name not found

See: Complete delete documentation

---

Migration from v1.3.0

If you're upgrading from v1.3.0 or earlier, update your commands:

Old Command (v1.3.0)	New Command (v1.4.0+)
thresh blueprints	thresh blueprint list
thresh generate "..."	thresh blueprint generate "..."
(no command)	thresh blueprint delete <name>

The old commands will show error messages with suggestions for the new commands.

---

Common Workflows

List and Use Blueprint

# Find available blueprints
thresh blueprint list

# Use a blueprint
thresh up alpine-minimal

Generate Custom Blueprint

# Generate with AI
thresh blueprint generate "Django web app with PostgreSQL" --output django-app

# Verify it was saved
thresh blueprint list | grep django-app

# Use the generated blueprint
thresh up django-app

Manage Generated Blueprints

# List all blueprints
thresh blueprint list

# Delete old test blueprints
thresh blueprint delete test-env-1
thresh blueprint delete test-env-2

# Verify deletion
thresh blueprint list

---

See Also

• thresh blueprint list - Detailed list documentation
• thresh blueprint generate - Detailed generate documentation
• thresh blueprint delete - Detailed delete documentation
• thresh up - Provision environments from blueprints
• Custom Blueprints Tutorial - Creating custom blueprints

---

Platform Compatibility

Platform	Status	Notes
Windows (WSL)	✅ Supported	Full functionality
Linux (Docker/nerdctl)	✅ Supported	Full functionality
macOS (containerd)	✅ Supported	Full functionality

---

Introduced: v1.4.0
Category: Blueprint Management