Visión general

jAIgent es un agente de IA de línea de comandos con una idea clara: un binario, diez proveedores y las mismas herramientas en todas partes. Terminal, ChatGPT Web por MCP remoto, Claude Desktop por stdio local y cualquier aplicación que hable el SDK de OpenAI.

Por qué existe

Lo que de verdad es distinto

Deshacer es el producto. Cada escritura se snapshot antes del aviso de aprobación. jaigent undo, rewind <id> y /revert existen porque otros agentes te preguntan antes, pero jAIgent además te deja cambiar de opinión después.

Web y archivos en el mismo bucle. web_search → fetch_page → write_file. No es un envoltorio de chat ni un codificador limitado a un repositorio.

Enlaza en vez de sustituir. MCP remoto con OAuth para ChatGPT Web, MCP stdio local para clientes de escritorio, serve para todo lo que hable OpenAI, y skills, plugins y comandos como archivos locales que puedes confirmar en Git.

Diez proveedores, o ninguno. OpenAI, Anthropic, Gemini, DeepSeek, Grok, Groq, Mistral, OpenRouter, Together y Ollama. --model auto dimensiona el trabajo; --model free elige un modelo sin coste al que de verdad puedas llegar.

Tope de gasto duro. jaigent settings set budget 0.50 detiene la ejecución. Skills integradas spend-cap y compact; /compact en el chat; memoria solo si la activas.

Conservador por defecto. Sandbox de espacio de trabajo, sin shell salvo que pases --allow-shell, archivos de secretos rechazados y sin telemetría. Un solo binario si no quieres Python.

Lo bastante pequeño para leerse. El bucle del agente es una función. Sin framework.

Funciones por versión

Cómo encaja todo

                    CLI (cli.py)       MCP stdio (mcp.py)       gateway (serve)
                       │                    │                        │
                       └──────────────┬─────┴────────────────────────┘
                                      │    Agent (agent.py)
                                      │  ┌─────────────────────────────┐
                                      │  │ route → proveedor → tools…  │
                                      │  └────────┬─────────────┬──────┘
                                      │           │             │
                             FailoverProvider   ToolRegistry
                                      │           │
                         adaptadores llm/     tools/ (archivos, web,
                         (openai, etc.)       shell, ask, plugins)

              ChatGPT Web → chatgpt.py (MCP OAuth) ──┬── registro de herramientas existente
                                                     └── API /v1 del gateway → Agent

Un solo Agent, un solo registro de herramientas y una sola implementación de aprobación y checkpoints. El CLI y el gateway compatible con OpenAI conducen el mismo bucle; el MCP local expone el registro; el puente entrante de ChatGPT compone ese mismo registro para llamadas directas y delega los turnos completos de agente o sesión a través del gateway existente. No crea un segundo agente ni duplica la lógica de las herramientas.

Los detalles están en Referencia de tools.

Empezar en cuatro comandos

jaigent init                          # elige proveedor, pega una clave, pruébala
jaigent "resume README.md en overview.md"
jaigent undo                          # devuelve overview.md si no te gusta
jaigent chat                          # y sigue de forma interactiva

jgt es un alias más corto del mismo comando.

Licencia

El acuerdo que rige es LICENSE.md, y no es una licencia de código abierto. Concede un uso limitado, no exclusivo, intransferible y revocable, solo para fines internos, no comerciales y educativos, y prohíbe expresamente distribuirlo como parte de un producto o servicio de pago, redistribuirlo en un instalador o paquete que se comercialice por separado, hacer ingeniería inversa y usarlo de forma que compita con las ofertas del autor. Solo el titular de los derechos puede autorizar el uso comercial, y debe pedirse por escrito.

Seguir leyendo en el repositorio

Esta guía resume y ordena. El repositorio trae además su propia documentación, y hay un par de archivos que conviene no confundir con funcionalidad existente.

Dos avisos antes de leerlos

Las dos skills integradas son instrucciones, no mecanismos. Cada una declara en su cabecera cuándo debe cargarse y qué hay que hacer, y el trabajo mecánico lo hace otra parte:

La skill de ChatGPT, por su parte, asume un endpoint MCP remoto por HTTP protegido con OAuth: no hace que un servidor stdio local sea alcanzable desde ChatGPT Web.

Recorrido de la guía

• Instalación y claves — binario, PyPI o fuente, y cómo conseguir una clave.
• Uso en la terminal — comandos, chat, undo y streaming.
• Modelos y proveedores — auto, free y conmutación por fallo.
• MCP y tu propia API — conectar ChatGPT Web, Claude Desktop y tus apps.
• Skills, plugins y horarios — ampliarlo con archivos locales.
• Referencia de tools — tabla de herramientas, variables y modelo de seguridad.
• Seguridad — qué defiende, qué no defiende a propósito y cómo informar de una vulnerabilidad.
• Desarrollo — el entorno, cómo está organizado el código, el servidor de simulación y los workflows.