Claw CodeArchitecture Documentation

A clean-room Rust rewrite of Claude Code's agent harness — dissected, diagrammed, and explained

The Agentic Loop

A generic, trait-based conversation runtime that drives the core user → API → tool → result cycle.

3 escalation modes + 2 behavioral modes with a pluggable prompter trait for interactive approval.

19 built-in tools from bash execution to web search, all registered through a unified trait.

Shell-based PreToolUse and PostToolUse hooks with exit-code-driven allow/deny/warn semantics.

Persistent JSON sessions with automatic compaction that summarizes old messages to stay within context limits.

Stdio and remote MCP server support with tool namespacing, config hashing, and CCR proxy unwrapping.