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.6.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.6.2-py3-none-any.whl (9.3 kB view details)

Uploaded Python 3

File details

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

File metadata

File hashes

Hashes for agentassert_typec_claude_code-0.6.2.tar.gz
Algorithm Hash digest
SHA256 dd8f0a195456042aa9ad108a488d360191d350e587c854b146931a65f1b58886
MD5 c5fdb0370183a4330c3e6542f5149f7f
BLAKE2b-256 a1398658866dc1fda829d6c60caf42449729a4a5b24eacd1a0505d057ce55491

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for agentassert_typec_claude_code-0.6.2-py3-none-any.whl
Algorithm Hash digest
SHA256 9937c3a8afcf8cee9d5ae407f5d82934b8ca9273b3afb644a91f2adf2eb46e8d
MD5 18687a2869d4516b276a91a61dc7ed86
BLAKE2b-256 4ac5357a6b93dbf86519f41b307bc0006db1f859de740814de07b1573da22139

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