Foundry Local CLI 0.10.1 (Preview)

Public preview update for the Foundry Local CLI.

Important

Preview. This is an early CLI build. Expect rough edges, missing polish, and changes between releases. Please file issues with [cli] in the title and include foundry report output when possible.

What's New

Updated Foundry Local SDK

This build updates the Foundry Local SDK packages to 1.2.3, including improved model registry fallback behavior for the EastUS catalog issue.

Default diagnostic logging

The CLI now configures daemon, SDK, and Core logging at info by default so diagnostic logs such as foundry.core*.log are available for support/debugging.

You can tune log verbosity persistently:

foundry config show
foundry config set log-level debug
foundry config reset log-level

Supported values:

debug | info | warn | error

Public issue reporting

foundry report now points users at the public microsoft/Foundry-Local issue tracker for CLI feedback and diagnostics.

Better model list readability

foundry model list now includes footer legends that explain the Type, Device, Tools, and Cached columns. Use --variants to see every hardware-specific variant, provider, size, and cache state.

Install

Pick the asset for your platform from the downloads list below.

Platform	Asset
Windows x64	foundry-0.10.1-win-x64-winml.msix recommended, or foundry-0.10.1-win-x64.msix
Windows ARM64	foundry-0.10.1-win-arm64-winml.msix recommended, or foundry-0.10.1-win-arm64.msix
macOS Apple Silicon	foundry-0.10.1-osx-arm64.pkg
macOS Apple Silicon zip	foundry-0.10.1-osx-arm64.zip
Linux x64	foundry-0.10.1-linux-x64.tar.gz
Linux ARM64	foundry-0.10.1-linux-arm64.tar.gz

# Windows
Add-AppxPackage .\foundry-0.10.1-win-x64-winml.msix
foundry --version

# macOS
sudo installer -pkg foundry-0.10.1-osx-arm64.pkg -target /
foundry --version

# Linux
tar xzf foundry-0.10.1-linux-x64.tar.gz
cd foundry-0.10.1-linux-x64
./lib/foundry --version

All binaries are signed by Microsoft Corporation. SHA-256 digests are shown on the asset list above.

Quick Start

foundry status
foundry model list
foundry model load qwen3-0.6b
foundry chat qwen3-0.6b
foundry transcribe -m whisper-tiny -f audio.wav
foundry server stop

Most commands accept --output json for scripting. Run foundry --help for the full command surface.

Coming from the older Foundry Local CLI?

The earlier service-based CLI has been replaced. Common commands map roughly as follows:

Old service-based CLI	New CLI
foundry service start / stop / restart / ps / diag	foundry server start / stop / restart / logs
foundry cache remove	foundry cache rm
foundry model run <alias>	foundry run <alias>
foundry model info <alias>	foundry model show <alias>

Run foundry --help for the full surface.

Links

• Docs: https://aka.ms/foundry-local-docs
• SDK: https://github.com/microsoft/Foundry-Local/tree/main/sdk
• Discord: https://aka.ms/foundry-local-discord
• Issues: https://github.com/microsoft/Foundry-Local/issues

Feedback

File issues at https://github.com/microsoft/Foundry-Local/issues with [cli] in the title and include the output of foundry report.