Practical overview
When it fits
Use Distill when you want a terminal-based coding-agent workflow and need to choose among supported subscription or OpenAI-compatible model options, with configurable session modes and optional model tiers.
Who it is for
- Developers who want to direct coding-agent work from a terminal.
- Developers using supported Grok, Claude or Codex subscriptions, or OpenAI-compatible models.
- Users who want to divide work among a main model and optional worker or utility models.
Documented uses
- Run a coding-agent session through a terminal interface or headless prompt mode.
- Assign planning and review to a main model, with optional delegated work for a worker model.
- Choose a session mode that changes its approach to search and reading, planning, or delegation.
- Set model tiers for bounded tasks such as extraction, summaries and compression.
Requirements & limits
The README documents CLI installation for Mac, Linux and Windows. Its setup sequence includes logging in with OpenRouter and then with a subscription.
- Distill separates the required main model from optional worker and utility models; without a worker model, the main model does the work.
- Auto is the default mode. UltraSave, UltraFast and UltraCode are alternative documented modes with different approaches.
- The project reports benchmark comparisons on its own tasks; consult its benchmark documentation for methodology and tradeoffs.
- The repository is public and licensed under Apache-2.0.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Install Distill on Mac or Linux
Install the CLI using the README's documented shell installer and add its binary directory to PATH.
Before you start
- A Mac or Linux shell environment.
Steps
Run the README's install command: the command below.
curl -fsSL https://raw.githubusercontent.com/samuelfaj/distill/main/install.sh | shAdd
$HOME/.local/share/distill/binto PATH as shown in the README.Run
distill --versionto display the installed version.
Expected outcome
The README's installation steps place Distill's binary in the listed directory and provide a command to display its version.
Guide limitations
- This guide covers installation only; it does not configure a provider or start a coding session.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 7 November 2026
- Original website title
- samuelfaj/distill · Official homepage title · retained in its source language

