Distill
September 21, 2026 ยท View on GitHub

Distill is a lightweight coding agent harness and TUI, built to get far more done with far fewer tokens.
It works with Grok and Codex subscriptions, and with any model that speaks the OpenAI-compatible protocol.
Steps:
- Download distill.
- Login with openrouter.
- Login with your subscription.
- Save money.
Install
Mac / Linux
curl -fsSL https://raw.githubusercontent.com/samuelfaj/distill/main/install.sh | sh
export PATH="$HOME/.local/share/distill/bin:$PATH"
distill --version
Windows
irm https://raw.githubusercontent.com/samuelfaj/distill/main/install.ps1 | iex
$bin = "$env:LOCALAPPDATA\distill\bin"; [Environment]::SetEnvironmentVariable('Path', "$bin;" + [Environment]::GetEnvironmentVariable('Path', 'User'), 'User')
distill --version
Upgrade
For an installation made with the release installer:
distill update
Choose your models
Open Model tiers on the home screen, click change beside the current
model, or enter /tiers. You can edit each tier in that screen.
| Tier | Purpose | Picker |
|---|---|---|
| Reasoning model | Handles the main conversation, difficult reasoning, and code changes. | /model or /tiers reasoning |
| Worker model | Takes suitable calls in the same conversation when a lighter model can handle them. Optional. | /worker-model or /tiers worker |
| Utility model | Handles bounded tasks such as extraction, summaries, and compression. | /utility-model or /tiers utility |
Each picker helps you choose a model and its effort. auto is available and is
the default. You can also supply the selection directly:
/model gpt-6-astra auto
/worker-model gpt-5.6-luna auto
/utility-model openrouter-qwen37 auto