CodexA

Appearance

CodexADeveloper Intelligence Engine

Semantic code search, AI-assisted understanding, and workspace tooling for developers and AI agents.

Get Started
View on GitHub

Semantic Search

Natural-language code search powered by sentence-transformers and FAISS. Find code by meaning, not just keywords — queries are embedded into vectors and matched against your entire codebase.

AI Agent Protocol

8 structured tools invocable via CLI, HTTP bridge, MCP, or Python API. Designed for autonomous AI coding agents with structured JSON input/output.

Multi-Language Parsing

Tree-sitter AST parsing for 12 languages — Python, TypeScript, Rust, Go, Java, C/C++, and more. Extracts symbols, call graphs, and dependency maps.

Quality & Metrics

Cyclomatic complexity via Radon, security scanning via Bandit, hotspot detection combining churn and complexity, blast-radius impact analysis, and CI quality gates.

Plugin System

22 hook points across the full pipeline — indexing, search, analysis, AI, and output. Build custom plugins with a simple Python API and automatic discovery.

Self-Improving Loop

Budget-aware evolution engine that autonomously discovers issues, generates patches, validates with tests, and commits improvements to your codebase.

36 CLI Commands

Comprehensive Click-based CLI with --json, --pipe, and --verbose flags. Every command returns structured output suitable for scripting and automation.

Multiple Interfaces

CLI, Web UI, REST API, Bridge Server, MCP Server, LSP Server, and interactive TUI — all built on the same tool protocol for consistent behavior everywhere.

Quick Start ​

bash
# Install
pip install -e "."

# Initialize & index your project
cd /path/to/your-project
codex init
codex index .
codex doctor

# Search your code
codex search "authentication middleware"

# AI-powered analysis
codex ask "How does the auth flow work?"
codex quality src/
codex hotspots

At a Glance ​

MetricValue
Version0.28.0
CLI Commands36
AI Agent Tools8 (+ plugin-registered)
Plugin Hooks22
Packages26
Parsed Languages12
Tests2595+

Next Steps ​

Released under the MIT License.

Copyright © 2025 M9nx