Skip to content

mise.md

Latest commit

 

History

History
109 lines (81 loc) · 2.85 KB

mise.md

File metadata and controls

109 lines (81 loc) · 2.85 KB

Mise Tasks

This repo uses mise in two different scopes:

  • .mise/tasks/ defines repo tasks for humans and agents.
  • Root mise.toml is the repo-level mise config and documents that task entrypoints live in .mise/tasks/.
  • chezmoi/private_dot_config/mise/config.toml defines machine runtime and tool versions applied into ~/.config/mise/config.toml.

Do not mix those scopes. A repo command belongs in .mise/tasks/; a shared machine runtime pin belongs in the chezmoi-managed home config.

Trust the repo config once per checkout before using repo tasks or installing runtime pins:

mise trust

Without that local trust record, mise refuses to parse mise.toml, so mise install, mise tasks, and mise run ... all fail before task discovery.

Tasks

Keep task wrappers deterministic and non-interactive:

  • Use explicit repo-relative commands such as ./scripts/verify/repo.sh.
  • Add a concise #MISE description="..." header for every task.
  • Prefer task names users can guess: verify, verify:fast, dotfiles:diff, dotfiles:apply.
  • Do not embed secrets, hostnames, personal paths, or environment-specific credentials.
  • Do not replace repo scripts with long wrapper logic when a script already owns the behavior.
  • Keep task files executable so mise can discover them.

Nested file tasks define the visible task namespace:

.mise/tasks/verify/_default        -> mise run verify
.mise/tasks/verify/fast            -> mise run verify:fast
.mise/tasks/audit/repo/_default    -> mise run audit:repo
.mise/tasks/audit/repo/json        -> mise run audit:repo:json

Inspect tasks with:

mise trust
mise tasks --json

Run the changed task directly, then run:

mise run verify

Task Namespaces

Repository checks:

mise run verify
mise run verify:repo
mise run verify:fast
mise run audit:repo
mise run audit:repo:json
mise run audit:mscp

Live host checks:

mise run verify:bootstrap:personal
mise run verify:bootstrap:devbox
mise run verify:devbox-services
mise run audit:host
mise run audit:host:json
mise run audit:personal
mise run audit:personal:json
mise run audit:devbox
mise run audit:devbox:json

Use repo checks for ordinary PR work. Use live host checks only on a machine that should actually satisfy that profile or audit boundary.

Bootstrap helpers:

mise run bootstrap:trust-agent-worktrees

This trusts existing mise.toml and .mise.toml files near the roots of Codex and Claude generated worktrees. It is also called by scripts/bootstrap/install.sh.

Runtime Pins

When changing chezmoi/private_dot_config/mise/config.toml:

  1. Confirm the pin is intended for all uinaf machines.
  2. Keep exact versions where practical.
  3. Preview dotfile output with mise run dotfiles:diff.
  4. Run mise run verify.

Avoid floating runtime versions such as latest in shared machine config.