pantheon-ai/mise-complete

Configure and operate Mise for deterministic developer environments. Use when installing runtime/tool versions, defining reusable tasks, managing layered environment variables, migrating from asdf/nvm/pyenv, or debugging mise.toml behavior in CI and local shells. Keywords: mise, mise.toml, tool versions, tasks, env, asdf migration, setup automation, dev environment.

Overall
score

99%

Review — 99%

Does it follow best practices?

Validation — 10 / 11 Passed

Validation for skill structure

Task Execution

Name: pantheon-ai/mise-complete
Author: pantheon-ai

Running Tasks

Basic Execution

# Run a single task
mise run build

# Run with short alias
mise r build

# List all available tasks
mise tasks ls
mise tasks

Task Dependencies

Dependencies run automatically before the main task:

[tasks.deploy]
run = "./deploy.sh"
depends = ["build", "test"]

# Running 'deploy' will automatically run 'build' and 'test' first
mise run deploy

Sequential vs Parallel Execution

Sequential (default for array of commands):

[tasks.ci]
run = [
  "mise run lint",    # Runs first
  "mise run test",    # Runs second
  "mise run build"    # Runs third
]

Parallel (for independent dependencies):

[tasks.ci]
depends = ["lint", "test"]  # Run in parallel
run = "mise run build"

Task Arguments

# Pass arguments after --
mise run test -- --verbose --coverage

# Multiple arguments
mise run deploy -- --env production --region us-east-1

File Watching

Watch files and re-run tasks on changes:

# Watch and re-run on file changes
mise watch build

# Watch specific files
mise watch -g "src/**/*.ts" build

Configuration:

[tasks.dev]
run = "npm run dev"
sources = ["src/**/*.ts", "src/**/*.tsx"]
outputs = ["dist/**/*"]

Task Aliases

Define shortcuts for common tasks:

[tasks.test]
alias = "t"

[tasks.deploy-production]
alias = ["deploy:prod", "dp"]

mise run t          # Runs test
mise run deploy:prod # Runs deploy-production

Environment Variables in Tasks

Task-Specific Environment

[tasks.test]
run = "pytest"
env = { PYTEST_ARGS = "--verbose", DEBUG = "true" }

Accessing Mise Variables

[tasks.deploy]
run = "echo Deploying from {{ config_root }}"

Built-in variables:

{{ config_root }}: Directory containing mise.toml
{{ cwd }}: Current working directory

Monorepo Task Execution

Workspace Tasks

# Root mise.toml
[tasks.build-all]
run = "mise run -C packages/api build && mise run -C packages/web build"

# Or use a script
[tasks.build-all]
run = '''
for pkg in packages/*; do
  mise run -C "$pkg" build
done
'''

Per-Package Tasks

# Run task in specific package
mise run -C packages/api test

# Run task in all packages
for pkg in packages/*; do
  mise run -C "$pkg" lint
done

Task Output

Capturing Output

# Save output to file
mise run build > build.log 2>&1

# Pipe to other commands
mise run test | grep FAILED

Silent Execution

[tasks.check]
run = "curl -sf https://api.example.com/health"

Error Handling

Exit Codes

Tasks return the exit code of the last command:

[tasks.ci]
run = [
  "mise run lint",   # If this fails, task stops
  "mise run test",
  "mise run build"
]

Ignore Errors

#!/usr/bin/env bash
# mise description="Cleanup (ignore errors)"

rm -rf dist || true
rm -rf coverage || true

Conditional Execution

#!/usr/bin/env bash
set -e  # Exit on error

mise run test && mise run deploy || echo "Deployment cancelled"

Best Practices

Check Task Status: Use mise tasks ls to verify task registration
Test Dependencies: Ensure dependent tasks run in correct order
Use Exit Codes: Return proper exit codes for CI/CD integration
Log Verbosity: Use environment variables to control logging
Dry Run: Implement --dry-run flags for destructive tasks
Timeouts: Set reasonable timeouts for long-running tasks

Common Patterns

Interactive vs CI Mode

#!/usr/bin/env bash
# mise description="Run tests"

if [ -t 0 ]; then
  # Interactive mode
  pytest --verbose
else
  # CI mode
  pytest --quiet --junit-xml=results.xml
fi

Retry Logic

#!/usr/bin/env bash
# mise description="Deploy with retry"

max_attempts=3
attempt=1

while [ $attempt -le $max_attempts ]; do
  if ./deploy.sh; then
    exit 0
  fi
  echo "Attempt $attempt failed, retrying..."
  ((attempt++))
  sleep 5
done

exit 1

Progress Reporting

#!/usr/bin/env bash
# mise description="Multi-step build"

echo "Step 1/3: Linting..."
mise run lint

echo "Step 2/3: Testing..."
mise run test

echo "Step 3/3: Building..."
mise run build

echo "✓ Build complete"

Install with Tessl CLI

npx tessl i pantheon-ai/mise-complete@0.1.0

references

config-anti-patterns.md

config-best-practices.md

tasks-organization.md

tasks-patterns.md

tools-installation.md