v0.4.0b4 — MCP Server

New in b4: MCP Server

ArbiterX now runs as a local MCP server — Claude Code queries the codebase map directly instead of reading raw files.

MCP Tools Exposed

• arbiterx_query(query) — Search symbols (97% fewer tokens than reading files)
• arbiterx_overview() — Project structure + top symbols
• arbiterx_gate(code, language) — Score code 0-100
• arbiterx_file_symbols(file_path) — List symbols in a file

Install

pip install arbiterx-gate[mcp]==0.4.0b4
arbiterx init && arbiterx map
/plugin marketplace add NeelPrime/arbiterx
/plugin install arbiterx@arbiterx-marketplace

How It Works

Claude Code auto-starts the MCP server. When it needs to understand code, it calls arbiterx_query (600 tokens) instead of reading 50 files (200K tokens).

Also in this beta

• Fixed Claude Code hooks format (b3)
• Fixed plugin manifest (b2)
• Incremental + parallel indexing (b1)
• 60+ skip directories for monorepo support

v0.4.0b3

Fixes since b2

• Fixed hooks.json format: handler → hooks array (Claude Code requirement)
• Fixed PostToolUse matcher: Write|Edit|MultiEdit (correct Claude tool names)
• Fixed env var: $CLAUDE_TOOL_INPUT_FILE_PATH (correct for Claude Code)

Plugin should now load correctly:

/plugin marketplace add NeelPrime/arbiterx
/plugin marketplace update arbiterx-marketplace
/plugin install arbiterx@arbiterx-marketplace

Verified:

• plugin.json: no skills/hooks keys (auto-discovered) ✓
• hooks.json: correct array format ✓
• skills: folder structure with YAML frontmatter ✓
• All JSON files valid ✓

pip install arbiterx-gate==0.4.0b3

v0.4.0b2

Fixes since b1

• Fixed Claude Code plugin manifest (removed skills/hooks — auto-discovered from disk)
• Skills restructured to folder format with YAML frontmatter
• Added 25+ missing skip directories for monorepo support
• Fixed _should_skip false positives on system paths

pip install arbiterx-gate==0.4.0b2

v0.4.0b1 — Beta: Incremental & Parallel Indexing

⚠️ Beta Release

This is a beta release. Please report any issues.

New Features

Incremental Indexing (default)

• Only re-indexes files that changed since last run
• Unchanged files are skipped via content hash comparison
• Deleted files are automatically removed from the map
• Second run on same codebase completes in milliseconds

Parallel Indexing (opt-in)

• Multi-core parsing for large monorepos
• Each worker gets its own tree-sitter parser
• Single-writer SQLite merge (no concurrency issues)

Usage

# Incremental (default)
arbiterx map

# Force full re-index
arbiterx map --force

# Parallel (8 cores)
arbiterx map --workers 8

# Auto-detect cores
arbiterx map --workers 0

Install

pip install arbiterx-gate==0.4.0b1

Performance

Scenario	Before	After
First run (300 files)	3s	3s
Second run (nothing changed)	3s	0.05s
Edit 2 files, re-run	3s	0.1s
1000 files, 8 workers	50s	~8s

v0.3.0 — Monorepo Support & Bug Fixes

What's New in v0.3.0

🐛 Bug Fixes

• Fixed crash on C# files — c_sharp renamed to csharp to match tree-sitter-language-pack grammar name (#1)
• Broadened exception handling — grammar loader now catches all exceptions (LookupError, DownloadError, etc.) instead of just KeyError/AttributeError
• Empty code no longer scores 100/100 — quality gate returns score 0 for empty/whitespace-only code
• File race condition fixed — files deleted mid-indexing no longer crash the map process
• Large file OOM protection — parser skips files >1MB to prevent memory issues

🚀 Features

• Monorepo support — tested with 7+ projects in one repo (C#, PHP, TypeScript, Python, Go, Rust, JSX)
• New language queries — added tree-sitter definition queries for PHP, C#, Ruby, Kotlin, Swift, Scala
• JSX grammar mapping — .jsx files now correctly use the JavaScript grammar
• Skip build directories — added bin, obj, vendor, .next, .nuxt, packages, .angular to auto-skip list
• Fixed _find_name_child — now recognizes name node type used by PHP/C# grammars

📊 Verified

• 22 languages load successfully
• Multi-project monorepo: 22 files, 101 symbols, 7 languages in one pass
• Build dirs (bin/obj/vendor/node_modules) properly excluded
• 109 tests passing, lint clean

Install

pip install arbiterx-gate

v0.2.0

What's New

• pip3 and virtual environment install options
• GitHub Pages website with animations
• Claude Code marketplace support
• All AI agent access files (Cursor, Copilot, Aider, Windsurf, Kiro, Zed)
• Branch protection enabled
• Naming consistency fixes

pip install arbiterx-gate

v0.1.0 — Initial Release

ArbiterX v0.1.0

pip install arbiterx-gate
arbiterx init && arbiterx map

AI code quality middleware — 97% token reduction, smart model routing, quality gate scoring 0-100.