The agent flow system for token maxxing.
Humanize Desktop is the page of hmz web in a window of its own. Download it from the
latest release:
humanize-<version>-macos-universal.dmg on macOS, where you install Humanize CLI as below
too, or humanize-<version>-windows-x64-setup.exe on Windows, where the app installs hmz
itself, in WSL 2 (wsl --install).
Installation says how to open it the
first time.
Humanize CLI needs Python 3.12 or newer, uv, and a coding agent CLI you are signed in to, such as Claude Code or Codex.
uv tool install hmzThree backends need a package of their own: [dsh] for DeepSeek Harness, [kimi] for Kimi
Code, [litellm] for litellm, [all] for all three.
uv tool install 'hmz[all]'hmz update moves it to the newest release, keeping the extras it was installed with.
Or run it without installing, from a copy uv caches -- @latest asks for the newest release:
uvx hmz@latest
uvx --from 'hmz[all]' hmz webOpen the terminal interface in a repository, on a chat with your coding agent; $<flow> or
/flow <flow> <task> starts a flow from there, and /chat comes back to the chat:
hmzOr open every epic on this machine in a browser:
hmz webOr say one thing to an agent from your shell:
hmz chat -a claude/claude-opus-5:high "What does this repository do?"Humanize ships no flow: install one from the official
flowverse in /flow, under Flowverses, or write
your own. Then run it from your shell, under a budget:
hmz exec -f ralph_loop -a agent=claude/claude-opus-5:high -p budget.cost=5 "Make the tests pass"Or name a release by its repository, with nothing installed:
hmz exec -f git+https://github.com/humanfia/ralph-loop-flow@v0.1.0#ralph_loop \
-a agent=claude/claude-opus-5:high -p budget.cost=5 "Make the tests pass"Agents run with approvals bypassed, so start in a scratch repository. The documentation walks through a first run.
Pull requests are welcome: CONTRIBUTING.md says how to propose one. Report a bug or request a feature through the issue forms, and report a vulnerability privately, as SECURITY.md says. Everyone taking part follows the Code of Conduct.
Apache-2.0 © Humanfia