Skip to main content

AgentAssert Type-C Claude Code hook adapter — enforce behavioral contracts directly in Claude Code CLI.

Project description

agentassert-typec-claude-code

Claude Code hook adapter — contract enforcement directly in Claude Code.

Install

pip install agentassert-typec-claude-code
agentassert-claude-code install --contract partner-mode.yaml
export AGENTASSERT_CONTRACT=$(pwd)/partner-mode.yaml

What Happens

  1. A 00-agentassert-typec.py hook is placed in ~/.claude-hooks/
  2. Every tool call in Claude Code is intercepted
  3. Contract is evaluated in-process (sub-10ms)
  4. On DENY: block with reason; on ALLOW: forward

Available Contracts

# Minimal: just block destructive tools
agentassert-claude-code install --contract $(pip show agentassert-typec-claude-code | grep Location | cut -d' ' -f2)/contracts/templates/safety-minimal.yaml

# Partner mode: challenge-first, cost-before-paid, drift detection
agentassert-claude-code install --contract $(pip show agentassert-typec-claude-code | grep Location | cut -d' ' -f2)/contracts/templates/partner-mode.yaml

# Full governance: all 7 operators
agentassert-claude-code install --contract $(pip show agentassert-typec-claude-code | grep Location | cut -d' ' -f2)/contracts/templates/full-governance.yaml

The Partner Mode Story

Varun's ~/.claude/CLAUDE.md + ~/.claude/rules/*.md contained ~14,000 tokens of process rules. After migrating to partner-mode.yaml:

  • 47.8% token reduction per turn (49,636 → ~25,920 bytes)
  • process rules: 31,322 bytes → 1,203 bytes (96% compression of rules)
  • Replaced: challenge-first, cost-before-paid-API, tool blocklist, destructive-command firewall, context budget
  • Preserved: style/voice rules (cannot formalize), capability routing, reference docs

See case_study/measurements.md for the full analysis.

Status

agentassert-claude-code status

Uninstall

agentassert-claude-code uninstall

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agentassert_typec_claude_code-0.4.2.tar.gz (6.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agentassert_typec_claude_code-0.4.2-py3-none-any.whl (9.2 kB view details)

Uploaded Python 3

File details

Details for the file agentassert_typec_claude_code-0.4.2.tar.gz.

File metadata

File hashes

Hashes for agentassert_typec_claude_code-0.4.2.tar.gz
Algorithm Hash digest
SHA256 ea3d15af4b6398e87ee9b681cb4811ff78aa08a747f3db133c1e9433aa5f3283
MD5 251dc505101d5615d1ee8566df724f14
BLAKE2b-256 2496b8a01b36b033c2c9675f43f589b900fbf248c8e0895b1a9a5427e988f5cb

See more details on using hashes here.

File details

Details for the file agentassert_typec_claude_code-0.4.2-py3-none-any.whl.

File metadata

File hashes

Hashes for agentassert_typec_claude_code-0.4.2-py3-none-any.whl
Algorithm Hash digest
SHA256 0797291a85a9961c24dbe855cc315927a788b2a66630a55e178a3c8343622189
MD5 b79fb90ca76780750d4c599d454e1088
BLAKE2b-256 f19a423b0c3e1eed8d4c3ada116be12961c9d8da7cae3049d22ad5323594b5fc

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page