AgentSkillsCN

managing-mise

当用户请求“添加密钥”、“创建.age文件”、“使用agenix加密”、“解密密钥”，或在使用“agenix -e”、“/dev/stdin”报错、遭遇“age加密”、“secrets.nix”、“重新加密”、“age密钥”、“身份路径”等问题时，本技能将为您提供专业指导。

SKILL.md
--- frontmatter
name: managing-mise
description: |
  This skill should be used when the user asks about mise, "pnpm not found",
  "node version mismatch", ".nvmrc", "mise shims", "mise activate",
  or encounters runtime version issues in non-interactive SSH.
  Covers Node.js source build when prebuilt binaries fail.

mise 런타임 버전 관리

mise를 사용한 Node.js, pnpm 등 런타임 버전 관리 가이드입니다.

빠른 참조

mise 설정 위치

파일용도
~/.config/mise/config.toml전역 설정
mise.toml / .mise.toml프로젝트별 설정
mise.local.toml프로젝트 로컬 (gitignore됨)
.nvmrc, .node-versionNode.js 버전 (idiomatic files)

주요 명령어

bash
# 현재 버전 확인
mise current

# 전역 버전 설정
mise use -g node@lts

# 프로젝트 버전 설치
mise install node@20.18

# NixOS에서 node 설치 (바이너리)
MISE_NODE_COMPILE=0 mise use -g node@lts

관련 설정 파일

파일용도
modules/shared/programs/shell/default.nixzsh mise 활성화
modules/shared/programs/mise/mise 패키지 설정

자주 발생하는 문제

  1. •SSH 비대화형 세션에서 pnpm not found: .zshenv에 mise shims 누락
  2. •.nvmrc 인식 안 됨: idiomatic_version_file_enable_tools 설정 필요
  3. •NixOS에서 node 빌드 실패: MISE_NODE_COMPILE=0 환경변수 필요

레퍼런스