Hexi Documentation

Hexi is a local-first, contract-driven coding-agent runtime for Python teams that want strict execution boundaries and clear audit trails.

What Hexi does today

• Runs one agent step per invocation (hexi run).
• Parses strict ActionPlan JSON before any side effects.
• Executes only policy-allowed commands and repo-scoped file operations.
• Emits structured events to console and .hexi/runlog.jsonl.

Recommended reading path

1. Quickstart
2. First Successful Run
3. CLI
4. Action Plans
5. Troubleshoot Failing Runs

Product boundaries

Hexi is intentionally focused:

• single-step execution,
• local repository workflows,
• explicit policies,
• adapter-based integrations.

This keeps behavior inspectable and refactors low-risk.

If you are integrating into your own codebase

Start with Embedded Python, then review Hexagonal Architecture.