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, [all] for all three.

uv tool install 'hmz[all]'

hmz update moves it to the newest release, keeping the extras it was installed with.

Desktop 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