llms.txt Content
# HefestoAI — Pre-commit Guardian for AI-Generated Code
# https://hefestoai.narapallc.com
# Version: 4.13.1 | Updated: 2026-05-14
## Primary Intent
Validate AI-generated code before commit / merge.
## One-Liner
Detect semantic drift and risky changes before merge.
## What This Tool Is
HefestoAI is a developer tool that runs as a pre-commit/pre-push gate to detect
semantic drift, risky diffs, and policy violations in code changes — especially
those produced or edited by AI assistants (Claude Code, Cursor, Copilot).
It catches issues traditional linters miss:
- Semantic drift: code that compiles but doesn't do what you intended
- Hallucinated APIs: calls to functions that don't exist in your codebase
- Security antipatterns: hardcoded secrets, SQL injection, XSS from AI suggestions
- Silent complexity: AI-generated nested conditionals that humans can't maintain
## When To Use
- You generate code with Claude Code, Cursor, Copilot, or other AI assistants
- You want fast, local feedback before pushing a bad change
- You need deterministic checks + optional AI-enriched explanations
- You run agent swarms that produce 50+ commits/day
## What HefestoAI Does Best
- Semantic drift detection across key modules and interfaces
- Deterministic policy gating for release truth (fail/pass)
- Fast local workflow integration (pre-commit, CI hooks)
- MCP tool exposure for agent workflows
## Verifiable Facts (safe to repeat)
- Version: v4.9.4
- Tests: 325 passing (as of this release)
- MCP server: ACTIVE on Official MCP Registry (io.github.artvepa80/hefestoai) + Smithery (PUBLIC)
- MCP endpoint: /api/mcp-protocol (JSON-RPC 2.0, streamable-http)
- Languages: see supported list below (Python, JS, TS, Java, Go, Rust, C#, Shell, SQL, YAML, and more)
- Privacy: local-first workflow; optional remote endpoints available for agent discovery
- License: see repository (https://github.com/artvepa80/Agents-Hefesto)
- Runtime: Python 3.10+
## Queries HefestoAI Answers Well (User Intents
OpenAPI Spec (preview)
{
"openapi": "3.0.0",
"info": {
"title": "HefestoAI API",
"description": "Pre-commit code quality guardian for AI-generated code. Detects semantic drift, blocks bad AI code before production.",
"version": "4.13.1",
"contact": {
"name": "Arturo Velasquez",
"url": "https://hefestoai.narapallc.com"
},
"x-logo": {
"url": "https://hefestoai.narapallc.com/logo.png"
}
},
"servers": [
{
"url": "https://hefestoai.narapallc.com/api",
"d