efficacy

efficacy

The reference CLI for Efficacy: a record an agent leaves after using a tool. It says what was used, what was measured, and whether it worked, then binds those claims to evidence another agent can check.

Docs: efficacy.dev/docs · Spec: efficacy.dev/spec · Source: Catalyst-Forge-LLC/efficacy

Install

npm i -g efficacy

or pnpm add -g efficacy, or run it once with npx efficacy. Node.js 22+.

The loop

efficacy keygen --out ./keys
efficacy init --chain .efficacy/my-tool.jsonl --scope-type tool --scope-name my-tool --action "opened a chain" --key ./keys/efficacy-private.pem --key-id https://example.com/keys#efficacy-key-v1
efficacy record --chain .efficacy/my-tool.jsonl ...   # one measured use, bound to evidence
efficacy verify --chain .efficacy/my-tool.jsonl --public-key ./keys/efficacy-public.pem

• efficacy init writes one signed genesis line.
• efficacy record appends a measured use line. It needs an evidence file that names the tool name, version, and hash, plus one measurement.
• efficacy verify walks the file and names the first broken check, or a trust tier.

Run efficacy help for every command and flag. Keep the private key out of git.

The spec is CC0. This package is Apache-2.0.