A minimal, extensible AI agent harness with a unified multi-provider LLM API, agent runtime, terminal UI, and a coding agent CLI.
lmstudio-ai/lms
Command-line tool for LM Studio to manage local models, load and unload them, and control the local API server.
- Stars
- 5,363
- Forks
- 495
- Open issues
- 346
- Last commit
- 6 days ago
What is it?
lms is the command-line interface for LM Studio, a desktop app for running large language models locally. It lets you check app status, list downloaded and loaded models, and load or unload them from the terminal, with options such as full GPU acceleration for loading.
The CLI also controls the local API server, so you can start and stop it from scripts or over SSH without opening the GUI. Output can be emitted as JSON for machine-readable use, and log streaming is available for debugging. It can scaffold a new project that uses the LM Studio SDK.
lms is built on lmstudio.js and is written in TypeScript on Node.js. It ships with LM Studio 0.2.22 and newer, and the repository notes that it is part of the lmstudio.js monorepo and cannot be built on its own.
Key features
- 01Lists downloaded and loaded models, with JSON output for scripting.
- 02Loads and unloads models, including GPU acceleration options.
- 03Starts and stops the local API server from the terminal.
- 04Streams LM Studio logs for debugging.
- 05Creates new projects that use the LM Studio SDK.
Use cases
- Managing local LLMs on a headless server or over SSH.
- Automating model loading and server control in shell scripts or CI.
- Bootstrapping a Node.js or TypeScript project that uses the LM Studio SDK.
Quick start
- 1
Install LM Studio 0.2.22 or newer, which ships with lms
- 2
If the command is not found, add lms to PATH using npx
npx lmstudio install-cli - 3
Open a new terminal and check that lms runs
lms - 4
Start the local API server
lms server start
Things to know
- Requires the LM Studio desktop app (0.2.22 or newer) to be installed.
Topics
FAQ
- What is lms?
- Command-line tool for LM Studio to manage local models, load and unload them, and control the local API server. lms is the command-line interface for LM Studio, a desktop app for running large language models locally. It lets you check app status, list downloaded and loaded models, and load or unload them from the terminal, with options such as full GPU acceleration for loading.
- Is lms free to use? What license does it have?
- lms is open source under the MIT license. Check the license terms before using it in commercial products.
- Is lms still maintained?
- Actively maintained. The last commit to lms was on Oct 14, 2026.
- What can I use lms for?
- Managing local LLMs on a headless server or over SSH. Automating model loading and server control in shell scripts or CI. Bootstrapping a Node.js or TypeScript project that uses the LM Studio SDK.
- How do I install lms?
- Install LM Studio 0.2.22 or newer, which ships with lms If the command is not found, add lms to PATH using npx: npx lmstudio install-cli Open a new terminal and check that lms runs: lms Start the local API server: lms server start
- Where can I get lms?
- The source code and installation instructions are on GitHub: https://github.com/lmstudio-ai/lms
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
Open source autonomous coding agent that runs as an IDE extension, terminal CLI, desktop app, or SDK.
A TypeScript coding agent CLI where a single 'ulw' or 'mass ulw' keyword in your prompt makes it plan, delegate to multiple models, and verify the work.
A Rust CLI and TUI that detects your CPU, RAM and GPU, then ranks open LLMs by how well they will run on your machine.
An open-source coding-agent CLI that runs in the terminal and works with cloud APIs and local model backends like Ollama.
A workflow and runtime layer for OpenAI Codex CLI that adds structured planning, durable goal execution, parallel agent teams, and state tracking under .omx/.