GoodQ Mini Agent

goodq-mini-agent is a local-first, zero-dependency policy, governance, and delegation package for GoodQ-compatible applications.

It ships fixed policy assets and a non-executing preflight API. It does not require a network service, collect telemetry, or persist task content.

Install

Install a pinned release wheel from this repository's Releases page. Applications should pin both the release version and its SHA-256 digest.

Validate

python -m pip install .
goodq validate --profile safe
python -m pytest tests

Non-executing preflight

from goodq_mini_agent.preflight import preflight_task

decision = preflight_task(
    prompt="Inspect current status",
    mode="research",
    requires_tools=False,
)
assert decision["execution_performed"] is False

License

MIT. See LICENSE.