Tokenectomy Razor

Tokenectomy Razor

Arregla los Límites de Tasa de Claude Code y Cursor: Puerta de Enlace Local de IA de Cero Latencia y Servidor MCP de Cirugía de Contexto en Rust

Deja de quemar 20,000 tokens en rastros de pila de node_modules. Tokenectomy Razor es una puerta de enlace inversa local de IA de submilisegundo (127.0.0.1:8080) y un servidor MCP complementario escrito en Rust seguro. Elimina del 41.7% al 99.7% del ruido de frameworks de los registros de errores de terminal, redacta credenciales de BD/JWT filtradas y almacena en caché los prompts de forma gratuita.

Inicio Rápido (10s) • Arquitectura • El Problema • Antes y Después • Demo Interactiva en Vivo • Benchmarks

                                 ┌────────────────────────────────────────────────────────┐
                                 │                   Autonomous Agents                    │
                                 │  Claude Code • Cursor • Antigravity • Cline • Windsurf │
                                 └───────────────────────────┬────────────────────────────┘
                                                             │
                                                             ▼ (HTTP / SSE Outbound Prompts)
   ┌──────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
   │                                 ⚡ TOKENECTOMY AI GATEWAY (127.0.0.1:8080)                                       │
   │                                                                                                                  │
   │  ┌─────────────────────────┐   ┌───────────────────────────┐   ┌──────────────────────────────────────────────┐  │
   │  │   Zero-Cost Prompt      │   │   Zero-Leak Credential    │   │         Polyglot Trace Surgery               │  │
   │  │         Cache           │   │         Redaction         │   │            (9 Languages)                     │  │
   │  │  <1ms Hit • 100% Free   │   │  API Keys • JWTs • DB URIs│   │  node_modules • site-packages • .cargo       │  │
   │  └───────────┬─────────────┘   └─────────────┬─────────────┘   └──────────────────────┬───────────────────────┘  │
   │              │                               │                                        │                          │
   │              └───────────────────────────────┼────────────────────────────────────────┘                          │
   │                                              ▼                                                                   │
   │                                 Smart Upstream Auto-Router                                                       │
   │                         (Anthropic • OpenAI • Groq • Ollama Local)                                               │
   └──────────────────────────────────────────────┬───────────────────────────────────────────────────────────────────┘
                                                  │
                 ┌────────────────────────────────┼────────────────────────────────┐
                 ▼                                ▼                                ▼
       api.anthropic.com                  api.openai.com                   localhost:11434
    (Claude 3.5 / 3.7 Sonnet)         (GPT-4o / o1 / o3-mini)              (DeepSeek / Llama)

⚡ Inicio Rápido (10s)

0. Envoltorio de Una Línea sin Configuración (wrap)

Ejecuta cualquier agente de codificación o suite de pruebas directamente detrás de la puerta de enlace de privacidad y caché de Tokenectomy sin configuración manual de variables de entorno:

# Wrap Claude Code CLI
razor wrap -- claude

# Wrap Aider with DeepSeek or Ollama (Auto-Transpiled on the fly!)
razor wrap -- aider --model deepseek/deepseek-chat

# Wrap test runs to scrub logs and prevent accidental credential leakage
razor wrap npm test

1. Lanza la Puerta de Enlace de IA Independiente (Modo Manual)

npx -y tokenectomy-razor --proxy

💡 ¡Enrutamiento Automático Multi-Proveedor Inteligente y Transpilador Universal de LLM activados por defecto! Tokenectomy analiza automáticamente las rutas de solicitud y los encabezados. ¿Necesitas ejecutar Claude Code contra DeepSeek u Ollama? Tokenectomy transpila de forma transparente el formato Anthropic /v1/messages al formato OpenAI /v1/chat/completions sobre la marcha y viceversa.

2. Conecta Tu Agente Favorito

Apunta tu agente de codificación o CLI a la puerta de enlace local en 127.0.0.1:8080:

3. Panel de FinOps y Seguridad en Tiempo Real

Abre http://127.0.0.1:8080/dashboard en tu navegador para observar reducciones de tokens en vivo, aciertos de caché de prompts, ahorros en dólares y credenciales redactadas en tiempo real.

4. Configuración del Servidor MCP Complementario (Sub-Cortex)

Para agentes que llaman a herramientas de diagnóstico profundas (get_error_context, analyze_code, apply_code_patch):

CLI de Claude Code

claude mcp add tokenectomy npx -y tokenectomy-razor --mcp

CLI de Google Antigravity / Gemini

agy mcp add tokenectomy-razor -- npx -y tokenectomy-razor --mcp

Cursor Composer (.cursor/mcp.json)

{
  "mcpServers": {
    "tokenectomy": {
      "command": "npx",
      "args": ["-y", "tokenectomy-razor", "--mcp"]
    }
  }
}

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "tokenectomy": {
      "command": "npx",
      "args": ["-y", "tokenectomy-razor", "--mcp"]
    }
  }
}

5. Tuberías de Terminal y Limpieza de CLI

npm test 2>&1 | npx tokenectomy-razor

🛑 El Problema: Por Qué Tu IA Alcanza Límites de Tasa y Alucina

Cuando tu aplicación falla durante el desarrollo (Next.js, Express, FastAPI, Tokio), el runtime vuelca cientos de líneas de código de terceros de node_modules o site-packages.

Cuando pegas ese volcado de error crudo en Cursor o Claude:

1. Consume Tu Límite de Tasa de 5 Horas: Un solo error de Express/Prisma puede volcar 5,000 a 45,000 tokens de código de bibliotecas de terceros que nunca escribiste. Unos pocos bucles de fallos queman fácilmente tu límite de sesión.
2. Provoca Alucinaciones en la IA: Claude se pierde en los internals del framework (node_modules/express/lib/router/layer.js o starlette/routing.py) e intenta editar archivos de bibliotecas en lugar de tu código de aplicación real.
3. Filtra Secretos y Credenciales: Cadenas de conexión con contraseñas de BD en texto plano, tokens de portador JWT y claves de nube incrustadas en los rastros de error se reenvían a servidores de modelos externos.

Raw Terminal Crash (45,820 tokens + Leaked Secrets)
     │
     ▼  <0.2ms Local Rust DFA Engine
[Redact Passwords & Keys] ──► [Strip Third-Party Framework Frames] ──► [Isolate Root Cause]
     │
     ▼
Clean Context (118 tokens • Zero Secrets • Sub-millisecond)

🔍 Comparación Antes y Después

❌ Sin Tokenectomy: La IA Alucina y Quema Contexto

TypeError: Cannot read properties of undefined (reading 'token')
    at loadComponents (/app/node_modules/next/dist/server/load-components.js:14:2)
    at renderToHTML (/app/node_modules/next/dist/server/render.js:50:5)
    at nextServer (/app/node_modules/next/dist/server/next-server.js:80:12)
    at processTicksAndRejections (node:internal/process/task_queues:95:5)
    at runMicrotasks (node:internal/process/task_queues:120:3)
    at checkoutHandler (/app/pages/api/checkout.ts:42:15)
Database connection failed: postgresql://admin:super_secret_password@db.prod.internal:5432/primary
API key leaked: sk-ant-api03-abcdef1234567890abcdef1234567890

Lo que hace Claude: Analiza load-components.js y next-server.js, especula sobre los internals de Webpack / Next.js y filtra credenciales de conexión a registros de inferencia remotos.

✅ Con Tokenectomy: Contexto Limpio y Corrección Instantánea

// [Tokenectomy Surgery: 5 internal framework frames pruned (83.3%)]
// Source: /app/pages/api/checkout.ts:42:15
42 |   const sessionToken = req.headers.authorization.token;
   |                                                  ^ TypeError: Cannot read properties of undefined (reading 'token')
🛡️ [CONNECTION_STRING_REDACTED]
🛡️ [ANTHROPIC_KEY_REDACTED]

Lo que hace Claude: Identifica instantáneamente que la línea 42 en checkout.ts intentó acceder a .token en encabezados indefinidos. Sugiere encadenamiento opcional req.headers.authorization?.token inmediatamente. Credenciales redactadas antes de la transmisión.

🔬 Benchmarks Verificables

Todas las afirmaciones de rendimiento están fundamentadas en hardware y son reproducibles de forma independiente en hardware físico (medidas en Intel Core i5-1235U de 10 núcleos @ 15W ejecutando Arch Linux, Kernel 6.13):

Aviso de Dependencia de Hardware: El rendimiento depende del hardware; el rendimiento reportado representa resultados medidos en el hardware de prueba especificado (Intel Core i5-1235U de 10 núcleos @ 15W TDP). El rendimiento escala con CPUs de escritorio/servidor de mayor TDP y buses de memoria más rápidos. Se anima a los desarrolladores a auditar el rendimiento de forma independiente usando el comando de reproducción a continuación.

$ cargo test --release --test stress_benchmark -- --nocapture

=====================================================================================
🧪 TOKENECTOMY OSS VERIFIABLE HEAVY STRESS BENCHMARK (100% REPRODUCIBLE IN OSS)
   Hardware: 10-Core / 12-Thread Intel Core i5-1235U | OS: Arch Linux | Kernel Telemetry Active
   Initial Baseline Process Memory (VmRSS): 3.45 MB
=====================================================================================

🔥 [TEST 1/3] QUARTER-MILLION LINES LOG REDACTION TORTURE (250,000 LINES / 25MB+ BUFFER)
  ├── Buffer Size: 24.44 MB (250000 lines)
  ├── Redaction Latency: 471.05ms (51.9 MB/sec)
  ├── Line Throughput: 530,735 lines/sec
  ├── Peak Memory (VmRSS): 76.05 MB (Delta: +72.60 MB)
  └── Status: ✅ PASSED (100% of 250,000 lines sanitized, zero memory balloon)

🔥 [TEST 2/3] REDOS CATASTROPHIC BACKTRACKING TORTURE (50,000 CHARS PAYLOAD)
  ├── Attack Payload Size: 50,082 characters
  ├── Execution Latency: 1.165 ms
  └── Status: ✅ PASSED (Linear O(N) evaluation, ReDoS-resistant on tested payloads)

🔥 [TEST 3/3] HIGH-CONCURRENCY TORTURE (100 PARALLEL OS THREADS)
  ├── Thread Concurrency: 100 concurrent OS threads
  ├── Successful Operations: 100/100 (100.0%)
  ├── Total Elapsed: 11.31ms
  ├── Concurrency Throughput: 17,688 ops/sec
  ├── Final VmRSS: 78.99 MB
  └── Status: ✅ PASSED (Zero race condition, zero deadlock)

=====================================================================================
🏆 TOKENECTOMY OSS STRESS BENCHMARK: 3/3 PASSED (100% GREEN)
   Total Suite Duration: 580.83ms
   Bounded Final VmRSS: 78.99 MB
=====================================================================================
test test_oss_heavy_stress_benchmark ... ok

test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.58s

🛡️ Benchmark de Redacción Automatizada y Saneamiento de Secretos

Evaluado en un fixture de prueba de benchmark interno (tests/fixtures/) de 12 rastros de fallos políglotas (Rust, Python, TypeScript, Go, YAML) que contienen 22 credenciales de verdad fundamental y controles negativos limpios. Evaluado cara a cara contra Gitleaks v8.30.1 (conjunto de reglas predeterminado).

Nota Arquitectónica: Gitleaks está diseñado principalmente como un escáner de commits/diffs de repositorios, no como un redactor de rastros de runtime en memoria. Tokenectomy Razor está diseñado específicamente para el saneamiento de flujos en runtime y la cirugía de rastros de pila.

1. Precisión, Recall y Puntuación F1 por Categoría

2. Resumen de Rendimiento Cara a Cara y Arquitectónico

3. Reducción de Tokens y Ahorro de Contexto LLM (tiktoken cl100k_base)

🔌 Configuración Avanzada de Agente y Puerta de Enlace

1. Opciones de Puerta de Enlace de IA Multi-Proveedor (--proxy)

La puerta de enlace de Tokenectomy se ejecuta localmente en 127.0.0.1:8080 con cero configuración manual. En entornos de desarrollo complejos o topologías de agentes en contenedores, puedes personalizar el enlace y el enrutamiento:

# Default Smart Auto-Routing (routes Anthropic, OpenAI, and Ollama requests dynamically):
razor --proxy

# Safety Circuit Breaker: Prevent runaway agent loops from burning your hourly budget or 5-hour window:
razor --proxy --max-hourly-tokens 200000

# Resilient 429 Auto-Retry: Automatically pause and retry when hitting upstream rate limits (default: on):
razor --proxy --max-retries 5

# Explicit upstream override (e.g. Groq, vLLM, or OpenRouter):
razor --proxy --upstream-url https://api.groq.com/openai/v1

# Secure remote container binding with mandatory bearer token:
razor --proxy --proxy-bind 0.0.0.0:8080 --allow-remote --proxy-token "$MY_GATEWAY_TOKEN"

Métricas en Tiempo Real y Exportación a Prometheus

Tokenectomy expone datos en vivo de FinOps y economía de tokens vía JSON:

curl http://127.0.0.1:8080/v1/metrics

Devuelve telemetría instantánea para rate_limits_mitigated, circuit_breaker_trips, last_latency_ms, current_hourly_tokens, cache_hits, cache_tokens_saved y estimated_cost_saved_usd.

2. CLI Independiente y Limpieza de Terminal

Cuando depures o canalices la salida de pruebas de terminal directamente:

# Pipe terminal test failures through the surgical redactor:
npm test 2>&1 | razor --scrub

# Sanitize a specific raw log file:
razor --scrub --file /var/log/app/error.log > sanitized.log

# Offline local air-gapped mode (zero external network calls):
cat failure.log | razor --scrub --local-only

🛠️ Herramientas MCP Expuestas

Tokenectomy Razor cumple con el Puntaje de Calidad de Definición de Herramientas (TDQS) Grado A de Glama con límites de parámetros explícitos:

🌐 Ecosistemas Políglotas Soportados

📦 Opciones de Instalación

Método 1: Instantáneo vía npx (Configuración de Toolchain Cero)

npx -y tokenectomy-razor --mcp

Método 2: Cargo (crates.io)

cargo install tokenectomy

Método 3: Binarios Independientes Precompilados

Binarios de lanzamiento independientes y sin dependencias disponibles en GitHub Releases:

• Linux: x86_64-unknown-linux-gnu, x86_64-unknown-linux-musl, aarch64-unknown-linux-gnu
• macOS: aarch64-apple-darwin (Apple Silicon M1/M2/M3/M4), x86_64-apple-darwin (Intel)
• Windows: x86_64-pc-windows-msvc.exe

Método 4: Contenedor Docker Multi-Arquitectura (GHCR)

docker pull ghcr.io/tokenectomy-labs/razor:latest
docker run -i ghcr.io/tokenectomy-labs/razor:latest --mcp

⚖️ Comparación de Ediciones

¿Necesitas Auto-Sanación AST Empresarial? Explora el Nivel Sentinel

🗺️ Hoja de Ruta e Hitos

🔒 Seguridad e Invariantes

• Ejecución Local por Defecto: Todo el análisis de trazas de pila, poda de marcos y redacción de secretos se ejecuta localmente en hardware físico.
• Egreso de Red Documentado: En modo servidor MCP, search_stack_overflow es la única herramienta con egreso de red saliente (HTTPS a api.stackexchange.com). La carga útil se limita estrictamente a texto de firmas de error sanitizado y redactado (sin líneas de código, sin rutas locales, cero credenciales). En entornos aislados de red, usa --local-only para deshabilitar la búsqueda de red por completo.
• Coincidencia de Patrones Determinista en Tiempo Lineal: Todos los motores de coincidencia de patrones utilizan motores regex DFA sin retroceso ($O(N)$ tiempo lineal) y evaluación de autómatas Aho-Corasick.
• Aislamiento de Límites contra Travesía de Rutas: Las operaciones de archivos están estrictamente bloqueadas dentro de la raíz del espacio de trabajo activo (CWD). Las travesías de rutas (../) y los enlaces simbólicos no autorizados están bloqueados.
• Implementación Segura en Rust: Las rutas de ejecución centrales aplican garantías de memoria segura de Rust con lectores de flujo acotados (.take()) que previenen el agotamiento de recursos.

Para divulgaciones de vulnerabilidades, consulta nuestra Política de Seguridad.

⚖️ Aviso Legal y de Bifurcaciones Descendentes

Tokenectomy Razor se proporciona estrictamente para la productividad legal de desarrolladores, observabilidad, cirugía de registros y redacción defensiva de credenciales. Cualquier bifurcación descendente, clon, redistribución o implementación privada opera completamente independiente de los autores originales. Tokenectomy Labs y sus mantenedores asumen cero responsabilidad por acciones ilegales, maliciosas o no autorizadas cometidas por terceros que usen este código base o sus derivados. Todos los operadores descendentes asumen el 100% de responsabilidad individual por el cumplimiento de las leyes de ciberseguridad locales e internacionales. Consulta DISCLAIMER.md para los términos legales completos.

❓ Preguntas Frecuentes (FAQ)

¿Cómo evita Tokenectomy Razor que Claude Code y Cursor alcancen los límites de tasa?

Cuando las pruebas o las compilaciones de terminal fallan, frameworks como Next.js, Express, Jest y Django vuelcan miles de marcos de pila internos (node_modules, site-packages). Enviar registros de fallos crudos de 5,000 líneas consume de 15,000 a 45,000 tokens por prompt, agotando tu límite de sesión de 5 horas en minutos. Tokenectomy Razor intercepta los registros y elimina el 95% de la plomería de framework no accionable, reduciendo un registro de fallo de 40,000 caracteres a menos de 200 tokens esenciales en <0.2ms.

¿Cómo evito que Cursor envíe registros de errores de node_modules a los LLMs?

Ejecuta Tokenectomy Razor como un proxy inverso local de puerta de enlace de IA (npx -y tokenectomy-razor --proxy). En la configuración de Cursor, apunta tu URL Base de OpenAI a http://127.0.0.1:8080/v1. Cualquier salida de error de terminal pegada o referenciada por Composer será automáticamente sanitizada, limpiada y almacenada en caché sobre la marcha antes de llegar a los servidores de modelos.

¿Cómo evita Tokenectomy la fuga de credenciales en los registros de errores?

Toda la cirugía de registros y la redacción de secretos se ejecutan 100% localmente en tu máquina en memoria antes de la transmisión saliente. Razor utiliza regex determinista en tiempo lineal y autómatas Aho-Corasick para detectar y redactar URIs de conexión de PostgreSQL/MongoDB, tokens portadores JWT y claves API de la nube con tokens [REDACTED]. No se requiere egreso a la nube para la limpieza.

🤝 Comunidad y Recursos

• 🌐 Sitio Web Oficial
• 📖 Documentación
• 🏗️ Arquitectura del Sistema
• 📋 Registro de Cambios
• 🤝 Guías de Contribución
• 🔒 Política de Seguridad
• ⚖️ Aviso Legal y Responsabilidad