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 --versionAll 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 <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 (please tag titles with
[cli])
Feedback
File issues at https://github.com/microsoft/Foundry-Local/issues with the [cli] tag and include the output of foundry report.