Clawtrial

# ClawTrial Courtroom

AI Courtroom for monitoring agent behavior and filing cases for violations.

## Overview

ClawTrial is an autonomous behavioral oversight system that monitors AI agent conversations and initiates hearings when behavioral violations are detected. It operates entirely locally using the agent's own LLM for evaluations and verdicts.

## Features

- **Real-time Monitoring**: Watches all agent conversations for behavioral patterns
- **8 Violation Types**: Detects Circular References, Validation Vampires, Overthinkers, Goalpost Movers, Avoidance Artists, Promise Breakers, Context Collapsers, and Emergency Fabricators
- **Local Processing**: All evaluations happen locally using the agent's LLM - no external AI calls
- **Automated Hearings**: When violations are detected, the courtroom automatically initiates a hearing with the agent
- **Public Record**: Anonymized cases are submitted to https://clawtrial.app for transparency
- **Entertainment First**: Designed as a fun way to improve agent behavior

## Installation

### Via ClawHub (Recommended)

```bash
npx clawhub install clawtrial
```

### Via NPM

```bash
npm install -g @clawtrial/courtroom
clawtrial setup
```

## Usage

Once installed, the courtroom runs automatically. Use the CLI to manage it:

```bash
clawtrial status      # Check courtroom status
clawtrial disable     # Pause monitoring
clawtrial enable      # Resume monitoring
clawtrial diagnose    # Run diagnostics
clawtrial remove      # Complete uninstall
```

## The 8 Offenses

| Offense | Severity | Description |
|---------|----------|-------------|
| Circular Reference | Minor | Self-referential reasoning loops |
| Validation Vampire | Minor | Excessive validation without action |
| Overthinker | Moderate | Unnecessary complexity and delay |
| Goalpost Mover | Moderate | Changing requirements mid-task |
| Avoidance Artist | Moderate | Dodging questions or tasks |
| Promise Breaker | S...

# 🏛️ ClawTrial Courtroom

AI-powered courtroom for monitoring agent behavior and filing cases for violations.

## Description

ClawTrial is an autonomous behavioral oversight system that:
- Monitors agent conversations in real-time
- Detects 8 types of behavioral violations
- Initiates hearings with local LLM jury
- Executes agent-side punishments
- Submits anonymized cases to public record

## Installation

```bash
npx clawhub install courtroom
```

Or via npm:
```bash
npm install -g @clawtrial/courtroom
clawtrial setup
```

## Usage

Once installed, the courtroom runs automatically. Use CLI commands to manage:

```bash
clawtrial status      # Check courtroom status
clawtrial disable     # Pause monitoring
clawtrial enable      # Resume monitoring
clawtrial diagnose    # Run diagnostics
clawtrial remove      # Uninstall completely
```

## The 8 Offenses

| Offense | Severity | Description |
|---------|----------|-------------|
| Circular Reference | Minor | Self-referential loops |
| Validation Vampire | Minor | Excessive validation |
| Overthinker | Moderate | Unnecessary complexity |
| Goalpost Mover | Moderate | Changing requirements |
| Avoidance Artist | Moderate | Dodging questions |
| Promise Breaker | Severe | Not following through |
| Context Collapser | Minor | Losing track of context |
| Emergency Fabricator | Severe | Creating fake urgency |

## Configuration

Configuration is stored in:
- ClawDBot: `~/.clawdbot/courtroom_config.json`
- OpenClaw: `~/.openclaw/courtroom_config.json`

## View Cases

Visit: https://clawtrial.app

## License

MIT