reprompt

ctxray

Descubre cómo usas realmente la IA.

Haz una radiografía de tus sesiones de codificación con IA en Claude Code, Cursor, ChatGPT y 6 herramientas más. Descubre tus patrones, encuentra tokens desperdiciados, detecta secretos filtrados — todo localmente, nada sale de tu máquina.

Inicio rápido

pip install ctxray

ctxray scan                    # discover prompts from your AI tools
ctxray wrapped                 # your AI coding persona + shareable card
ctxray insights                # your patterns vs research-optimal
ctxray privacy                 # what sensitive data you've exposed

Funciona en tu pipeline

Integra ctxray en tu CI como un control de calidad de prompts. Sin LLM, sin clave de API, sin red — <50ms por prompt.

# .github/workflows/prompt-quality.yml
- uses: ctxray/ctxray@main
  with:
    score-threshold: 43    # experimentally validated quality threshold
    model: claude          # model-specific rules (claude/gpt/gemini)
    comment-on-pr: true

# .pre-commit-config.yaml
repos:
  - repo: https://github.com/ctxray/ctxray
    rev: v3.0.0
    hooks:
      - id: ctxray-lint-score   # fail below quality threshold
      # or: id: ctxray-lint-claude  # Claude-specific rules + threshold

• Determinista — mismo prompt, misma puntuación, en cada ejecución. Sin comprobaciones LLM poco fiables.
• Aislado de red — funciona en redes offline y privadas. Todo el análisis permanece en tu infraestructura.
• Configurable — .ctxray.toml o [tool.ctxray.lint] en pyproject.toml. Reglas por proyecto.

Configuración completa: GitHub Action · pre-commit · .ctxray.toml

Lo que descubrirás

Tu persona de codificación con IA

ctxray wrapped genera un informe estilo Spotify Wrapped de tus interacciones con IA — tu persona (¿Depurador? ¿Arquitecto? ¿Explorador?), patrones principales y una tarjeta compartible.

Tus patrones de prompts

ctxray insights compara tus hábitos reales de prompting con puntos de referencia respaldados por investigación. ¿Son tus prompts lo suficientemente específicos? ¿Cargas las instrucciones al principio? ¿Cuánto contexto proporcionas?

Tu exposición de privacidad

ctxray privacy --deep escanea cada prompt que has enviado en busca de claves de API, tokens, contraseñas y PII. Ve exactamente qué has compartido con cada herramienta de IA.

Diagnóstico completo de prompts

ctxray check "your prompt" puntúa, analiza y reescribe en un solo comando — sin LLM, <50ms.

Validado experimentalmente en más de 3000 llamadas LLM en 8 modelos (1.5B → 27B): los prompts con puntuación igual o superior a 43 alcanzan ~93% de tasa de aprobación en pruebas de código ejecutable. Por debajo de 43 promedian 72% o menos. ctxray te dice en qué lado estás y qué corregir — consulta experiments/RESULTS.md para los datos completos entre modelos.

ctxray check "fix the auth bug in login.ts"        # threshold pass/fail + diagnostics
ctxray check "fix bug" --model claude               # model-specific scoring for Claude
ctxray check "refactor middleware" --threshold 50    # custom threshold for stricter teams

Más capturas de pantalla

ctxray rewrite — mejora de prompts basada en reglas

ctxray build — ensambla prompts a partir de componentes

Cómo se ve un prompt malo

Todos los comandos

Descubre tus patrones

Optimiza tus prompts

Gestionar

Herramientas de IA compatibles

Instalación

pip install ctxray              # core (all features, zero config)
pip install ctxray[chinese]     # + Chinese prompt analysis (jieba)
pip install ctxray[mcp]         # + MCP server for Claude Code / Continue.dev / Zed

Escaneo automático después de cada sesión

ctxray install-hook             # adds post-session hook to Claude Code

Extensión de navegador

Captura prompts de ChatGPT, Claude.ai y Gemini directamente en tu navegador. La insignia de calidad en vivo muestra el nivel del prompt mientras escribes — haz clic en "Rewrite & Apply" para mejorar y reemplazar el texto directamente en el cuadro de entrada.

1. Instala la extensión desde Chrome Web Store o Firefox Add-ons
2. Conéctate al CLI: ctxray install-extension
3. Verifica: ctxray extension-status

Los prompts capturados se sincronizan localmente mediante Native Messaging — nada sale de tu máquina.

Integración con CI

GitHub Action

# .github/workflows/prompt-lint.yml
name: Prompt Quality
on: pull_request

jobs:
  lint:
    runs-on: ubuntu-latest
    permissions:
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
      - uses: ctxray/ctxray@main
        with:
          score-threshold: 43     # experimentally validated (below = 83% failure rate)
          model: claude           # optional: model-specific rules
          strict: true
          comment-on-pr: true

pre-commit

# .pre-commit-config.yaml
repos:
  - repo: https://github.com/ctxray/ctxray
    rev: v3.0.0
    hooks:
      - id: ctxray-lint-score     # quality threshold gate (score >= 43)
      # - id: ctxray-lint-claude  # Claude-specific rules + threshold
      # - id: ctxray-lint-gpt    # GPT-specific rules + threshold

CLI directo

ctxray lint --score-threshold 43  # exit 1 below experimentally validated threshold
ctxray lint --score-threshold 50  # or set your own bar
ctxray lint --model claude        # model-specific lint rules
ctxray lint --strict              # exit 1 on warnings
ctxray lint --json                # machine-readable output

Configuración del proyecto

ctxray init   # generates .ctxray.toml with all rules documented

# .ctxray.toml (or [tool.ctxray.lint] in pyproject.toml)
[lint]
score-threshold = 43   # experimentally validated quality threshold
model = "claude"       # model-specific rules (claude/gpt/gemini)

[lint.rules]
min-length = 20
short-prompt = 40
vague-prompt = true
debug-needs-reference = true

 Data sources:
 ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
 │Claude Code│ │  Cursor  │ │  Aider   │ │ ChatGPT  │ │ 5 more.. │
 └─────┬────┘ └─────┬────┘ └─────┬────┘ └─────┬────┘ └─────┬────┘
       └─────────────┴───────────┴─────────────┴─────────────┘
                                 │
                    scan -> dedup -> store -> analyze
                                 │
              ┌──────────────────┼──────────────────┐
              v                  v                  v
        ┌──────────┐     ┌──────────────┐    ┌──────────┐
        │ insights │     │  patterns    │    │ sessions │
        │ wrapped  │     │  repetition  │    │ projects │
        │ style    │     │  privacy     │    │ agent    │
        └──────────┘     └──────────────┘    └──────────┘

¿Por qué ctxray?

Después de que Promptfoo se uniera a OpenAI y Humanloop se uniera a Anthropic, ctxray es la alternativa independiente y de código abierto para entender tus interacciones con IA.

• 100% local — tus prompts nunca salen de tu máquina
• Sin LLM necesario — análisis puramente basado en reglas, <50ms por prompt
• 9 herramientas de IA — la única herramienta que funciona en Claude Code, Cursor, ChatGPT y más
• Respaldado por investigación — calibrado con 10 artículos revisados por pares, no con corazonadas

Publicado anteriormente como reprompt-cli. Misma herramienta, nuevo nombre, namespace limpio.

Privacidad

• Todo el análisis se ejecuta localmente. Ningún prompt sale de tu máquina.
• ctxray privacy muestra exactamente qué has enviado a cada herramienta de IA.
• La telemetría opcional envía solo vectores de características anónimos — nunca el texto de los prompts.
• Código abierto: audita exactamente qué se recopila.

Enlaces

• PyPI: ctxray
• Extensión de Chrome: Chrome Web Store
• Complemento de Firefox: Firefox Add-ons
• Changelog: CHANGELOG.md

Contribuciones

Consulta CONTRIBUTING.md para la configuración de desarrollo y las pautas.

Licencia

MIT