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

Uploaded Python 3

File details

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

File metadata

File hashes

Hashes for agentassert_typec_claude_code-0.5.0.tar.gz
Algorithm Hash digest
SHA256 bbc04f366037d654900a95b13e6253dd42922b04ac970caa585ad2596829bc73
MD5 330e45edd2f7774606b36926054dbe66
BLAKE2b-256 63d31f77bdec433610efbc63673ece6f85bbf03761bc8e06c82c0e26e391666f

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for agentassert_typec_claude_code-0.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b049393d8e48edb4a6f1d4ff84de768dc5428fb50f889591cb8d8cc4bbdb2745
MD5 d14a070f4d24454b981cc904e414c73b
BLAKE2b-256 25318e46f04fcca8174b34ad6acc114b8552aaa6aaf0c59a172f7c529f9b3daa

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