Skip to content

writ approve

An enforcing connection creates an approval request when its tool limit stops a call. An MCP proxy creates a request when an organization rule requires assent for a tool that the Writ already grants. An approval cannot widen a Writ grant.

Writ does not execute the stored call. The agent must retry after approval.

An organization policy can also require approval for selected tools.

Terminal window
writ approvals

The command shows the writ, tool name, argument digest, and arguments for each pending request.

For a native hook, these arguments can be the exact provider arguments. An explicit approval request can store them after redaction. Normal tool-call entries store a digest instead of the exact provider arguments.

Terminal window
writ approve <request-id>

The default scope is once. It permits one retry with the same tool name and argument digest. Any changed argument needs another approval.

The command shows the request and asks for confirmation in an interactive terminal. Add a reason when it helps a reviewer:

Terminal window
writ approve <request-id> --reason "This release needs the generated file."
Terminal window
writ approve <request-id> --scope run

This scope permits matching calls in the same run or connected agent session. It expires when that run ends.

Terminal window
writ deny <request-id> --reason "This path is outside the task."

A denial applies to that exact call for the rest of the run. It does not edit the project or organization policy.

Terminal window
writ review <name> --where text~approval

The record contains the request, human decision, use, or expiry.

The approval command identifies the operator by the current operating-system account. Use process or account isolation when another process under that account must not reach the approval store.