Tools
Last updated 3 September 2026
| Tool | When | What comes back | Next |
|---|---|---|---|
hexum_skill | First Hexum use this session if SKILL.md is missing, or when intensity changes. | Skill file body, write path, whether to update architecture.hexum. | Write body to path if missing. Follow that file. |
hexum_shrink | Before reading a repo or a wide file set. | A smaller view of those files, plus token counts for the call. | Read that view. Do not dump the originals into the prompt. |
hexum_expand | When one folded function, class, or method is the thing to patch. | The full source of that symbol. | Edit from that body. Do not expand the whole file just in case. |
hexum_splice | When applying the patch. | The updated region, still valid source. | Keep the write small: one symbol or one line. You keep Git. |
hexum_check | Before claiming the turn is done. | healthy, drift_detected, or ARCHITECTURE_CONFIG_MISSING, plus violations. | On drift, follow hint and check again. Do not ship a red check. |
hexum_review | When reviewing a git diff or a GitHub pull request. | approved or changes_requested, violations, token delta, GitHub markdown. | Post the markdown, or let the GitHub webhook do it. |
hexum_control_status | When the agent is repeating edits or failing the same check. | Drift score, health, churn, suggested forbid lines. | If stuck_in_loop, write the patch before more edits. |
hexum_loop_start | When starting a gated build loop for a goal. | loop_id and the next instruction (shrink, edit, check, test, tick). | Follow the instruction. Tick with compile and test output. |
FAQ
How does Hexum reduce tokens?
The agent calls hexum_shrink before it reads widely. The model is sent this turn, not the repository. On MBPP, measured context dropped about 85% with the same tests passing. Example turn: 18.2k → 3.1k tokens, 41 files → 6. See /benchmarks and /methodology.
Is hexum_check an LLM?
No. hexum_check is deterministic. It maps files to layers in architecture.hexum and reports forbidden imports. It does not call a model.
What is Hexum?
Hexum is the control plane for coding agents. One hexum_live_ key authorizes hosted MCP on hexum.dev and on efficient, arch, review, control, and loop subdomains. hexum_shrink sends this turn instead of the repository. hexum_check fails a forbidden import without calling a model. On MBPP, context dropped about 85% with the same tests passing.