Empirical Docs / CLI Reference

Policy commands.

Inspect and control how native Empirical skills behave when an agent decides whether to use memory, write context, or capture work history.

What policy controls

Policy is the local, inspectable boundary around discretionary agent behavior. It is useful when you want an agent to query memory but not write automatically, or when a team needs a predictable default across machines.

Inspect or change policy

Inspect before changing. Set only the fields you intend to change, and keep stricter settings in CI or sensitive projects.

empirical policy show
empirical policy show --refresh
empirical policy set --json '{"allowDiscretionaryUse":false}'

Verify policy

Run policy show again after a change, then test one read and one write in a safe workspace. Policy changes should be intentional and reviewable; they do not replace OAuth authorization or workspace permissions.

Last updated: July 31, 2026