An interactive shell.
A scriptable tool.
With no arguments, dwim starts an interactive session in the current directory. Given a prompt, it answers and exits.
$ dwim
$ dwim "Explain the locking assumptions in this module." > locking.md
$ dwim --stats "Add a regression test for this failing case."
$ dwim --shell ./in-container "Find the allocation hot spots."
The reply is standard output
Nothing else is written there. Progress, the model's thinking, the commands it runs and their output go to standard error. Exit status is 0 or 1.
Six tools
bash, read, write, edit, glob and grep. Commands run as sh -c, or as program -c with --shell, to run them in a container.
AGENTS.md
If the working directory has one, its contents are given to the agent as project instructions.