@capotej/pi-mise

Automatically activates mise when a mise.toml or .mise.toml file is found in the project

Packages

Package details

extensionskill

Install @capotej/pi-mise from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@capotej/pi-mise
Package
@capotej/pi-mise
Version
1.0.5
Published
Jun 7, 2026
Downloads
not available
Author
capotej
License
MIT
Types
extension, skill
Size
10.6 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./index.js"
  ],
  "skills": [
    "./skills"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@capotej/pi-mise

Auto-activates mise for pi coding sessions.

When this pi package is installed and a mise.toml, .mise.toml, or .tool-versions file is detected in the project root, it automatically:

  • Trusts the mise configuration (idempotent, safe)
  • Prepends eval "$(mise activate bash)" to every bash tool call, ensuring all commands run with the correct tool versions
  • Contributes the mise skill for edge cases (manual install, trust, tasks)

Installation

pi install @capotej/pi-mise

How It Works

  1. On session start, the extension checks if mise is available in PATH
  2. It scans the project root for mise config files (mise.toml, .mise.toml, .tool-versions)
  3. If a config is found, it runs mise trust <config> so mise won't prompt for trust
  4. Every subsequent bash tool call is automatically prefixed with eval "$(mise activate bash)", so the LLM's commands run with mise-managed tools on PATH
  5. A notification is shown when mise is activated (or if mise is missing)

If no mise config file is found, the extension does nothing — zero overhead.

Requirements

  • mise must be installed and available in PATH
  • A mise config file (mise.toml, .mise.toml, or .tool-versions) in the project root

The mise Skill

This package also contributes a mise skill that teaches the LLM how to:

  • Use mise exec for one-off commands
  • Run mise tasks with mise run
  • Install tools with mise install
  • Handle trust, activation, and common pitfalls

Note: When the pi-mise extension is active, mise activation is already prepended to every bash command. The skill instructs the LLM not to manually add eval "$(mise activate bash)" — it's handled automatically.

Development

# Install dependencies
pnpm install

# Build
pnpm build

# Lint
pnpm lint

# Format
pnpm format

License

MIT © Julio Capote