tetrad 0.1.15

Quadruple Consensus MCP Server for Claude Code - Validates code using Codex, Gemini and Qwen
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137

# Tetrad

[![npm](https://img.shields.io/npm/v/@samoradc/tetrad.svg)](https://www.npmjs.com/package/@samoradc/tetrad)
[![CI](https://github.com/SamoraDC/Tetrad/actions/workflows/ci.yml/badge.svg)](https://github.com/SamoraDC/Tetrad/actions/workflows/ci.yml)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)

> Quadruple Consensus MCP Server for Claude Code

**Tetrad** is a high-performance MCP (Model Context Protocol) server that orchestrates three AI-powered CLI tools (Codex, Gemini CLI, Qwen) to validate all code produced by Claude Code.

## Quick Start

### 1. Initialize in your project

```bash
npx @samoradc/tetrad init
```

This will:
- Create `tetrad.toml` configuration file
- Create `.tetrad/` directory for the database
- Add `.tetrad/` to your `.gitignore`

### 2. Add to Claude Code

```bash
# Add as MCP server (available in all projects)
claude mcp add --scope user tetrad -- npx @samoradc/tetrad serve

# Or for current project only
claude mcp add tetrad -- npx @samoradc/tetrad serve
```

### 3. Verify

```bash
# Check version
npx @samoradc/tetrad version

# Check CLI availability
npx @samoradc/tetrad status

# Diagnose issues
npx @samoradc/tetrad doctor
```

## Commands

```bash
npx @samoradc/tetrad init              # Initialize config in current directory
npx @samoradc/tetrad serve             # Start MCP server (used by Claude Code)
npx @samoradc/tetrad status            # Show CLI status (codex, gemini, qwen)
npx @samoradc/tetrad config            # Interactive configuration
npx @samoradc/tetrad doctor            # Diagnose configuration issues
npx @samoradc/tetrad version           # Show version
npx @samoradc/tetrad evaluate -c CODE  # Manual code evaluation (without MCP)
npx @samoradc/tetrad history           # Show evaluation history from ReasoningBank
```

## Manual MCP Configuration

Add to your `.mcp.json`:

```json
{
  "mcpServers": {
    "tetrad": {
      "type": "stdio",
      "command": "npx",
      "args": ["@samoradc/tetrad", "serve"]
    }
  }
}
```

## Requirements

Tetrad requires at least one of these AI CLI tools:

- **Codex CLI** (OpenAI): `npm install -g @openai/codex`
- **Gemini CLI** (Google): `npm install -g @google/gemini-cli`
- **Qwen CLI** (Alibaba): `pip install dashscope`

## Features

- **Quadruple Consensus**: 4 AI models must agree to approve code
- **ReasoningBank**: Continuous learning system with SQLite
- **High Performance**: Written in Rust
- **LRU Cache**: Result caching with configurable TTL
- **Hook System**: Pre/post evaluation callbacks
- **Auto .gitignore**: Automatically ignores local data

## Configuration

After `npx @samoradc/tetrad init`, edit `tetrad.toml`:

```toml
[general]
log_level = "info"
timeout_secs = 60

[executors.codex]
enabled = true
command = "codex"
args = ["exec", "--json"]

[executors.gemini]
enabled = true
command = "gemini"
args = ["-o", "json"]

[executors.qwen]
enabled = true
command = "qwen"

[consensus]
default_rule = "strong"  # golden, strong, weak
min_score = 70
max_loops = 3

[reasoning]
enabled = true
db_path = ".tetrad/tetrad.db"

[cache]
enabled = true
capacity = 1000
ttl_secs = 300
```

## Documentation

Full documentation: [GitHub Repository](https://github.com/SamoraDC/Tetrad)

## License

MIT