humanize (hmz)
The agent flow system for token maxxing.
Install
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 hmz
Three backends need a package of their own: [dsh] for DeepSeek Harness, [kimi] for Kimi
Code, [litellm] for a model called directly -- or most CLIs run through litellm, as any
account it can reach -- [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 webDesktop app
On macOS, humanize-<version>-macos-universal.dmg from the
latest release puts hmz web in a
window of its own: drag humanize to Applications. It runs the hmz installed above. The
guide says how to open it the first time.
Usage
Open the terminal interface in a repository:
hmz
Or open every epic on this machine in a browser:
hmz web
Or run a flow from your shell:
hmz exec -f chat -a assistant=claude/claude-opus-5:high "What does this repository do?"
Agents run with approvals bypassed, so start in a scratch repository. The documentation opens with a quickstart.
Contributing
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.
License
Apache-2.0 © Humanfia