exactor 0.1.0

Enforce the discipline your AGENTS.md only suggests.

exactor

Disciplinam quam AGENTS.md tantum suggerit, impone.
Enforce the discipline your AGENTS.md only suggests.

Exactor is a Claude Code hooks layer that makes subagent delegation mandatory, not optional. Configure once in .exactor.yml — your researcher, explorer, and log digger fire every time, not just when the model decides to.

The problem

You write in your AGENTS.md: "use the researcher tool for web questions."
The model reads it. Sometimes follows it. Often doesn't.

Exactor turns that suggestion into a constraint. A WebSearch call triggers your researcher. A grep triggers your explorer. The raw tool never fires. Not sometimes — always.

How it works

Claude Code fires hooks before and after every tool call. Exactor sits in those hooks, matches tool calls against rules you define in .exactor.yml, and routes them to the configured worker instead. Workers are plain shell commands — bring your own.

# .exactor.yml
workers:
  research:
    command: "research {query}"
  explore:
    command: "explore {query}"

intercept:
  - tool: WebSearch
    route_to: research
  - tool: Bash
    match: "^(grep|rg|find)\\b"
    route_to: explore

Recipes

Ready-made configs for common researcher and explorer tools live in recipes/. Copy the one matching your setup and drop it in your repo root.

• recipes/vibe — Mistral Vibe as a mandatory researcher
• more coming (Claude CLI, Perplexity, Ollama — contributions welcome)

Worker contract

A worker is any CLI that:

• accepts the intercepted query via {query} substitution
• reads nothing from stdin (by default; configurable via stdin:)
• writes the result to stdout
• writes errors to stderr
• exits 0 on success, non-zero on failure

Pass flags via args:, secrets via env:. See recipes/vibe/.exactor.yml for a complete example.

Status

Early development. Core hook dispatcher and SQLite working-memory cache are in place. Structured worker invocation (args / env / stdin / cwd) landed.

Installation

pipx install exactor
exactor init

Published to PyPI soon.

License

MIT