mise-host-vs-mise-tools

Distinguish system libraries from mise dev tools before installation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The CRITICAL distinction between system packages (apt/brew/dnf — libssl, libpq, build-essential) and dev tools (mise — node, python, cmake, ripgrep). The #1 mistake new mise users make is trying to install system libraries with mise. Use whenever a user asks "can I install X with mise" for something that looks like a system library, or hits "tool failed to compile".

Core Features & Use Cases

  • Clear rule: mise installs dev tools; system libraries must be installed with the OS package manager.
  • Guidance for ambiguous requests: provide decision criteria when users ask to install a library that could be a system dependency.
  • Platform-aware guidance: applicable across Linux, macOS, and container environments to avoid unsafe or failed builds.

Quick Start

Ask mise to distinguish between dev tools and system libraries before installation.

Frequently Asked Questions about mise-host-vs-mise-tools

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

FAQPage Schema
Can I install system libraries like libssl or libpq with mise?

No, mise does not install system libraries like libssl or libpq. You must install system packages using your OS package manager like apt, brew, or dnf, while mise is used exclusively for dev tools like node, python, and ripgrep.

How do I distinguish between a dev tool and a system package before installation?

Distinguish dev tools from system packages by checking if the package is a runtime library or a standalone executable. Tools like node, python, and cmake are dev tools managed by mise, whereas libraries like build-essential or libpq are system packages installed via apt or brew.

Why does a tool fail to compile when I install it with mise on macOS or Linux?

Tools fail to compile with mise when required system libraries are missing from the OS. mise provides the dev tools, but you must install foundational system dependencies like build-essential or libssl using your operating system's package manager first.

Does mise work for installing dev tools inside Linux containers?

Yes, mise works inside Linux containers to install dev tools. You still need to install system libraries via the container's OS package manager, keeping dev tools managed by mise separate from system dependencies to avoid unsafe or failed builds.

What is the best way to manage system dependencies alongside mise dev tools?

The best way to manage dependencies is to separate them: use your OS package manager for system libraries like libssl and use mise exclusively for dev tools like python and node. This prevents incorrect installations and compilation failures across platforms.