mise-migrate-from-pyenv

Migrate Python version management from pyenv to mise with .python-version pins.

1|1|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/ray-manaloto/claude-code-marketplace --skill mise-migrate-from-pyenv
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mise-migrate-from-pyenv
Source: https://github.com/ray-manaloto/claude-code-marketplace/tree/main/mise-toolkit/skills/mise-migrate-from-pyenv
Command: npx skills add https://github.com/ray-manaloto/claude-code-marketplace --skill mise-migrate-from-pyenv

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Migrates Python version management from pyenv to mise, ensuring project pins, virtual environments, and shell configurations are preserved or migrated safely.

Core Features & Use Cases

  • Inventory pyenv state across projects, including .python-version and pyenv-virtualenv markers.
  • Generate and apply a mise.toml migration plan to pin Python versions and enable idiomatic reading of version files.
  • Verify that shell configurations and Python shims resolve to the migrated environment, with fallbacks if needed.

Quick Start

Run the migration workflow to convert a project's pyenv setup to mise configuration and verify the resulting environment.

Frequently Asked Questions about mise-migrate-from-pyenv

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate from pyenv to mise for Python version management?

Migrating from pyenv to mise translates local and global Python version pins into a mise.toml file, updates shell integration, and safely removes pyenv artifacts while verifying interpreter consistency across projects.

What does the pyenv to mise migration process do with .python-version files?

The pyenv to mise migration process inventories .python-version files and pyenv-virtualenv markers, then generates a mise.toml configuration to pin Python versions while enabling idiomatic reading of those existing version files across projects.

Can I migrate individual projects from pyenv to mise without breaking my global Python environment?

Yes, the pyenv to mise migration supports per-project migrations by applying localized mise.toml configurations and verifying shell shims resolve correctly, ensuring your global Python environment and other projects remain intact.

How does mise handle pyenv-virtualenv markers during a Python environment migration?

During a Python environment migration from pyenv to mise, the process inventories pyenv-virtualenv markers to map existing virtual environments to the new mise configuration, ensuring shell configurations resolve to the migrated environment with fallbacks if needed.

What is the best way to clean up pyenv components after switching to mise?

The best way to clean up pyenv components after switching to mise is to follow an enforced migration plan that safely uninstalls pyenv artifacts only after verifying that shell configurations and Python shims resolve correctly to the new mise environment.

Do I need to manually verify Python interpreter consistency after migrating from pyenv to mise?

No, the pyenv to mise migration workflow automatically verifies interpreter consistency by checking that shell configurations and Python shims resolve to the migrated environment, applying fallbacks if needed to ensure a clean transition.