doer-cli 0.2.1

doer — one-file pipe-native agent. strands-agents + ollama only.

DOER

stdin → llm → stdout

A Unix citizen that thinks. One file. One dep. Zero ceremony.

---

install

Pick your path. All three give you do on your $PATH.

# 1) pipx — isolated, auto-updatable (recommended)
pipx install doer-cli

# 2) pip — any venv
pip install doer-cli

# 3) one-liner (prebuilt binary, no Python needed)
curl -sSL https://raw.githubusercontent.com/cagataycali/doer-cli/main/install.sh | sh

Two binaries get installed: do (short) and doer (long). Pick your poison.

run

do "find files larger than 100MB"

cat error.log  | do "what broke"
git log -20    | do "write release notes"
echo '{"a":1}' | do "to yaml"
curl -s api.io | do "summarize" | tee out.md

what it is

Agent(
    model=Ollama(...),
    tools=[shell] + hot_reload("./tools"),
    system_prompt=SOUL.md + AGENTS.md + ~/.doer_history
                + ~/.bash_history + ~/.zsh_history + own_source,
)(stdin + argv)

That's the entire architecture. 164 lines of Python. It reads your shell like a person reads a room.

context it sees every call

source	what
SOUL.md (cwd)	who it is in this project
AGENTS.md (cwd)	rules for this project
~/.doer_history	last N Q/A (DOER_HISTORY=10)
~/.bash_history + ~/.zsh_history	last N commands (DOER_SHELL_HISTORY=20)
./tools/*.py	hot-reloaded @tool functions
own source	full self-awareness

No database. No config file. The filesystem is the memory.

env knobs

DOER_MODEL=qwen3:1.7b            # any ollama model
OLLAMA_HOST=http://localhost:11434
DOER_HISTORY=10                  # Q/A rows in prompt
DOER_SHELL_HISTORY=20            # shell rows in prompt

extend in 60 seconds

# ./tools/weather.py
from strands import tool
import urllib.request

@tool
def weather(city: str) -> str:
    """Weather for a city."""
    return urllib.request.urlopen(f"https://wttr.in/{city}?format=3").read().decode()

Next call: do "istanbul weather?" — hot-reloaded, no restart.

philosophy

┌─────┐       ┌──────┐       ┌──────┐
│stdin│──────▶│  do  │──────▶│stdout│
└─────┘       └──────┘       └──────┘

grep with a brain. Chain it. Script it. Cron it.

Read SOUL.md for the manifesto. Read AGENTS.md for the rules.

family

project	size	purpose
doer	164 LOC	one pipe, one shell, one file
DevDuck	60+ tools	every protocol, every edge

uninstall

pipx uninstall doer-cli    # or: pip uninstall doer-cli
rm /usr/local/bin/do       # if installed via curl

license

Apache-2.0 · built in New York · 2026

---

do one thing and do it well — Doug McIlroy, 1978