microsoft/Foundry-Local cli-preview-0.10.0

Foundry Local CLI 0.10.0 (Preview)

Repository: microsoft/Foundry-Local

Tag: cli-preview-0.10.0

Published: 2026-06-04T20:35:47Z

Prerelease: yes

Release notes: Public preview of the Foundry Local CLI — the first release of the new CLI built on the Foundry Local SDKs, replacing the earlier service-based CLI.

> [!IMPORTANT] > Preview. This is an early build — expect rough edges, missing polish, and changes between releases. Please file issues (tag titles with [cli]) for anything you hit.

What it's for

The Foundry Local CLI is the terminal entry point to Foundry Local: install and manage models, start and inspect the local server, run quick chat / completion / transcription tests, and pull diagnostics. It pairs with the SDK — the CLI is what you reach for from a terminal or script, the SDK is what you call from your app.

Install

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

| Platform | Asset | |---|---| | Windows x64 | foundry-0.10.0-win-x64-winml.msix (recommended) or -win-x64.msix | | Windows ARM64 | foundry-0.10.0-win-arm64-winml.msix (recommended) or -win-arm64.msix | | macOS (Apple Silicon) | foundry-0.10.0-osx-arm64.pkg | | Linux x64 | foundry-0.10.0-linux-x64.tar.gz | | Linux ARM64 | foundry-0.10.0-linux-arm64.tar.gz |

On Windows and macOS you can also double-click the installer to install with the OS installer. The commands below are the scripted equivalents.

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

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

# Linux
tar xzf foundry-0.10.0-linux-x64.tar.gz
./foundry/foundry --version

All binaries are signed by Microsoft Corporation. SHA-256 digests are shown on the asset list above (click an asset's filename).

Quick start

foundry status # system info and service state
foundry model list # available models
foundry model load qwen3-0.6b # download (if needed) and load
foundry chat qwen3-0.6b # interactive chat
foundry transcribe -m whisper-tiny -f audio.wav # transcribe a local audio file
foundry server stop # release the daemon when done

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 (required to use Foundry Local before the SDKs shipped) has been replaced. Common commands map roughly as follows:

| Old (service-based CLI) | New | |---|---| | foundry service start / stop / restart / ps / diag | foundry server start / stop / restart / logs | | foundry cache remove | foundry cache rm | | foundry model run | foundry run | | foundry model info | foundry model show |

Run foundry --help for the full surface.

Links

• Docs:
• SDK:
• Discord:
• Issues: (please tag titles with [cli])

Feedback

File issues at with the [cli] tag and include the output of foundry report.