Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 28 additions & 1 deletion docs/dev-tools/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -142,7 +142,34 @@ port = 6379

Internally, nested options are flattened to dot notation (e.g., `platforms.macos-x64.url`, `database.host`, `cache.redis.port`) for backend access.

### Caching and Performance
## OS-Specific Tools

You can restrict tools to specific operating systems using the `os` field:

```toml
[tools]
# Only install on Linux and macOS
ripgrep = { version = "latest", os = ["linux", "macos"] }

# Only install on Windows
"npm:windows-terminal" = { version = "latest", os = ["windows"] }

# Works with other options
"cargo:usage-cli" = {
version = "latest",
os = ["linux", "macos"],
install_env = { RUST_BACKTRACE = "1" }
}
```

The `os` field accepts an array of operating system identifiers:
- `"linux"` - All Linux distributions
- `"macos"` - macOS (Darwin)
- `"windows"` - Windows

If a tool specifies an `os` restriction and the current operating system is not in the list, mise will skip installing and using that tool.

## Caching and Performance

mise uses intelligent caching to minimize overhead:

Expand Down
Loading