espvm — ESP SDK Version Manager

Manage multiple ESP-IDF and ESP-Matter versions.

• ESP-IDF: git worktree per version (efficient disk & network usage)
• ESP-Matter: shallow clones (worktree incompatible with its submodules)

Install

curl -fsSL https://raw.githubusercontent.com/matterizelabs/espvm/main/install.sh | bash

Or manually:

curl -o ~/.local/bin/espvm https://raw.githubusercontent.com/matterizelabs/espvm/main/espvm
chmod +x ~/.local/bin/espvm
echo 'source ~/.local/bin/espvm' >> ~/.bashrc

Quick Start

espvm i 5.4.1           # Install IDF
espvm 5.4.1             # Activate (or install if needed)

espvm -m i 1.4          # Install Matter (requires IDF active)
espvm -m 1.4             # Activate Matter

Commands

Short	Full	Description
i	install	Install version
	use	Activate version
ls	list	List installed
remote	list-remote	List available
rm	remove	Remove version
	update	Update version
	current	Show active version
	status	Show active SDKs
	repair	Fix worktree links (IDF)
	config	Show/set config

SDK flags: -i ESP-IDF (default), -m ESP-Matter

Configuration

espvm config                          # Show config
espvm config set worktree-dir /path   # Set versions directory
espvm config set use-ssh yes          # yes, no, auto
espvm config reset                    # Reset to defaults

Config stored at ~/.espressif/.espvm/config

Requirements

• git
• python3

Development

After cloning, enable the pre-commit hook to auto-regenerate the SHA-256 digest:

git config core.hooksPath hooks