claw-agent/README.md

Claw Agent

Agent harness built using architectural patterns from Claw Code.

Components

• permissions.py - Fine-grained tool access control
• execution_registry.py - Command/tool routing registry
• session_store.py - JSON-based session persistence

Usage

from claw_agent import ToolPermissionContext, ExecutionRegistry, SessionStore

# Create permission context
ctx = ToolPermissionContext(
    deny_tools={"bash"},
    deny_prefixes={"dangerous_"}
)

# Build registry
registry = build_default_registry()

# Create session
store = SessionStore()
session = RuntimeSession.create(prompt="Hello")
session.history.add("user", "Hello")
store.save(session)

Architecture

This agent replaces idle Allegro-Primus with real work capabilities.

See EPIC-202: http://143.198.27.163:3000/Timmy_Foundation/timmy-home/issues/191