Governance Commands

Governance commands operate on matic's control plane: the policies, guardrails, budgets, decisions, audit entries, and human-in-the-loop checkpoints that determine what agents are authorized to do and what is recorded when they act. All governance state is plain files under .matic/ (policies, decisions, audit, budget), so these commands are thin queries and writers over a git-tracked source of truth. Use them to inspect what is allowed right now, change the rules, unblock paused work, and reconstruct who did what and why.

Audit Log

Query the immutable, tamper-evident record of consequential actions — activations, policy evaluations, guardrail interventions, HITL decisions, budget changes, and Regression Check outcomes — filtered by scope, actor, action, or time range. Read more

Budget Status

Show current consumption against allocated limits at org, project, team, or agent scope, with period window, remaining tokens, gate state (open / warning / exceeded), and forecast. Read more

Decision Log

Query Decision records attached to any entity (org, project, task, work-item, agent), with rationale, alternatives considered, author, and whether the decision is active, superseded, or revoked. Read more

Guardrail Status

Inspect active runtime guardrails — grounding, tool invocation, file scope — including their interception hooks, recent violation counts, and the actions blocked or rewritten in flight. Read more

HITL Approve

Respond to a paused human-in-the-loop checkpoint: approve work to resume, reject with revision instructions, or (owner-only) override a policy or Baseline violation. Writes a Decision and an Audit entry per the dual-write rule. Read more

Policy List

List active Policies in scope, showing triggers, conditions (agent handle, branch, budget, time-of-day), enforcement mode (block / warn / log), and override requirements. Read more

Policy Set

Author or update a Policy file under .matic/policies/. Changes are PR-reviewed like any other repository change before they take effect on the Daemon. Read more