vipcode 0.2.3 → 0.2.4

package/README.en.md

@@ -2,13 +2,13 @@
 
 [![npm](https://img.shields.io/npm/v/vipcode.svg)](https://www.npmjs.com/package/vipcode) [![Tests](https://github.com/PabloVip/vipcode/actions/workflows/ci.yml/badge.svg)](https://github.com/PabloVip/vipcode/actions/workflows/ci.yml) [![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) · [Español](README.md)
 
-A coding agent for your terminal (command `vipcode`), in the style of opencode, that only uses **free AI models** and **automatically switches provider** when one runs out. The interface and messages are in Spanish.
+A coding agent for your terminal (command `vipcode`) that only uses **free AI models** and **automatically switches provider** when one runs out. The interface and messages are in Spanish.
 
 - **Works right after installing, with no keys or sign-up**: it uses providers that allow anonymous access (Kilo Gateway, OVHcloud, LLM7 and Pollinations).
 - For higher limits and better models, add free keys from the 20+ included providers (Gemini, NVIDIA, Mistral, Cerebras, OpenRouter, Groq, Z.ai…). With OpenRouter you just sign in through the browser: `vipcode auth login openrouter`.
 - With a free [LLM Stats](https://llm-stats.com) key, the best models are tried first according to their ranking.
 - Terminal UI with Markdown, syntax highlighting, diffs, permission prompts, `@file` and `/command` completion, a command palette (Ctrl+P) and `!command` to run shell commands.
-- Tools: read, write and edit files, `list_dir`, `glob`, `grep`, `bash`, `webfetch`, `websearch`, todo list, subagents, LSP diagnostics, MCP tools and **skills** (the open Agent Skills format used by Claude Code and opencode).
+- Tools: read, write and edit files, `list_dir`, `glob`, `grep`, `bash`, `webfetch`, `websearch`, todo list, subagents, LSP diagnostics, MCP tools and **skills** (the open Agent Skills format used by many coding agents).
 - `/undo` and `/redo` backed by git snapshots, saved sessions, automatic context compaction, images, custom agents and commands.
 
 ## Install
@@ -19,6 +19,8 @@ Requires Node.js 22 or later.
 npm install -g vipcode
 ```
 
+Works on macOS, Linux and Windows. On Windows, install [Git for Windows](https://git-scm.com/download/win): vipcode runs commands with its bash (models write bash commands) and uses git for `/undo`; without it, it falls back to PowerShell and tells the model. `VIPCODE_SHELL` picks another shell (`pwsh`, `powershell`, `cmd` or a path to bash).
+
 To update, type `/update` inside vipcode or run `vipcode update` (it installs the latest published version, or pulls the repository if you installed from source). Without the npm registry you can also install the latest GitHub release (`npm install -g https://github.com/PabloVip/vipcode/releases/latest/download/vipcode.tgz`) or run it from source:
 
 ```bash
@@ -43,7 +45,7 @@ vipcode update                         # update vipcode
 
 Every conversation is saved automatically in `~/.vipcode/sessions/` as `.json` (to resume it) and `.md` (the whole conversation, readable and never truncated by context compaction). When you resume one (`vipcode -c`, `/sessions`), the previous conversation is shown on screen.
 
-Inside the UI: Enter sends, Tab switches between the `build` and `plan` agents, Ctrl+P opens the command palette, `@path` attaches files, `!command` runs a shell command, Esc interrupts and `/help` lists everything.
+Inside the UI: Enter sends, Tab switches between the `programar` (build) and `planear` (plan) agents, `/limites` shows how much of each free plan is left today (also in the status bar), Ctrl+P opens the command palette, `@path` attaches files, `!command` runs a shell command, Esc interrupts and `/help` lists everything.
 
 ## Security
 

package/README.md

@@ -2,7 +2,7 @@
 
 [![npm](https://img.shields.io/npm/v/vipcode.svg)](https://www.npmjs.com/package/vipcode) [![Pruebas](https://github.com/PabloVip/vipcode/actions/workflows/ci.yml/badge.svg)](https://github.com/PabloVip/vipcode/actions/workflows/ci.yml) [![Licencia MIT](https://img.shields.io/badge/licencia-MIT-blue.svg)](LICENSE) · [English](README.en.md)
 
-Agente de programación para la terminal (comando `vipcode`), al estilo de opencode, que solo usa **modelos gratuitos** y **rota automáticamente** entre proveedores cuando uno se agota.
+Agente de programación para la terminal (comando `vipcode`) que solo usa **modelos gratuitos** y **rota automáticamente** entre proveedores cuando uno se agota.
 
 - **Funciona nada más instalarlo, sin claves ni registro**: usa los proveedores que permiten el acceso anónimo (Kilo Gateway, OVHcloud, LLM7 y Pollinations).
 - Si quieres más límites y mejores modelos, añade claves gratuitas de los más de 20 proveedores incluidos (Gemini, NVIDIA, Mistral, Cerebras, OpenRouter, Groq, Z.ai…); con OpenRouter basta con iniciar sesión en el navegador. Los modelos gratis nuevos se descubren solos.
@@ -32,7 +32,9 @@ npm run build
 npm link        # deja el comando «vipcode» disponible en cualquier carpeta
 ```
 
-Probado sobre todo en macOS; las pruebas automáticas también pasan en Linux. Si algo falla, [abre un issue](https://github.com/PabloVip/vipcode/issues).
+Funciona en macOS, Linux y Windows: las pruebas automáticas pasan en los tres. Si algo falla, [abre un issue](https://github.com/PabloVip/vipcode/issues).
+
+**En Windows** conviene tener [Git para Windows](https://git-scm.com/download/win): vipcode ejecuta los comandos con su bash, porque los modelos escriben comandos de bash, y usa git para `/undo`. Sin él usa PowerShell y se lo dice al modelo. Para elegir otra shell, pon `VIPCODE_SHELL` (`pwsh`, `powershell`, `cmd` o la ruta de un bash).
 
 ## Primeros pasos
 
@@ -58,10 +60,9 @@ Con **OpenRouter** no hace falta copiar nada: `vipcode auth login openrouter` (o
 Otros inicios de sesión no se incluyen porque sus dueños no permiten usarlos desde otros programas o ya no existen:
 
 - **Google (Gemini CLI, Antigravity)**: Google bloquea las cuentas que los usan fuera de sus programas. La vía permitida es la clave gratis de https://aistudio.google.com/apikey.
-- **GitHub Copilot**: solo está autorizado en opencode y en los editores oficiales, y además es de pago.
+- **GitHub Copilot**: GitHub solo lo permite en los editores y programas que aprueba, y además es de pago.
 - **ChatGPT**: «Iniciar sesión con ChatGPT» existe, pero solo para Plus o Pro, pide que OpenAI dé de alta la aplicación y usa otra API.
 - **Qwen Code**: su plan gratis con cuenta cerró el 15/04/2026.
-- **Modelos gratis de opencode (Zen)**: solo funcionan dentro de opencode.
 
 Para elegir el navegador, pon el comando en `VIPCODE_BROWSER` (por ejemplo `export VIPCODE_BROWSER=firefox`).
 
@@ -95,7 +96,7 @@ Si la misma clave está en `auth.json` y en el entorno, gana la de `auth.json`.
 | Pollinations | sin clave (opcional `POLLINATIONS_API_KEY`) | https://auth.pollinations.ai | Límite por hora y por IP |
 | Ollama, LM Studio, llama.cpp | sin clave | se detectan solos si están encendidos | En tu ordenador, sin límites |
 
-GitHub Models ya no aparece: cerró el 30 de julio de 2026. Los modelos gratis de OpenCode Zen tampoco: opencode los paga y solo deja usarlos desde su propia aplicación.
+GitHub Models ya no aparece: cerró el 30 de julio de 2026.
 
 ## Uso
 
@@ -105,7 +106,8 @@ vipcode                      # interfaz
 vipcode "arregla el test"    # interfaz y empieza con ese mensaje
 vipcode -c                   # continúa la última sesión de esta carpeta
 vipcode run "tarea" --yolo   # hace la tarea sin interfaz y termina
-vipcode --plan               # empieza en modo solo lectura
+vipcode --plan               # empieza con el agente planear (solo lectura)
+vipcode limites              # cuánto te queda hoy de cada plan gratis
 vipcode run "/review"        # también acepta comandos y skills: vipcode run "/mi-skill tarea"
 vipcode update               # actualiza vipcode
 vipcode trust                # confiar en la configuración que trae esta carpeta (vipcode untrust lo deshace)
@@ -124,13 +126,13 @@ Después cierra vipcode y vuelve a abrirlo. Además, una vez al día vipcode mir
 
 - **Enter** envía. **Alt+Enter** o `\` al final de la línea añade una línea nueva.
 - **@ruta** adjunta un fichero, una carpeta o una imagen (con autocompletado). **Ctrl+V** pega una imagen del portapapeles, y arrastrar una imagen a la terminal también la adjunta.
-- **Tab** cambia entre los agentes principales (`build` y `plan`, más los tuyos). **↑/↓** recorren el historial.
+- **Tab** cambia entre los agentes principales (`programar` y `planear`, más los tuyos). **↑/↓** recorren el historial.
 - **Ctrl+P** abre la paleta con todos los comandos, tus comandos y tus skills; escribe para filtrar.
 - **!comando** lo ejecuta en la terminal sin salir de vipcode (por ejemplo `!git status` o `!npm test`). La salida se ve en pantalla y le llega al agente junto con tu siguiente mensaje.
 - **Esc** interrumpe al agente. Mientras trabaja puedes seguir escribiendo: el mensaje se le entrega al acabar el paso actual.
 - **Ctrl+C** interrumpe, cierra el diálogo o borra lo escrito; dos veces seguidas sale.
 
-Mientras trabaja ves qué modelo está pensando, cada herramienta con su acción en español («Lee», «Edita», «Ejecuta»…), las líneas añadidas y quitadas y lo que tarda. Debajo de cada respuesta aparece el modelo que ha contestado, su nota, el tiempo y los tokens. La barra de abajo muestra el agente, el modelo, cuánto contexto llevas gastado (▰▰▱▱), los modelos disponibles y los mensajes en cola.
+Mientras trabaja ves qué modelo está pensando, cada herramienta con su acción en español («Lee», «Edita», «Ejecuta»…), las líneas añadidas y quitadas y lo que tarda. Debajo de cada respuesta aparece el modelo que ha contestado, su nota, el tiempo y los tokens. La barra de abajo muestra el agente, el modelo, cuánto te queda de su plan gratis (ver [Cuánto te queda](#cuánto-te-queda)), cuánto contexto llevas gastado (▰▰▱▱), los modelos disponibles y los mensajes en cola.
 
 Antes de editar un fichero, ejecutar un comando o salir a internet, vipcode pregunta enseñando el diff o el comando. Puedes contestar que sí una vez, que sí a todo lo de ese tipo durante la sesión, que sí siempre a un comando concreto (por ejemplo `npm test*`), que no, o que no y explicarle qué hacer.
 
@@ -150,12 +152,13 @@ Para volver a una conversación: `vipcode -c` (la última de esta carpeta), `/se
 | `/models` | Lista de modelos y su estado; elige uno preferido. `/models refresh` busca modelos gratis nuevos |
 | `/model <p/m>` | Fija un modelo (`/model auto` vuelve a la rotación) |
 | `/connect`, `/disconnect`, `/providers` | Añadir, quitar y ver las claves de los proveedores |
-| `/agents`, `/agent <nombre>`, `/plan`, `/build` | Cambiar de agente |
+| `/agents`, `/agent <nombre>`, `/planear`, `/programar` | Cambiar de agente (también valen `/plan` y `/build`) |
 | `/undo`, `/redo`, `/diff [all]` | Deshacer y rehacer el último mensaje (ficheros y conversación); ver los cambios |
 | `/todos` | Lista de tareas del agente |
 | `/skills` | Skills instaladas; elige una para usarla (o escribe `/nombre-de-la-skill tarea`) |
 | `/compact` | Resumir la conversación |
 | `/new`, `/sessions`, `/load <n>`, `/delete <n>`, `/export` | Sesiones |
+| `/limites` | Cuánto te queda hoy de cada plan gratis (ver [Cuánto te queda](#cuánto-te-queda)) |
 | `/usage` | Tokens usados |
 | `/mcp`, `/lsp` | Estado de los servidores MCP y de lenguaje |
 | `/yolo [on\|off]` | Aprobar todo sin preguntar durante la sesión |
@@ -167,9 +170,11 @@ Para volver a una conversación: `vipcode -c` (la última de esta carpeta), `/se
 
 ### Agentes
 
-- **build**: el principal; puede editar y ejecutar.
-- **plan**: solo lectura; investiga y propone un plan. Los subagentes que lance tampoco pueden editar.
-- **general** y **explore**: subagentes que el agente principal lanza con la herramienta `task` para investigar o hacer subtareas con su propio contexto. Si pide varios a la vez, trabajan en paralelo.
+- **programar**: el principal; puede editar y ejecutar.
+- **planear**: solo lectura; investiga y propone un plan. Los subagentes que lance tampoco pueden editar.
+- **ayudante** y **explorar**: subagentes que el agente principal lanza con la herramienta `task` para hacer subtareas con su propio contexto (ayudante puede editar; explorar solo busca y lee). Si pide varios a la vez, trabajan en paralelo.
+
+Antes se llamaban `build`, `plan`, `general` y `explore`, y esos nombres siguen valiendo en `/agent`, `--agent`, la configuración y los ficheros de agentes.
 
 ## Cómo funciona la rotación
 
@@ -204,6 +209,15 @@ vipcode salta al siguiente de la lista. Lo que pasa con el que ha fallado depend
 
 Las pausas se guardan en `~/.vipcode/state.json`, así que se recuerdan entre ejecuciones. Si todos están en pausa menos de 90 s, vipcode espera; si no, te dice cuándo vuelve el primero.
 
+### Cuánto te queda
+
+`/limites` (o `vipcode limites` en la terminal) enseña lo que llevas hoy en cada proveedor y en cada modelo (peticiones y tokens), cuánto te queda y qué está en pausa y hasta cuándo. La barra de abajo dice lo que queda del modelo que estás usando, en amarillo si queda poco y en rojo si se ha acabado.
+
+- **«quedan»** es lo que dice el propio proveedor en cada respuesta (Groq y Cerebras, por ejemplo, dicen cuántas peticiones te quedan hoy y cuántos tokens por minuto).
+- **«≈ quedan»** es la cuenta de vipcode cuando el proveedor no lo dice: los límites conocidos de su plan gratis (OpenRouter, ModelScope, Kilo, LLM7…) menos lo que ha pedido vipcode. Solo cuenta lo de este ordenador: si usas la misma clave en otros programas, te quedará menos.
+
+El día cuenta en hora UTC, como en la mayoría de proveedores.
+
 Una vez al día (o con `/models refresh`, o `vipcode models refresh` desde la terminal) vipcode pregunta a cada proveedor qué modelos tiene, también a los que no piden clave (Kilo, OVHcloud y LLM7), añade los gratis nuevos y quita los que ya no existen.
 
 ## Configuración
@@ -240,7 +254,7 @@ Una vez al día (o con `/models refresh`, o `vipcode models refresh` desde la te
     "pyright": false,
     "mi-lsp": { "command": ["mi-lsp", "--stdio"], "extensions": [".foo"] }
   },
-  "agents": { "plan": { "model": "gemini/*" } },
+  "agents": { "planear": { "model": "gemini/*" } },
   "commands": { "tests": { "template": "Ejecuta los tests y arregla lo que falle. $ARGUMENTS", "description": "Arregla los tests" } },
   "instructions": ["docs/estilo.md", ".cursor/rules/*.md"],
   "maxSteps": 50,
@@ -262,12 +276,12 @@ Una vez al día (o con `/models refresh`, o `vipcode models refresh` desde la te
 - **providers**: si el nombre coincide con uno del catálogo, solo cambia lo que pongas (los modelos se añaden o se sobrescriben por id; con `"replaceModels": true` se usan solo los tuyos). Si es nuevo, es un proveedor propio compatible con la API de OpenAI y va el primero en la rotación. Admite `apiKeyEnv`, `apiKey`, `headers`, `noKey`, `discover: "openai"` para descubrir sus modelos, y en cada modelo `context`, `vision` y `disabled`.
 - **order**: patrones `proveedor/modelo` que van primero. **model**: modelo fijado al arrancar.
 - **permission**: `allow`, `ask` o `deny`. En `bash` y `mcp` gana el patrón más concreto, y los comandos encadenados (`&&`, `&`, `|`, `;`, saltos de línea) se comprueban por separado. Aunque un comando esté permitido, se pregunta siempre si escribe en un fichero (`>`, `--output`) o lleva `$(…)` o comillas invertidas. Las reglas `deny` se respetan incluso con `--yolo`.
-- **mcp**: servidores locales (`command`) o remotos (`url`, con HTTP o SSE). Sus herramientas aparecen como `servidor_herramienta`. En modo plan solo se usan las marcadas como de solo lectura.
+- **mcp**: servidores locales (`command`) o remotos (`url`, con HTTP o SSE). Los remotos que piden iniciar sesión con OAuth todavía no funcionan; los que usan una cabecera con token, sí. Sus herramientas aparecen como `servidor_herramienta`. En modo plan solo se usan las marcadas como de solo lectura.
 - **lsp**: `false` desactiva los diagnósticos; `"id": false` desactiva un servidor concreto.
 
 ### Agentes y comandos propios
 
-Ficheros Markdown en `~/.vipcode/agents/`, `.vipcode/agents/` o `.opencode/agent/` (compatible con opencode):
+Ficheros Markdown en `~/.vipcode/agents/` (para todos tus proyectos) o `.vipcode/agents/` (solo para ese proyecto):
 
 ```markdown
 ---
@@ -283,12 +297,12 @@ tools:
 Eres un experto en seguridad. Busca inyecciones, secretos en el código y permisos mal puestos.
 ```
 
-Comandos en `~/.vipcode/commands/`, `.vipcode/commands/` o `.opencode/command/`. Se lanzan con `/nombre argumentos`:
+Comandos en `~/.vipcode/commands/` o `.vipcode/commands/`. Se lanzan con `/nombre argumentos`:
 
 ```markdown
 ---
 description: Arregla los tests que fallan
-agent: build
+agent: programar
 ---
 Estos son los tests que fallan ahora mismo:
 !`npm test 2>&1 | tail -40`
@@ -298,11 +312,11 @@ Arréglalos. Céntrate en $ARGUMENTS.
 
 `$ARGUMENTS` es todo lo que escribes detrás del comando, `$1`…`$9` cada palabra (respetando comillas), y `` !`comando` `` se sustituye por su salida. Con `subtask: true` el comando se ejecuta como subagente y no llena la conversación.
 
-Los agentes y comandos que traiga un proyecto se cargan siempre, pero hasta que confías en la carpeta un agente del proyecto no puede cambiar sus permisos (`permission`, `readOnly`) y los `` !`comando` `` de sus comandos no se ejecutan.
+Los agentes y comandos que traiga un proyecto (también los de `.opencode/agent/` y `.opencode/command/`, si ya los tiene) se cargan siempre, pero hasta que confías en la carpeta un agente del proyecto no puede cambiar sus permisos (`permission`, `readOnly`) y los `` !`comando` `` de sus comandos no se ejecutan.
 
 ### Skills
 
-Una skill es una carpeta con un `SKILL.md`: instrucciones (y, si hace falta, scripts y documentos) para un tipo de tarea concreto, como rellenar PDF, seguir la guía de estilo de la empresa o preparar un informe. Es el formato abierto [Agent Skills](https://agentskills.io), el mismo que usan Claude Code y opencode, así que las que encuentres para ellos también sirven aquí.
+Una skill es una carpeta con un `SKILL.md`: instrucciones (y, si hace falta, scripts y documentos) para un tipo de tarea concreto, como rellenar PDF, seguir la guía de estilo de la empresa o preparar un informe. Es el formato abierto [Agent Skills](https://agentskills.io), que usan muchos agentes de programación, así que las skills que encuentres para ellos también sirven aquí.
 
 ```markdown
 ---
@@ -330,13 +344,13 @@ vipcode skills remove informes-semanales
 
 `vipcode skills add` copia las skills a `~/.vipcode/skills`, o con `--project` a `.vipcode/skills`. Si ya existe una con el mismo nombre la deja como está, salvo que añadas `--force`. Para los repositorios hace falta tener `git` instalado.
 
-vipcode también lee las skills de `~/.claude/skills`, `~/.config/opencode/skill`, `~/.agents/skills` y las mismas carpetas dentro del proyecto. Si dos tienen el mismo nombre, gana la del proyecto. En la configuración:
+vipcode también lee las skills que ya tengas de otros programas (`~/.claude/skills`, `~/.config/opencode/skill`, `~/.agents/skills` y las mismas carpetas dentro del proyecto). Si dos tienen el mismo nombre, gana la del proyecto. En la configuración:
 
 ```json
 "skills": { "enabled": true, "paths": ["~/mis-skills"], "disabled": ["una-que-no-quiero"], "external": true }
 ```
 
-`paths` añade carpetas, `disabled` ignora skills por nombre y `external: false` deja de leer las carpetas de Claude Code, opencode y `.agents`. En la cabecera de la skill, `user-invocable: false` hace que solo la use el agente, y `disable-model-invocation: true` que solo la uses tú con `/nombre`.
+`paths` añade carpetas, `disabled` ignora skills por nombre y `external: false` deja de leer esas carpetas de otros programas. En la cabecera de la skill, `user-invocable: false` hace que solo la use el agente, y `disable-model-invocation: true` que solo la uses tú con `/nombre`.
 
 Las skills pueden traer scripts: revisa las que instales si no conoces su origen. vipcode no ejecuta nada por su cuenta; si la skill pide lanzar un script, el agente usa `bash` y te pide permiso igual que con cualquier otro comando.
 
@@ -352,7 +366,7 @@ Después de cada edición, vipcode pregunta al servidor de lenguaje si hay error
 
 vipcode ejecuta lo que le pide un modelo de IA, así que está hecho para que nada importante pase sin que lo veas:
 
-- **Permisos.** Antes de editar un fichero, ejecutar un comando, salir a internet o usar una herramienta MCP, pregunta enseñando el diff o el comando. De serie solo se aprueban solos unos pocos comandos que no cambian nada (`git status`, `git diff`, `git log`, `git show`, `ls`, `pwd`), y ni siquiera esos si llevan otro comando detrás (`&`, `;`, `&&`, `|`), escriben en un fichero (`>`, `--output`) o llevan `$(…)`. Con `--yolo` o `/yolo` se aprueba todo menos lo que tengas en `deny`: úsalo solo en carpetas sin nada que perder.
+- **Permisos.** Antes de editar un fichero, ejecutar un comando, salir a internet o usar una herramienta MCP, pregunta enseñando el diff o el comando. De serie solo se aprueban solos unos pocos comandos que no cambian nada (`git status`, `git diff`, `git log`, `git show`, `ls`, `pwd`), y ni siquiera esos si llevan otro comando detrás (`&`, `;`, `&&`, `|`), escriben en un fichero (`>`, `--output`) o llevan `$(…)`. Con `--yolo` o `/yolo` se aprueba todo menos lo que tengas en `deny`: úsalo solo en carpetas sin nada que perder, porque los comandos no se ejecutan aislados en un sandbox.
 - **Carpetas en las que confías.** Un proyecto puede traer su propia configuración de vipcode (`vipcode.json`, `.vipcode/config.json`, agentes con permisos propios, comandos con `` !`órdenes` ``). Como eso podría arrancar programas, mandar tus claves a otro servidor o quitar las preguntas de permiso, vipcode no lo usa hasta que confías en la carpeta. Al abrirlo te enseña qué cambiaría y te pregunta; con `vipcode run` solo avisa. Si la configuración cambia después (por ejemplo tras un `git pull`), vuelve a preguntar. `vipcode trust` y `vipcode untrust` lo cambian a mano.
 - **Ficheros.** Las herramientas solo leen y escriben dentro de la carpeta del proyecto. Un enlace simbólico que lleve fuera (por ejemplo a `~/.ssh` o a tus claves) se rechaza.
 - **vipcode no puede tocarse a sí mismo.** Aunque lo abras en una carpeta que las contenga (por ejemplo tu carpeta personal), el agente no puede leer ni cambiar `~/.vipcode` (tus claves, tu configuración y las carpetas en las que confías) ni modificar la carpeta donde está instalado vipcode, así que tampoco puede desactivar estas protecciones. Los comandos que nombran esas carpetas se preguntan siempre, aunque tengas una regla `allow` o hayas dicho «sí a todo», y con `--yolo` sin nadie delante se rechazan.
@@ -371,7 +385,7 @@ Los planes gratuitos tienen letra pequeña: los proveedores anónimos (Kilo, OVH
 
 Todo está en `~/.vipcode` (o en `VIPCODE_HOME` si la defines):
 
-- `config.json`: tu configuración. `auth.json`: claves (permisos 600). `state.json`: pausas de los proveedores. `notices.json`: avisos que ya has visto. `update.json`: última comprobación de versiones nuevas. `trusted.json`: carpetas en las que confías.
+- `config.json`: tu configuración. `auth.json`: claves (permisos 600). `state.json`: pausas de los proveedores y lo que llevas usado hoy. `notices.json`: avisos que ya has visto. `update.json`: última comprobación de versiones nuevas. `trusted.json`: carpetas en las que confías.
 - `models.json`: modelos descubiertos. `ranking.json`: puntuaciones de LLM Stats descargadas con tu clave. `sessions/`: conversaciones (un `.json` para seguirlas y un `.md` para leerlas). `history.jsonl`: lo que has escrito.
 - `snapshots/`: instantáneas para `/undo` (un repositorio git aparte por proyecto; no toca tu `.git`).
 - `exports/`: conversaciones exportadas. `agents/`, `commands/` y `skills/`: tus agentes, comandos y skills globales.
@@ -396,14 +410,6 @@ npm run release -- 0.3.0             # o patch, minor o major
 
 Sube el número en `package.json`, pasa las pruebas, crea el commit y la etiqueta, lo sube a GitHub, crea la release con el paquete compilado y lo publica en npm. Quien ya tenga vipcode verá el aviso de versión nueva en menos de un día.
 
-## Lo que aún no tiene respecto a opencode
-
-- La interfaz se dibuja en la propia terminal, no en pantalla completa con paneles.
-- No hay `/share` para publicar la conversación en la web: `/export` la guarda en Markdown.
-- Los servidores MCP remotos con OAuth no funcionan; sí los que usan una cabecera con token.
-- No tiene integración con GitHub (responder a issues o PR) ni cliente/servidor para controlarlo desde otras aplicaciones.
-- `bash` no está aislado en un sandbox: se protege con los permisos.
-
 ## Licencia
 
 [MIT](LICENSE) © Pablo Vicente Juan.

package/dist/agent.js

@@ -1,4 +1,4 @@
-import { subagents, toolEnabled } from "./agents.js";
+import { MAIN_AGENT, agentName, subagents, toolEnabled } from "./agents.js";
 import { systemPrompt } from "./prompt.js";
 import { estimateTokens } from "./router.js";
 import { saveSession } from "./session.js";
@@ -22,10 +22,10 @@ export class Agent {
     running = false;
     // Aviso para el modelo que se añade al siguiente mensaje (por ejemplo tras /undo)
     pendingNote = "";
-    constructor(deps, session, agentName = "build") {
+    constructor(deps, session, name = MAIN_AGENT) {
         this.deps = deps;
         this.session = session;
-        this.agent = deps.agents.find((agent) => agent.name === agentName) || deps.agents.find((agent) => agent.name === "build");
+        this.agent = deps.agents.find((agent) => agent.name === agentName(name)) || deps.agents.find((agent) => agent.name === MAIN_AGENT);
     }
     get mode() {
         if (this.agent.readOnly) {
@@ -34,7 +34,7 @@ export class Agent {
         return "build";
     }
     setAgent(name) {
-        const found = this.deps.agents.find((agent) => agent.name === name);
+        const found = this.deps.agents.find((agent) => agent.name === agentName(name));
         if (!found) {
             return false;
         }
@@ -413,9 +413,9 @@ export class Agent {
     }
     // Un subagente trabaja con su propio historial y devuelve solo su informe final
     async runSubagent(type, prompt, description, parent, signal) {
-        let sub = subagents(this.deps.agents).find((agent) => agent.name === type);
+        let sub = subagents(this.deps.agents).find((agent) => agent.name === agentName(type));
         if (!sub) {
-            sub = subagents(this.deps.agents).find((agent) => agent.name === "general");
+            sub = subagents(this.deps.agents).find((agent) => agent.name === "ayudante");
         }
         if (!sub) {
             return `Error: no existe el subagente ${type}.`;

package/dist/agents.js

@@ -13,7 +13,7 @@ Use glob, grep, list_dir and read_file to answer the question about the codebase
 Your final answer is the only thing the main agent will see: give precise findings with file paths and line numbers.`;
 const BUILTIN = [
     {
-        name: "build",
+        name: "programar",
         description: "Agente principal: lee, edita ficheros y ejecuta comandos",
         mode: "primary",
         prompt: "",
@@ -23,7 +23,7 @@ const BUILTIN = [
         builtIn: true,
     },
     {
-        name: "plan",
+        name: "planear",
         description: "Solo lectura: investiga y propone un plan sin tocar nada",
         mode: "primary",
         prompt: PLAN_PROMPT,
@@ -34,7 +34,7 @@ const BUILTIN = [
         builtIn: true,
     },
     {
-        name: "general",
+        name: "ayudante",
         description: "Subagente para investigar preguntas complejas o hacer tareas de varios pasos de forma autónoma (puede editar)",
         mode: "subagent",
         prompt: GENERAL_PROMPT,
@@ -44,7 +44,7 @@ const BUILTIN = [
         builtIn: true,
     },
     {
-        name: "explore",
+        name: "explorar",
         description: "Subagente rápido de solo lectura para encontrar ficheros, símbolos o entender cómo funciona algo del código",
         mode: "subagent",
         prompt: EXPLORE_PROMPT,
@@ -54,6 +54,14 @@ const BUILTIN = [
         builtIn: true,
     },
 ];
+// Los agentes integrados se llamaban como en opencode: esos nombres siguen valiendo (en /agent, --agent, el config,
+// los ficheros .md que los ajustan, las sesiones guardadas y lo que pida el modelo a la herramienta task)
+const AGENT_ALIASES = { build: "programar", plan: "planear", general: "ayudante", explore: "explorar" };
+export const MAIN_AGENT = "programar";
+// Nombre de verdad de un agente aunque se use el antiguo
+export function agentName(name) {
+    return AGENT_ALIASES[name] || name;
+}
 // Nombres de herramientas de opencode → los de vipcode
 const ALIASES = {
     read: "read_file",
@@ -122,10 +130,11 @@ export function loadAgents(root, config, trusted = projectTrust(root).trusted) {
     const disabled = new Set();
     const apply = (name, input, source) => {
         if (input.disable) {
-            disabled.add(name);
+            disabled.add(agentName(name));
             return;
         }
-        agents.set(name, fromInput(name, input, agents.get(name), source));
+        const real = agentName(name);
+        agents.set(real, fromInput(real, input, agents.get(real), source));
     };
     for (const entry of readMarkdownDir(dirs)) {
         const data = entry.data;
@@ -151,8 +160,8 @@ export function loadAgents(root, config, trusted = projectTrust(root).trusted) {
     for (const name of disabled) {
         agents.delete(name);
     }
-    if (!agents.has("build")) {
-        agents.set("build", { ...BUILTIN[0] });
+    if (!agents.has(MAIN_AGENT)) {
+        agents.set(MAIN_AGENT, { ...BUILTIN[0] });
     }
     return [...agents.values()];
 }

package/dist/app.js

@@ -2,13 +2,14 @@ import { spawn } from "node:child_process";
 import fs from "node:fs";
 import pc from "picocolors";
 import { Agent } from "./agent.js";
-import { loadAgents, primaryAgents, subagents } from "./agents.js";
+import { MAIN_AGENT, agentName, loadAgents, primaryAgents, subagents } from "./agents.js";
 import { envNames, maskKey, readAuth, removeAuth, resolveCredentials, saveAuth, urlVars } from "./auth.js";
 import { CATALOG } from "./catalog.js";
 import { expandCommand, loadCommands } from "./commands.js";
 import { CONFIG_PATH, configNotices, isAnonymous, loadConfig, setGlobalConfigValue } from "./config.js";
 import { buildProviders, detectLocal, refreshModels } from "./discovery.js";
 import { isRemoteSession, loginOpenRouter, openBrowser } from "./login.js";
+import { limitsReport } from "./limits.js";
 import { LspManager } from "./lsp.js";
 import { McpManager } from "./mcp.js";
 import { AUTH_PATH, HOME_DIR, NOTICES_PATH, STATE_PATH, ensureHomeDir } from "./paths.js";
@@ -18,6 +19,7 @@ import { Router } from "./router.js";
 import { loadSkills, skillContent } from "./skills.js";
 import { deleteSession, listSessions, newSession, saveExport, saveSession, sessionMarkdownPath } from "./session.js";
 import { Snapshots } from "./snapshot.js";
+import { commandShell, killTree } from "./shell.js";
 import { updateVipcode } from "./update.js";
 import { formatTodos, truncate } from "./tools.js";
 import { projectTrust } from "./trust.js";
@@ -30,8 +32,9 @@ export const BUILTIN_COMMANDS = [
     { name: "providers", description: "proveedores gratuitos, si tienes clave y dónde conseguirla" },
     { name: "agents", description: "agentes disponibles (Tab cambia entre los principales)" },
     { name: "agent", args: "<nombre>", description: "cambiar de agente" },
-    { name: "plan", description: "agente de solo lectura" },
-    { name: "build", description: "agente que puede modificar ficheros" },
+    { name: "planear", description: "agente de solo lectura: investiga y propone un plan (antes /plan)" },
+    { name: "programar", description: "agente que puede modificar ficheros (antes /build)" },
+    { name: "limites", description: "cuánto te queda hoy de cada plan gratis" },
     { name: "undo", description: "deshacer el último mensaje (ficheros y conversación)" },
     { name: "redo", description: "rehacer lo deshecho" },
     { name: "diff", args: "[all]", description: "cambios del último mensaje (o de toda la sesión)" },
@@ -175,7 +178,7 @@ export class App {
             snapshots: this.snapshots,
             skills: this.skills,
             ask: (request, agent) => this.ask(request, agent),
-        }, options.session || newSession(root), options.agentName || options.session?.agent || "build");
+        }, options.session || newSession(root), options.agentName || options.session?.agent || MAIN_AGENT);
     }
     ask(request, agent) {
         const permission = permissionsFor(this.config.permission, agent.permission);
@@ -341,12 +344,12 @@ export class App {
                 this.router.pinned = options.model;
             }
             if (options.subtask) {
-                const report = await this.agent.runSubagent(options.agent || "general", input.text, "comando", this.agent.agent, signal);
+                const report = await this.agent.runSubagent(options.agent || "ayudante", input.text, "comando", this.agent.agent, signal);
                 this.agent.events.onText?.(report, 0);
                 this.agent.events.onTextEnd?.(0);
                 return;
             }
-            if (options.agent && this.agents.some((agent) => agent.name === options.agent)) {
+            if (options.agent && this.agents.some((agent) => agent.name === agentName(options.agent))) {
                 this.agent.setAgent(options.agent);
             }
             await this.agent.run(input, signal);
@@ -706,7 +709,7 @@ export class App {
                 return {};
             }
             case "/agent": {
-                const found = this.agents.find((agent) => agent.name === arg);
+                const found = this.agents.find((agent) => agent.name === agentName(arg));
                 if (!found) {
                     ui.error(`No existe el agente «${arg}». Mira /agents`);
                 }
@@ -866,6 +869,10 @@ export class App {
                 }
                 return {};
             }
+            case "/limites":
+            case "/limits":
+                ui.block(limitsReport(this.router));
+                return {};
             case "/usage": {
                 const usage = this.agent.session.usage;
                 ui.info(`Tokens en esta sesión: ${usage.prompt} de entrada y ${usage.completion} de salida (todo gratis). Última petición: ~${this.agent.lastTokens} tokens con ${this.agent.lastSlot || "—"}.`);
@@ -951,7 +958,8 @@ export class App {
             const task = arg ? `\n\nTarea: ${arg}` : "";
             return { run: { input: { text: `Usa la skill «${skill.name}» para esto.${task}\n\n${skillContent(skill)}`, display: text.trim() }, options: {} } };
         }
-        const agent = this.primaryAgents().find((item) => item.name === name);
+        // /programar, /planear y los tuyos (también /build y /plan, como antes)
+        const agent = this.primaryAgents().find((item) => item.name === agentName(name));
         if (agent) {
             this.agent.setAgent(agent.name);
             ui.info(`Agente ${agent.name}: ${agent.description}`);
@@ -989,13 +997,18 @@ export class App {
     // y guarda la salida para que el agente la vea con tu siguiente mensaje
     runShell(command, onOutput, signal) {
         return new Promise((resolve) => {
-            let shell = process.env.SHELL || "bash";
-            let args = ["-lc", command];
-            if (process.platform === "win32") {
-                shell = "cmd.exe";
-                args = ["/c", command];
+            // Tu shell de siempre; en Windows, la misma que usa el agente (el bash de Git o PowerShell)
+            let shell = { file: process.env.SHELL || "bash", args: ["-lc", command], env: {} };
+            if (process.platform === "win32" || process.env.VIPCODE_SHELL) {
+                const found = commandShell();
+                shell = { file: found.file, args: found.args(command), env: found.env };
             }
-            const child = spawn(shell, args, { cwd: this.root, stdio: ["ignore", "pipe", "pipe"], env: { ...process.env, GIT_PAGER: "cat", PAGER: "cat" } });
+            const child = spawn(shell.file, shell.args, {
+                cwd: this.root,
+                stdio: ["ignore", "pipe", "pipe"],
+                env: { ...process.env, ...shell.env, GIT_PAGER: "cat", PAGER: "cat" },
+                windowsHide: true,
+            });
             let output = "";
             const add = (data) => {
                 const text = data.toString();
@@ -1004,8 +1017,8 @@ export class App {
             };
             child.stdout.on("data", add);
             child.stderr.on("data", add);
-            const timer = setTimeout(() => child.kill("SIGTERM"), this.config.bashTimeoutMs);
-            const stop = () => child.kill("SIGTERM");
+            const stop = () => killTree(child);
+            const timer = setTimeout(stop, this.config.bashTimeoutMs);
             signal?.addEventListener("abort", stop, { once: true });
             let done = false;
             const finish = (code) => {

package/dist/catalog.js

@@ -97,6 +97,7 @@ export const CATALOG = [
         discover: "openai",
         pruneMissing: true,
         limitScope: "model",
+        freeLimits: { perDay: 14400 },
         defaultContext: 60000,
         contextCap: 60000,
         models: [m("gpt-oss-120b", 60000), m("qwen-3.8-27b", 60000, V)],
@@ -115,6 +116,7 @@ export const CATALOG = [
         freeOnly: true,
         pruneMissing: true,
         limitScope: "provider",
+        freeLimits: { perDay: 50 },
         defaultContext: 128000,
         models: [
             m("nvidia/nemotron-3-ultra-550b-a55b:free", 1000000),
@@ -144,6 +146,8 @@ export const CATALOG = [
         discover: "openai",
         pruneMissing: true,
         limitScope: "model",
+        freeLimits: { perDay: 1000 },
+        rateHeaders: { requests: "day", tokens: "minute" },
         defaultContext: 7000,
         // El plan gratis de Groq limita los tokens por minuto, así que solo vale para conversaciones cortas
         contextCap: 11000,
@@ -309,6 +313,7 @@ export const CATALOG = [
         signup: "https://modelscope.cn/my/myaccesstoken",
         freeInfo: "2.000 llamadas gratis al día (hay que vincular una cuenta de Alibaba Cloud).",
         limitScope: "provider",
+        freeLimits: { perDay: 2000 },
         models: [
             m("Qwen/Qwen3-Coder-30B-A3B-Instruct", 262144),
             m("Qwen/Qwen3-235B-A22B-Instruct-2507", 262144),
@@ -371,6 +376,7 @@ export const CATALOG = [
         freeOnly: true,
         pruneMissing: true,
         limitScope: "provider",
+        freeLimits: { perHour: 200, keyless: true },
         defaultContext: 128000,
         // Primero modelos concretos y buenos con herramientas; kilo-auto/free elige uno al azar (a veces flojo)
         models: [
@@ -422,6 +428,7 @@ export const CATALOG = [
         freeOnly: true,
         pruneMissing: true,
         limitScope: "provider",
+        freeLimits: { perHour: 60, keyless: true },
         defaultContext: 128000,
         models: [
             m("minimax-m2.7", 180000),

package/dist/commands.js

@@ -2,6 +2,7 @@ import { spawn } from "node:child_process";
 import path from "node:path";
 import { readMarkdownDir } from "./frontmatter.js";
 import { GLOBAL_COMMANDS_DIR } from "./paths.js";
+import { commandShell, killTree, splitArgs } from "./shell.js";
 import { truncate } from "./tools.js";
 import { isProjectFile, projectTrust } from "./trust.js";
 const INIT_TEMPLATE = `Analiza este proyecto y crea (o mejora, si ya existe) el fichero AGENTS.md en la raíz, con las instrucciones que necesitaría otro agente de programación para trabajar aquí sin perder tiempo.
@@ -23,7 +24,7 @@ Para cada problema di el fichero y la línea, por qué es un problema y cómo lo
 $ARGUMENTS`;
 const BUILTIN = [
     { name: "init", description: "Crea o mejora AGENTS.md con las instrucciones del proyecto", template: INIT_TEMPLATE, subtask: false, builtIn: true },
-    { name: "review", description: "Revisa los cambios sin confirmar (no modifica nada)", template: REVIEW_TEMPLATE, agent: "plan", subtask: false, builtIn: true },
+    { name: "review", description: "Revisa los cambios sin confirmar (no modifica nada)", template: REVIEW_TEMPLATE, agent: "planear", subtask: false, builtIn: true },
 ];
 // Comandos integrados + ~/.vipcode/commands + .vipcode/commands y .opencode/command(s) del proyecto + "commands" del config
 export function loadCommands(root, config, trusted = projectTrust(root).trusted) {
@@ -67,27 +68,17 @@ export function loadCommands(root, config, trusted = projectTrust(root).trusted)
     }
     return [...commands.values()];
 }
-// Separa los argumentos respetando las comillas: a "b c" d → [a, b c, d]
-export function splitArgs(text) {
-    const result = [];
-    const pattern = /"([^"]*)"|'([^']*)'|(\S+)/g;
-    let match;
-    while ((match = pattern.exec(text)) !== null) {
-        result.push(match[1] ?? match[2] ?? match[3]);
-    }
-    return result;
-}
 function runShell(command, cwd) {
     return new Promise((resolve) => {
-        let shell = "bash";
-        let args = ["-lc", command];
-        if (process.platform === "win32") {
-            shell = "cmd.exe";
-            args = ["/c", command];
-        }
-        const child = spawn(shell, args, { cwd, stdio: ["ignore", "pipe", "pipe"], env: { ...process.env, GIT_PAGER: "cat", PAGER: "cat" } });
+        const shell = commandShell();
+        const child = spawn(shell.file, shell.args(command), {
+            cwd,
+            stdio: ["ignore", "pipe", "pipe"],
+            env: { ...process.env, ...shell.env, GIT_PAGER: "cat", PAGER: "cat" },
+            windowsHide: true,
+        });
         let output = "";
-        const timer = setTimeout(() => child.kill("SIGTERM"), 30000);
+        const timer = setTimeout(() => killTree(child), 30000);
         child.stdout.on("data", (d) => (output += d.toString()));
         child.stderr.on("data", (d) => (output += d.toString()));
         child.on("error", (err) => {