name	context-firewall
description	Use when running noisy terminal commands (tests, builds, wide searches, diffs, large logs) that might flood the agent context window with useless lines.

Context Firewall

Natively route noisy terminal output through cfw run to save context and keep raw evidence on disk.

The pi-context-firewall extension intercepts standard bash command executions on-the-fly and automatically wraps noisy ones in cfw run if the binary is on PATH.

Verification

If you see a span handle in previous command output, such as cfw://span/<id>:

DO NOT rerun the command to inspect the output.
Retrieve the exact lines you need using:

cfw show <id> --lines 120:180

Search for specific strings inside the stored raw output:

cfw show <id> --grep "panic" --around 3

Inspect overall token savings and session adoption:

cfw receipt --json

name	context-firewall
description	Use when running noisy terminal commands (tests, builds, wide searches, diffs, large logs) that might flood the agent context window with useless lines.

Context Firewall

Natively route noisy terminal output through cfw run to save context and keep raw evidence on disk.

The pi-context-firewall extension intercepts standard bash command executions on-the-fly and automatically wraps noisy ones in cfw run if the binary is on PATH.

Verification

If you see a span handle in previous command output, such as cfw://span/<id>:

DO NOT rerun the command to inspect the output.
Retrieve the exact lines you need using:

cfw show <id> --lines 120:180

Search for specific strings inside the stored raw output:

cfw show <id> --grep "panic" --around 3

Inspect overall token savings and session adoption:

cfw receipt --json