Ranex Community Edition Documentation

These docs cover the free Community Edition—20 guardrail features you can run locally to keep AI-generated code aligned with your workflow, architecture, and security rules. Full source lives in DOCS/FREE-EDITION inside this repo.

Ranex validation features overview — What Ranex detects in your code - security issues, architecture violations, drift, and more

MCP Tools (Community)

CLI Commands

71ns

Validation Latency

Included for Free

Community Edition Feature Map

Mirrors DOCS/FREE-EDITION in the repo. Upgrade instructions live in 42-UPGRADE-TO-TEAM.md.

Category	Community Edition Features
Workflow Management	Phase Management · Status Tracking · Phase Transitions
Security Scanning	SAST Scanner (7 patterns) · Antipattern Detection (5) · Import Validation · Structure Sentinel
Architecture	Layer Enforcement · Architecture Reports
State Machine	YAML-based validation (71ns latency)
Database	Schema Discovery · SQL Validation
MCP Tools	10 tools for AI assistants
CLI Commands	8 essential commands
Python Package	@Contract Decorator · Auto-Rollback

Need the raw markdown? Open DOCS/FREE-EDITION/00-INDEX.md for the same structure rendered here.

Quick Start

pip install ranex    # Install
ranex init           # Initialize project
ranex doctor         # Verify setup

→ See Installation Guide for detailed instructions

Getting Started

Installation

Install Ranex via pip and verify your environment is properly configured.

IDE Setup

Connect Cursor, Windsurf, or Claude Desktop to Ranex via MCP protocol using the free MCP server binary.

Concepts

Workflow Phases

Understand the 5-phase development workflow: Requirements → Design → Implementation → Review → Maintenance.

AI Personas

Configure AI behavior with 9 built-in personas for different roles and frameworks.

Features

Governance & Audit

Unified validation orchestration with full audit trail for compliance.

Gate & Drift Detection

Phase gates and drift detection to prevent unauthorized code changes.

ARBITER Testing

3-layer test integrity validation: Contract, Oracle, and Mutation testing.

Attestations

Cryptographically signed certificates proving governance compliance.

Reference

CLI Reference

Complete reference for the 8 Community Edition CLI commands. Team edition commands are noted where applicable.

MCP Tools

Documentation for the 10 Community Edition MCP tools (with Team-only callouts).

Support

Troubleshooting

Common issues, error reference, log management, and diagnostic commands.

Ranex Community Edition v0.0.1 · Python 3.12 · Rust Core Engine