instructkr/claw-code

The fastest repo in history to surpass 50K stars ⭐, reaching the milestone in just 2 hours after publication. Better Harness Tools that make real things done. Now writing in Rust using oh-my-codex.

Structural Verdict

How Data Flows Through the System

User prompts flow through CLI to runtime, which orchestrates Claude API calls and tool executions in a conversational loop with session persistence

1. Input Processing — CLI parses user input, slash commands, and session restoration requests
2. Conversation Setup — Runtime initializes session state, loads configuration, and prepares system prompts
3. API Communication — AnthropicClient streams requests to Claude API with authentication and retry logic
4. Tool Execution — Runtime executes tool calls in sandboxed environments with permission checks
5. Response Processing — SSE parser converts streaming responses to structured events for real-time display
6. Session Management — Conversations are persisted and compacted when approaching context limits

System Behavior

How the system actually operates at runtime — where data accumulates, what loops, what waits, and what controls what.

Data Pools

Feedback Loops

• API Retry Logic (retry, balancing) — Trigger: HTTP errors or rate limits. Action: Exponential backoff and request retry. Exit: Success or max retries exceeded.
• Session Compaction (auto-scale, balancing) — Trigger: Token count exceeds threshold. Action: Summarize old messages to preserve context. Exit: Under token limit.
• Permission Prompting (circuit-breaker, balancing) — Trigger: Tool requests dangerous operations. Action: Halt execution and prompt user. Exit: User grants or denies permission.

Delays & Async Processing

• API Rate Limiting (rate-limit, ~200ms to 2s exponential backoff) — Prevents API throttling but delays responses
• Tool Execution Timeout (async-processing, ~Configurable per command) — Prevents hung processes but may interrupt long operations
• OAuth Token Refresh (eventual-consistency) — Brief authentication delay when tokens expire

Control Points

• Permission Mode (env-var) — Controls: Tool execution security level
• Auto Compaction Threshold (env-var) — Controls: When to compress conversation history. Default: 200,000 tokens
• Sandbox Configuration (feature-flag) — Controls: Process isolation and security boundaries
• MCP Server Timeout (threshold) — Controls: External tool communication limits

Technology Stack

Key Components

• ConversationRuntime (service) — Orchestrates multi-turn conversations between users and Claude with tool execution and session management rust/crates/runtime/src/conversation.rs
• AnthropicClient (service) — Handles HTTP communication with Anthropic's Claude API including streaming responses and authentication rust/crates/api/src/client.rs
• Session (model) — Maintains conversation state including message history and content blocks for persistence rust/crates/runtime/src/session.rs
• execute_bash (function) — Executes bash commands in sandboxed environments with timeout and isolation controls rust/crates/runtime/src/bash.rs
• SseParser (service) — Parses Server-Sent Events from Claude API streaming responses into structured events rust/crates/api/src/sse.rs
• compact_session (function) — Summarizes and compresses conversation history when context limits are approached rust/crates/runtime/src/compact.rs
• CommandRegistry (service) — Manages available slash commands and their execution routing rust/crates/commands/src/lib.rs
• McpServerManager (service) — Manages Model Context Protocol servers for external tool integration via stdio communication rust/crates/runtime/src/mcp_stdio.rs
• RuntimeConfig (config) — Loads and merges configuration from multiple sources for runtime behavior control rust/crates/runtime/src/config.rs
• PermissionPolicy (service) — Enforces security boundaries for tool execution and file system access rust/crates/runtime/src/permissions.rs

Configuration

src/commands.py (python-dataclass)

• name (str, unknown)
• source_hint (str, unknown)
• prompt (str, unknown)
• handled (bool, unknown)
• message (str, unknown)

src/context.py (python-dataclass)

• source_root (Path, unknown)
• tests_root (Path, unknown)
• assets_root (Path, unknown)
• archive_root (Path, unknown)
• python_file_count (int, unknown)
• test_file_count (int, unknown)
• asset_file_count (int, unknown)
• archive_available (bool, unknown)

src/cost_tracker.py (python-dataclass)

• total_units (int, unknown) — default: 0
• events (list[str], unknown) — default: field(default_factory=list)

src/deferred_init.py (python-dataclass)

• trusted (bool, unknown)
• plugin_init (bool, unknown)
• skill_init (bool, unknown)
• mcp_prefetch (bool, unknown)
• session_hooks (bool, unknown)

Related Cli Tool Repositories

Frequently Asked Questions

Analyzed on April 1, 2026 by CodeSea. Written by Karolina Sarna.