mise-setup

name	mise-setup
description	Set up mise (https://mise.jdx.dev) configuration in the current project. Use when a project needs mise tool/task configuration created or aligned.
allowed-tools	Bash, Read, Write, Edit, AskUserQuestion
user-invocable	true

Mise Setup

This skill helps set up mise (https://mise.jdx.dev) configuration in the current project.

Instructions

When this skill is invoked, you should:

1. Check if mise is installed

   • Run which mise to verify mise is available
   • If not installed, inform the user to install it via curl https://mise.run | sh and STOP

2. Check for existing configuration

   • Look for existing mise configuration files:
     • mise.toml (preferred name)
   • If the configuration does not exist, create mise.toml in the current directory.

3. Create or update mise configuration

   • If creating new configuration, check the current directory for existing tooling.
     • If a package.json file exists, check for lockfiles (pnpm, yarn, npm, bun) and make sure the relevant tools are installed by running mise use <tool_name> or mise use <tool_name>@<version>. If it's using npm for versioning, you just need to make sure to run mise use node and that'll pull in npm.
     • IMPORTANT: Tools must be added via the mise use command. Do NOT manually specify tools in the mise configuration file.
     • convert any package.json scripts into mise tasks.

• For new or existing configurations, make sure the following details are present:
  • The [settings] section should have experimental = true and pin = true
  • Make sure there's a postinstall hook in the [hooks] section that installs packages from the configured package manager.
    • For instance, if it's a bun project, you'll want postinstall = "bun install"
    • If it's a python project (that uses uv) you'll want postinstall = "uv sync"
• For node compatible projects (node.js, bun, or deno in node compability mode)
  • Make sure there's an [env] section with _.path = "node_modules/.bin"

Example Configuration

Here's an example .mise.toml structure:

Note: The [tools] section shown below is automatically generated by running mise use <tool>@<version> commands. Do not manually add tools to the configuration file.

[tools]
bun = "1.3.5"  # Added via: mise use bun@1.3.5

[settings]
experimental = true
pin = true

[hooks]
postinstall = "bun install"

[env]
_.path = "node_modules/.bin"

[tasks.dev]
description = "Start development server"
run = "bun run dev"

[tasks.build]
description = "Build the project"
run = "bun run build"