<div align="center"> <img src=".github/assets/hero.png" width="200" alt="dwim logo: a small robot sitting cross-legged, eyes closed, at peace">

dwim

Do what I mean.

A coding agent that runs on your own GPU.

The agent, the model, and the engine that runs it, in one Rust program: no API key, no server, and nothing leaves your machine.

</div>

[!WARNING] dwim is experimental software. Expect bugs, rough edges, and changes that break things from one commit to the next. The model runs shell commands on your machine without asking first, so use it on code you have committed or backed up.

Installation

To install the latest release:

curl -fsSL https://dwim.sh/install.sh | sh

To install the latest development version:

cargo install --git https://github.com/dwim-sh/dwim

Or, from a checkout, with the manual page:

make install                     # in ~/.local
make install PREFIX=/usr/local   # system-wide, which may need sudo

Either way, the model (16 GB) is downloaded on first use into your Hugging Face cache, where hf download and other tools would put it, and used from there if one of them already did. dwim --download fetches it ahead of time.

Features

• Fully local coding agent. Runs commands, reads their output, and keeps going.
• Qwen3.8-27B. At four bits, 16 GB, on a machine with 32 GiB of memory or more, decoding several tokens at a time with the drafter its file ships.
• Fast local inference. Metal on macOS, Vulkan on Linux.
• Bring your own sandbox. dwim expects to run inside a sandbox, such as a container or a virtual machine, and does not confine the model itself. Commands run without confirmation and without a time limit, until they finish.

Getting started

Run dwim in a project directory. It opens a shell: type what you want, and the model reads files, runs commands, and answers.

<div align="center"> <img src=".github/assets/session.png" width="760" alt="A dwim session: after typing Explain this codebase to me in one sentence, the model reads README.md and replies with one sentence"> </div>

To ask one thing and exit, give the prompt on the command line:

dwim "Explain this codebase to me in one sentence."

The manual page has the options, the shell's commands and keys, and the files it reads:

man dwim

Using dwim as a sub-agent

dwim also makes a good sub-agent: your main agent plans the change, and dwim writes the code. The dwim skills teach an agent such as Claude Code or Codex to delegate to it:

npx skills add dwim-sh/skills

Then, in the agent, ask for the change "with dwim":

1. /dwim-plan reads the code, decides the design, and writes one self-contained task file per commit under .dwim/plans/<name>/, with a PLAN.md that holds the goal, the design, the checks, and the steps as a checklist. It runs nothing: you read the plan and edit what you want.
2. /dwim-do hands the next task file to dwim, watches the run, reviews the change as it would a pull request, fixes and verifies it, commits it with Generated-by: dwim, and ticks the step off. /dwim-do all goes on until a step fails review or none remain.

The main agent spends its tokens on the decisions and the review, and dwim, on your own GPU, on the code.

License

MIT.