Referencia de la CLI ingot
Todos los comandos y opciones de ingot, la herramienta de línea de comandos que genera, valida, empaqueta y publica extensiones para la tienda de Ingot (paquete @ingotide/cli, Node.js 22 o posterior).
npm install -g @ingotide/cli # o: npx @ingotide/cli <comando>
ingot help
ingot <comando> --help
Comandos
| Comando | Qué hace |
|---|---|
ingot init [carpeta] | Genera una extensión: ingot.json, README, CHANGELOG, LICENSE, .gitignore, archivos de inicio y un flujo de CI |
ingot add <tipo> <nombre> | Añade una regla, un habit, un comando o un servidor MCP: el archivo y su entrada en ingot.json |
ingot try <proyecto> | Instala la extensión en la carpeta .ingot/ de un proyecto para probarla |
ingot validate | Comprueba ingot.json y cada archivo al que apunta, como la tienda |
ingot package | Escribe <publisher>.<name>-<version>.ingotx |
ingot login | Comprueba un token de publicación y lo guarda |
ingot logout | Olvida el token guardado |
ingot whoami | Muestra el publicador y la caducidad del token en uso |
ingot publish [archivo] | Sube a la tienda |
ingot unpublish [id] | Retira una versión o la extensión entera |
ingot version [subida] | Muestra versiones o sube la versión de ingot.json |
ingot export | Escribe .ingot/rules en AGENTS.md, CLAUDE.md, .cursor/rules, .windsurf/rules y las instrucciones de Copilot; --check para CI |
ingot rules test | Ejecuta .ingot/tests/*.yaml contra tus reglas con un modelo barato y un tope de coste estricto |
ingot rules prune | Lista las reglas obsoletas (sin uso, globs muertos, rutas borradas, paquetes eliminados); --apply las quita |
ingot review | Revisión del agente antes del commit: los cambios preparados (si no, todos), en un modo de revisión (--mode) o como Find issues (--find-issues), con hallazgos, correcciones y un tope de coste estricto; sale con 1 ante hallazgos graves |
ingot tab predict <archivo> | Muestra el texto fantasma y la siguiente edición que Tab sugeriría en --line, con un modelo barato y un tope de coste estricto |
ingot context files|attach|compose|rules|projects | Lo que adjunta el chat del agente: todos los archivos del proyecto ordenados como el selector @, el contexto que envía un chip, el prompt que envía un mensaje escrito (chips en el orden escrito), las reglas del menú / y la lista de /projects/. No llama a ningún modelo |
ingot learnings | Contexto compartido del proyecto: lo que agentes y compañeros aprendieron del proyecto en .ingot/context. list, add, share, outdated, remove, lo que recibe un agente (prompt), check para CI y sync a AGENTS.md. No llama a ningún modelo |
ingot image notes <imagen> | Pregunta a un modelo de visión sobre una imagen; señala partes con notas numeradas y escribe un SVG anotado, con un tope de coste estricto |
ingot merge <tuyo> <base> <suyo> | Fusión inteligente, como el visor de diferencias: aplica los cambios sin conflicto y deja los conflictos con marcadores; sale con 1 mientras queden conflictos |
ingot handoff send | Envía una tarea o un plan a un agente en la nube de Ingot sobre el repositorio de GitHub del proyecto; list, status, cancel, followup y checkout siguen sus ejecuciones |
ingot preview servers|devices|check | La vista previa de la app desde la terminal: servidores de desarrollo y páginas web locales como su menú de puertos, los tamaños de dispositivo y si un puerto o URL responde (--wait para scripts). No se llama a ningún modelo |
ingot preview mobile, ingot preview qr | Vista previa en móvil desde la terminal: simuladores de iOS, iPhones, emuladores y teléfonos Android, abrir un servidor de desarrollo o una app de Expo en uno de ellos, conectar Android por Wi-Fi y un código QR de la dirección LAN. No se llama a ningún modelo |
ingot usage | Unidades de tokens restantes, uso por nivel de modelo, minutos de Zaprex; activa o desactiva el uso bajo demanda con un límite; límites por miembro del equipo |
ingot agents | El Centro de mando de agentes en la terminal: los agentes de cada ventana de Ingot en este equipo y tus ejecuciones en la nube, por estado; cancel detiene una ejecución en la nube |
ingot automations | Agentes que se inician con un PR, un comentario, un fallo de CI, Slack, un webhook o un horario y mantienen una meta hasta cumplirla: list, validate, new, test sin conexión, sync a la nube, run y fires |
ingot acp | Agentes de código abierto (OpenCode, Goose, OpenHands) o cualquier agente Agent Client Protocol que añadas, desde la terminal: listarlos, comprobar la conexión, ejecutar un turno, añadir un agente propio |
ingot arena | El modo Arena en la terminal: dos modelos ocultos responden a una tarea con un tope de coste estricto, votas y luego se revelan los modelos; vote, leaderboard y votes leen y escriben .ingot/arena/votes.jsonl |
ingot extensions | Extensiones de la tienda de Ingot, como el Agent Command Center: lista con precio y nivel, info, instalar, desinstalar, y activar o desactivar las sugerencias de funciones de la app |
ingot panes | Session Panes: planifica hasta 8 sesiones de agentes en .ingot/panes.json para que Ingot las abra lado a lado. list, add, remove, clear, layout, validate para CI y grid para ver una disposición. No llama a ningún modelo |
ingot layout | Diseño enfocado del agente: muestra cada ajuste del diseño con el archivo del que viene, cambia o restablece uno en el archivo de ajustes del proyecto, de usuario o global, y los lista todos. No llama a ningún modelo |
ingot sandbox | Agent Sandbox: qué sandbox del sistema operativo reciben los agentes en esta máquina (Seatbelt, bubblewrap o la puerta de aprobación de Windows) y la lista de permitidos del proyecto (comandos, hosts y carpetas) en .ingot/policy.json. status, list, allow, remove y wrap para ver la línea de comando con sandbox. No se llama a ningún modelo |
ingot git | Hosts de Git: conecta GitLab, Bitbucket Cloud y Data Center, Azure DevOps, Gitea o Forgejo con un token u OAuth, lista repositorios, ramas, pull requests, issues y ejecuciones de CI, abre un pull request o un issue, y mcp sirve las mismas herramientas a los agentes |
ingot mcp | Servidores MCP: lista los servidores de mcp.json, inicia sesión en servidores remotos con OAuth, comprueba su salud (sale con 1 si uno está caído), lista las herramientas con su riesgo y ejecuta una |
ingot extensions search|install|inspect|sources | Búsqueda en el Marketplace: una lista de la Ingot Store y Open VSX (el Microsoft Marketplace solo con --microsoft-marketplace), instala un .vsix por id o archivo en la carpeta de extensiones de Ingot e inspecciona un .vsix. Forma corta ingot ext |
ingot habits | Hábitos: la carpeta de conocimiento por tipo .ingot/habits/ (bug.md, tests.md, …). init, add (clasificado o --type), classify, read, relevant, new-type (o new type <nombre>), list, show y los playbooks de escenario (new playbook <nombre>). No llama a ningún modelo |
La mayoría de comandos aceptan --cwd <dir> para trabajar en otra carpeta, y --help.
init
ingot init [carpeta] --type <theme|rules|habits|mcp|rex-template> [opciones]
| Opción | Por defecto | Notas |
|---|---|---|
--type | se pregunta | el tipo de extensión |
--name | el nombre de la carpeta | palabras en minúsculas unidas con - |
--publisher | se pregunta | tu identificador de publicador |
--display-name | a partir del nombre | el nombre en la tienda |
--description | según el tipo | una línea para la tarjeta de la tienda |
--license | MIT | un id SPDX; se escribe un archivo LICENSE MIT |
--ci | github | github (.github/workflows/ingot-publish.yml), gitlab (.gitlab-ci.yml) o none |
--force | escribe en una carpeta que no está vacía | |
-y, --yes | no pregunta nunca; usa los valores por defecto |
Sin --yes, los valores que faltan se preguntan. En CI (sin terminal o con CI definido) no se pregunta nada.
add
ingot add rule <nombre> [--description <texto>]
ingot add habit <id> [--title <texto>] [--match <regex>] [--rule <texto>]
ingot add command <nombre> [--description <texto>]
ingot add mcp <id> --command <cmd> [--env NOMBRE=descripción]... [-- <args>...]
ingot add mcp <id> --url https://...
Los argumentos después de -- se pasan al comando del servidor MCP, para que opciones como -y le lleguen: ingot add mcp acme --command npx -- -y @acme/mcp.
try
ingot try <carpeta-del-proyecto> [--cwd <carpeta-de-la-extensión>]
Copia el paquete en <proyecto>/.ingot/extensions/<publisher>.<name>/, las reglas en .ingot/rules/, los comandos en .ingot/commands/ y añade los servidores MCP a .ingot/mcp.json. Vuelve a ejecutarlo después de cada cambio.
validate y package
ingot validate
ingot package [--out <archivo>]
Los dos ejecutan las comprobaciones de la tienda (campos del manifiesto, rutas, contenido de los archivos, patrones de Habits, JSON de temas, límites). package además escribe el .ingotx y muestra sus archivos y el SHA-256.
login, logout, whoami
ingot login [--token <token>] [--registry <url>]
ingot whoami
ingot logout
login comprueba el token con la tienda y lo guarda en ~/.ingot/cli/credentials.json (modo 600). Define INGOT_CLI_HOME para guardarlo en otro sitio. En CI, sáltate login y usa INGOT_PUBLISH_TOKEN.
publish
ingot publish [paquete.ingotx] [--token <token>] [--registry <url>] [--no-package]
Sin archivo, primero empaqueta la carpeta actual. --no-package sube el .ingotx que ingot package ya escribió para la versión actual (en CI se hace así para que el archivo subido sea el mismo que se generó y se guardó como artefacto).
unpublish
ingot unpublish [publisher.name[@versión]] [--version <x.y.z>] [--yes]
Sin id usa el ingot.json de la carpeta. Sin versión retira todas las versiones. Te pide escribir el nombre para confirmar; --yes es obligatorio cuando no se puede preguntar (CI).
version
ingot version # versión de la CLI y de la extensión
ingot version patch # o minor, major, o una versión exacta como 2.0.0-beta.1
Cambia version en ingot.json y añade un encabezado a CHANGELOG.md. Después haz commit, etiqueta y sube (git tag v1.2.3).
Reglas del proyecto
export y rules trabajan sobre .ingot/rules de un proyecto, no sobre una extensión. Ejecútalos en la carpeta del proyecto o pasa --cwd.
npx @ingotide/cli export --check # CI: falla si los archivos exportados se desvían
npx @ingotide/cli rules test --mock # CI: pruebas de reglas con el modelo simulado gratuito
npx @ingotide/cli rules prune # simulación; añade --apply para cambiar archivos
Todas las opciones están en Exportar reglas, Pruebas de reglas y Podar reglas obsoletas.
Imágenes
image notes envía una imagen a un modelo que lee imágenes, recibe notas numeradas (cuadros, flechas, chinchetas, texto) y escribe un SVG anotado junto a la imagen.
npx @ingotide/cli image notes screenshot.png --prompt "Is the header aligned?" # modelo por defecto, tope de $0.01
npx @ingotide/cli image notes screenshot.png --mock --json # CI: la respuesta simulada gratuita
Todas las opciones están en Notas en imágenes.
Revisión antes del commit
review ejecuta la revisión del agente del IDE sobre los cambios preparados (todos los cambios si no hay nada preparado), en un hook de git o en CI:
npx @ingotide/cli review --staged # hook pre-commit: sale con 1 ante un hallazgo grave
npx @ingotide/cli review --apply # escribe las correcciones sugeridas en los archivos
npx @ingotide/cli review --mode both # reglas del proyecto más las listas de la industria
npx @ingotide/cli review --find-issues # búsqueda de errores más profunda con los archivos completos
npx @ingotide/cli review --mock --json # revisor simulado gratuito y determinista para probar pipelines
Todas las opciones están en Revisión del agente antes del commit.
Tab
tab predict envía el mismo prompt que Tab envía en el editor (el código alrededor del punto de inserción y algunos archivos cercanos) e imprime la predicción. Los archivos que coinciden con .ingot/ignore nunca se leen.
npx @ingotide/cli tab predict src/app.ts --line 12 # modelo por defecto, tope de $0.01
npx @ingotide/cli tab predict src/app.ts --mock # CI: el modelo simulado gratuito
Todas las opciones están en Autocompletado con Tab.
Diff y merge
merge ejecuta la fusión inteligente del visor de diferencias sobre tres archivos: aplica a la base cada cambio que hizo solo un lado (o los dos de la misma forma) y deja cada conflicto con marcadores estilo diff3, o lo resuelve con --conflicts yours|theirs|both.
npx @ingotide/cli merge tuyo.ts base.ts suyo.ts # imprime el resultado; sale con 1 si quedan conflictos
npx @ingotide/cli merge tuyo.ts base.ts suyo.ts -o tuyo.ts --json # lo escribe e imprime {conflicts, merged, sameLine, chunks}
git config merge.ingot.driver "ingot merge %A %O %B --output %A" # úsalo como driver de merge de git
--label-yours y --label-theirs ponen los nombres tras <<<<<<< y >>>>>>> (por defecto, las rutas de los archivos).
Cuando los dos lados editaron la misma línea pero tokens distintos, la línea se fusiona token a token, como en el visor (sameLine en --json). --line-only fusiona solo líneas enteras, como git: cualquier línea que editaron los dos lados es un conflicto.
Contexto del chat
context muestra desde la terminal lo que adjunta el chat del agente. No se envía nada a ningún modelo y nada sale de tu equipo.
npx @ingotide/cli context files crt # src/cart.ts: el filtro aproximado del selector @
npx @ingotide/cli context attach src/cart.ts:1-2 docs @api-style # los bloques que envía el chat
npx @ingotide/cli context rules # Project rules y luego User rules
npx @ingotide/cli context compose "explain lines 20-21 of @src/cart.ts" # el prompt que envía el chat, chips en el orden escrito
npx @ingotide/cli context files helper --project other-app # un archivo de un proyecto reciente, ruta absoluta
Todas las opciones están en Arrastrar, pegar y @ archivos, @opens, @pins, reglas en / y /projects y Chips en línea en el chat.
Contexto compartido del proyecto
learnings trabaja con el contexto compartido del proyecto en .ingot/context/, un archivo Markdown por aprendizaje. add confirma un aprendizaje que ya existe en lugar de copiarlo y sustituye todo lo que parezca un secreto por [redacted]. list --status stale muestra los aprendizajes cuyas rutas ya no existen. check sale con 1 si hay nombres de archivo inválidos, temas o estados desconocidos o secretos, y avisa de aprendizajes caducados y casi duplicados. sync escribe el bloque de AGENTS.md para otros agentes de código; sync --check sale con 1 si no está al día.
npx @ingotide/cli learnings # propuestos primero, caducados marcados; --status, --topic, --json
npx @ingotide/cli learnings add "[test] Run e2e with npm run e2e (paths: e2e/)" --propose
npx @ingotide/cli learnings prompt "fix the users endpoint" --files src/api/users.ts # exactamente lo que recibe un agente
npx @ingotide/cli learnings outdated test-run-e2e-with-npm-run-e2e-k3f9 --reason "renamed to test:e2e"
npx @ingotide/cli learnings check && npx @ingotide/cli learnings sync --check # en CI
Agentes en la nube
handoff pasa una tarea a un agente en la nube de Ingot, que trabaja sobre el repositorio de GitHub y abre un pull request en borrador. Necesita un token de acceso personal (ingot_pat_…) en --token o INGOT_TOKEN:
ingot handoff send --prompt "Add CSV export to the reports page" --watch # sigue la ejecución hasta que abre su PR
ingot handoff send --plan plan.md --dry-run # muestra el brief, no envía nada
ingot handoff status <run> --json
ingot handoff checkout <run> # trae la rama de la ejecución y cambia a ella
Todas las opciones están en Traspaso a un agente en la nube.
Vista previa de la app
preview lista lo que ve la pestaña Vista previa de la app: primero los servidores de desarrollo locales con su framework y título, luego otras páginas web locales (nunca los puertos de Ingot ni apps de escritorio), y los tamaños de dispositivo. check dice si un puerto o URL responde y sale con 1 si no, así los scripts pueden esperar a un servidor de desarrollo:
ingot preview servers --dev # solo servidores de desarrollo; --exclude <puerto>, --json
ingot preview devices # tamaños y los ids que acepta --device
ingot preview check 5173 --wait 30 # espera hasta 30 s a que responda el servidor
ingot preview check localhost:3000/cart --device iphone-15-pro --json
Todas las opciones están en Vista previa de la app.
Vista previa en móvil
preview mobile lista lo que ve el panel Devices de la vista previa en móvil: simuladores de iOS arrancados, iPhones y iPads emparejados (xcrun devicectl), emuladores y teléfonos Android (adb), un servidor Metro o Expo en marcha y lo que falta con cómo instalarlo. open envía un puerto o URL a un dispositivo por id o nombre, con la dirección que ese dispositivo alcanza: localhost en simuladores, 10.0.2.2 en el emulador de Android y la dirección LAN en teléfonos. --app abre la app de React Native o Expo. preview qr imprime en la terminal un código QR de la dirección LAN:
ingot preview mobile --json # dispositivos por grupo, Metro y herramientas que faltan
ingot preview mobile open "iPhone 15 Pro" 5173 # un dispositivo por id o nombre, un puerto o URL; --lan <ip>
ingot preview mobile open emulator-5554 --app # Expo Go, una development build o la app instalada
ingot preview mobile connect 192.168.1.40:5555 # adb connect para Android por Wi-Fi
ingot preview qr 5173 --invert # QR de la dirección LAN; --expo para Expo Go, --metro <puerto>
Todas las opciones están en Vista previa en móvil.
Agentes
agents muestra todos los agentes por estado, como el Centro de mando de agentes en Ingot: los chats de cada ventana de Ingot abierta en este equipo y, con un token de acceso personal (ingot_pat_…) en --token o INGOT_TOKEN, tus ejecuciones de agentes en la nube:
ingot agents # todos los agentes por columna
ingot agents --status needs-you # aprobaciones, preguntas y ejecuciones en pausa
ingot agents --local --json
ingot agents cancel <cloud-run-id>
Todas las opciones están en Centro de mando de agentes.
Uso y bajo demanda
usage muestra las unidades de tokens de tu cuenta de Ingot, el uso por nivel de modelo, los minutos de Zaprex y el estado del uso bajo demanda, y cambia el uso bajo demanda y los límites por miembro del equipo. Necesita un token de acceso personal (ingot_pat_...) en --token o INGOT_TOKEN; el servidor es --server, luego INGOT_SERVER, luego https://www.ingotide.com.
npx @ingotide/cli usage # unidades restantes, por nivel, Zaprex, bajo demanda
npx @ingotide/cli usage on-demand on --cap 25 # bajo demanda con un límite de $25 al mes; off lo desactiva
npx @ingotide/cli usage cap dev@example.com none # quitar el límite de unidades de un miembro
Todas las opciones están en Uso y bajo demanda.
Automatizaciones
automations trabaja con las automatizaciones de .ingot/automations/. list, validate, new y test funcionan sin conexión; sync, run y fires usan tu cuenta de Ingot con el mismo token y servidor que usage. El repositorio es --repo, si no el remoto origin de esta carpeta.
npx @ingotide/cli automations validate # sale con 1 si un archivo tiene errores
npx @ingotide/cli automations new "Fix CI" --on ci_failure --prompt "Fix the build" --goal "CI passes" --check "npm test"
npx @ingotide/cli automations test --webhook '{"title":"Deploy failed"}' # qué automatizaciones se inician y por qué no
npx @ingotide/cli automations sync --secrets # sube los archivos run: cloud; muestra los secretos de los hooks
Agentes externos (ACP)
acp ejecuta los mismos agentes externos que el panel External Agents del IDE: los integrados, los de ~/.ingot/acp.json y los de .ingot/acp.json del proyecto. El agente solo lee y escribe archivos dentro de --cwd; los agentes integrados usan el proveedor configurado en el propio agente, y un agente que añades puede tomar su clave de API de su variable keyEnv.
npx @ingotide/cli acp agents # agentes integrados y propios, y cómo arranca cada uno
npx @ingotide/cli acp doctor goose --session # versión del protocolo, métodos de inicio de sesión, si abre una sesión
npx @ingotide/cli acp run opencode --prompt "Explica src/cart.ts" --deny # respuesta en stdout; plan y herramientas en stderr
npx @ingotide/cli acp run team-bot --file task.md --allow --json # un evento JSON por línea
npx @ingotide/cli acp add team-bot --command team-bot --args="--acp" --key-env TEAM_BOT_API_KEY [--global]
Sin --allow, --deny ni --read-only, run pregunta en una terminal y rechaza en CI y en pipes. --timeout <s> limita el arranque (120 s por defecto). Códigos de salida: 0 hecho, 1 falló, 2 uso, 3 rechazado, 4 detenido.
Arena
arena ejecuta batallas del modo Arena en la terminal. run envía una tarea a dos modelos elegidos al azar de --models (tres modelos baratos por defecto) y muestra las respuestas como Agente A y Agente B sin nombrar los modelos. Necesita OPENROUTER_API_KEY y se detiene antes de llamar si el coste en el peor caso supera --max-cost (por defecto $0.02, código de salida 3). vote <id> <a|b|tie|bad> guarda el voto y revela los modelos; leaderboard y votes leen el mismo .ingot/arena/votes.jsonl que escribe el IDE. --mock (o INGOT_ARENA_MOCK=1) da respuestas fijas sin red, para CI.
npx @ingotide/cli arena run "Write a debounce helper in TypeScript" # two hidden models answer
npx @ingotide/cli arena run "Explain this function" --with src/cart.ts --vote a
npx @ingotide/cli arena vote arena-mhj3k2ab-0a1b a # a, b, tie or bad
npx @ingotide/cli arena leaderboard # Elo table from .ingot/arena/votes.jsonl
npx @ingotide/cli arena run "Say hi" --mock # canned answers, no key or network (CI)
Extensions
extensions gestiona las extensiones de la tienda de Ingot desde la terminal. Hoy todas son gratuitas (precio 0, nivel free) y pasan por la misma comprobación de acceso que pasaría una de pago. install y uninstall aceptan el id de la ficha, el id de la extensión o el enlace ingot://install/extension/<id> de la tienda, y editan el settings.json de Ingot (--dir, si no THEIA_CONFIG_DIR, si no ~/.ingot), así que las ventanas abiertas recogen el cambio. Desinstalar el Agent Command Center lo desactiva, restablece sus ajustes y borra los archivos del tablero en agent-board/. suggestions on|off cambia Sugerir funciones en el chat; suggestions reset <id> recupera una sugerencia que cerraste con ×.
npx @ingotide/cli extensions list # id, price, tier, installed (--json for scripts)
npx @ingotide/cli extensions info agent-command-center
npx @ingotide/cli extensions install agent-command-center
npx @ingotide/cli extensions uninstall agent-command-center
npx @ingotide/cli extensions suggestions off # on | off | reset <id>
Paneles de sesiones
panes edita .ingot/panes.json, las sesiones que Session Panes abre lado a lado cuando pulsas Start en Ingot. Nunca llama a un modelo ni inicia un agente. add acepta un prompt opcional y --title, --model, --mode agent|ask|plan|debug, --tab chat|files|changes|terminal, --worktree e --id, y rechaza un noveno panel. remove acepta el número o el id de un panel. validate sale con 1 si el archivo tiene errores (JSON inválido, más de 8 paneles, ids inválidos o repetidos, modos o pestañas desconocidos); las claves desconocidas y los ids que faltan solo son avisos. Una edición nunca reescribe un archivo con errores.
npx @ingotide/cli panes # los paneles con un dibujo de la disposición; --json
npx @ingotide/cli panes add "Write tests for the cart" --tab changes --worktree
npx @ingotide/cli panes layout rows # grid, columns o rows
npx @ingotide/cli panes validate # en CI
npx @ingotide/cli panes grid 5 --layout columns # cómo se distribuyen 5 paneles, sin archivo
Diseño del agente
layout lee y escribe los siete ajustes ingot.agentLayout.* del diseño enfocado del agente en los archivos de ajustes normales, donde gana el último: ~/.ingot/ingot.settings.json (--global), ~/.ingot/settings.json (--user) y el .ingot/settings.json del proyecto (--project, el predeterminado de set y reset). Los ajustes aceptan el nombre corto (review) o la clave completa (ingot.agentLayout.review); los interruptores aceptan true/false u on/off. set y reset conservan los comentarios y el formato del archivo, y nunca reescriben un archivo que no sea JSON válido (sale con 1). Ingot aplica los cambios en vivo. Nunca llama a un modelo.
npx @ingotide/cli layout # cada ajuste, su valor y su archivo de origen; --json
npx @ingotide/cli layout set review editor # Review abre el editor Agent Review en este proyecto
npx @ingotide/cli layout set enabled off --user # el panel de chat clásico para ti
npx @ingotide/cli layout reset review # vuelve al valor de usuario, global o predeterminado
npx @ingotide/cli layout list --json # cada ajuste con sus valores, predeterminado y descripción
Sandbox del agente
sandbox muestra el sandbox del sistema operativo que el Sandbox del agente da a los comandos de los agentes en esta máquina y edita la lista de permitidos del proyecto en .ingot/policy.json. Nunca llama a un modelo ni ejecuta un agente. status (por defecto) dice si el sandbox funciona aquí y, en Linux sin bubblewrap, el comando que lo instala; --platform darwin|linux|win32 muestra lo que usaría otro sistema. allow y remove reciben command, host o path y un valor: los comandos van a commands.allow, los hosts a network.allow y las carpetas a sandbox.allowWrite. No reescriben un archivo con comentarios o con un error de JSON (el panel Agent Sandbox conserva los comentarios). wrap imprime la línea de comando que ejecuta Ingot, con --network allow|deny.
npx @ingotide/cli sandbox # this machine's sandbox and the project's settings; --json
npx @ingotide/cli sandbox status --platform linux # what Ingot would use on Linux (darwin, linux, win32)
npx @ingotide/cli sandbox list # the allow-list; --json
npx @ingotide/cli sandbox allow command "npm run lint" # also: host <host>, path <folder>
npx @ingotide/cli sandbox remove host registry.npmjs.org
npx @ingotide/cli sandbox wrap "npm test" --platform linux --network deny
Hosts de Git
git conecta los hosts que admite Hosts de Git y trabaja con ellos desde una terminal o un script. connect acepta gitlab, bitbucket-cloud, bitbucket-dc, azure-devops, gitea, forgejo, generic o una URL (detectada), con --url para servidores autoalojados, y luego --token (si no, INGOT_GIT_TOKEN; si no, lo pide) o --oauth --client-id <id>. Los tokens de API de Bitbucket Cloud también necesitan --user <e-mail de Atlassian>. Los comandos de repositorio usan el origin de la carpeta actual cuando está en un host conectado; si no, --repo propietario/nombre y --account. Las cuentas se comparten con la app de Ingot en ~/.ingot/git-hosts.json; la CLI guarda sus tokens en ~/.ingot/cli/git-hosts-credentials.json (modo 600). Los tokens nunca se imprimen, tampoco en los errores.
npx @ingotide/cli git hosts # hosts compatibles, páginas de tokens y permisos
npx @ingotide/cli git connect gitlab --token "$GITLAB_TOKEN" # o define INGOT_GIT_TOKEN
npx @ingotide/cli git connect https://git.example.com # detecta el host y pide un token
npx @ingotide/cli git connect gitlab --oauth --client-id <id> # OAuth con PKCE en tu navegador
npx @ingotide/cli git prs --state open # el origin del clon; si no, --repo y --account
npx @ingotide/cli git pr create --title "Fix VAT" --source vat --draft
npx @ingotide/cli git ci --ref main # ejecuciones de CI recientes
npx @ingotide/cli git mcp --read-only # el servidor MCP git-hosts por stdio
git mcp sirve las herramientas git-hosts (cuentas, repositorios, ramas, pull requests, issues, CI y la creación de pull requests e issues salvo con --read-only) a cualquier cliente MCP por stdio: { "git-hosts": { "command": "ingot", "args": ["git", "mcp"] } }.
Servidores MCP
mcp trabaja con los servidores MCP de ~/.ingot/mcp.json y del .ingot/mcp.json del proyecto, los mismos archivos que lee Ingot (un servidor del proyecto gana a uno global con el mismo nombre). Los servidores remotos usan Streamable HTTP (MCP 2025-11-25) e inician sesión con login: el flujo OAuth de Ingot con descubrimiento, registro dinámico del cliente (o --client-id, --client-secret, --scopes, si no el auth del servidor en mcp.json), PKCE y una redirección local a 127.0.0.1. Los servidores locales se ejecutan por stdio. check se conecta, lista las herramientas y hace ping (--count, hasta 20) e imprime Healthy, Slow, Degraded, Down o Sign-in required; sale con 1 cuando un servidor está caído, degradado o necesita iniciar sesión, así que sirve en CI. call ejecuta una herramienta con --args (un objeto JSON); las herramientas que el servidor marca como destructivas necesitan --yes. Los valores ${keychain} de mcp.json se leen de la variable de entorno con el mismo nombre, y un CLIENT_SECRET del llavero de INGOT_MCP_CLIENT_SECRET. Los tokens se guardan en ~/.ingot/cli/mcp-credentials.json (modo 600), aparte de los de Ingot, y nunca se imprimen. Consulta MCP remoto, OAuth y salud.
npx @ingotide/cli mcp list # servers, transport, signed in or not; --json
npx @ingotide/cli mcp login linear # OAuth with PKCE in your browser
npx @ingotide/cli mcp check --count 3 # health of every server; exit 1 if one is down
npx @ingotide/cli mcp tools linear # tools with read-only / write / destructive
npx @ingotide/cli mcp call linear list_issues --args '{"state":"open"}'
npx @ingotide/cli mcp call tracker delete_issue --args '{"id":"ENG-2"}' --yes
npx @ingotide/cli mcp logout linear
Búsqueda en el Marketplace
extensions (forma corta ext) ejecuta la Búsqueda en el Marketplace en la terminal. search pregunta a la Ingot Store y a Open VSX en paralelo e imprime una sola lista, sin duplicados por id, con las fuentes que tienen cada resultado; una fuente que falla se indica y las demás siguen apareciendo. --source ingot,open-vsx elige las fuentes; --limit (hasta 50) y --json son opcionales. El Microsoft Marketplace solo se consulta con --microsoft-marketplace, porque los términos de Microsoft permiten sus extensiones solo en productos de Microsoft; la CLI muestra esa nota al usarlo. install recibe un id (descarga el .vsix de la primera fuente que lo tenga, --source para elegir) o un .vsix local, comprueba que su extension/package.json coincida y lo copia a la carpeta de extensiones de Ingot (--dir, si no INGOT_EXTENSIONS_DIR, si no $THEIA_CONFIG_DIR/extensions, si no ~/.ingot/extensions); Ingot lo instala en el siguiente arranque. Un archivo existente se conserva salvo con --force. inspect muestra el id, la versión y el rango de engine de un .vsix sin instalarlo. Códigos de salida: 0, 1 si no se encontró nada o falló una comprobación, 2 para errores de uso.
El Chrome guard también se aplica aquí: las extensiones que reemplazarían el marco de la ventana de Ingot aparecen como blocked: en la búsqueda y install nunca las guarda (código de salida 1); una que solo cambia valores por defecto del marco se guarda con un aviso, e inspect muestra Shell guard: ok, blocked o warning. inspect también ejecuta la protección de extensiones que Ingot aplica antes de iniciar una extensión, con sus listas integradas: Extension guard: ok, o not started in Ingot con el motivo y la alternativa de Ingot, para que quien publica una extensión (un paquete de lenguaje COBOL, por ejemplo) pueda comprobar un .vsix antes de publicarlo.
npx @ingotide/cli extensions search prettier # Ingot Store + Open VSX, una lista
npx @ingotide/cli extensions search prettier --microsoft-marketplace --json
npx @ingotide/cli extensions install rust-lang.rust-analyzer # el .vsix a la carpeta de extensiones de Ingot
npx @ingotide/cli extensions install ./my-tool-1.0.0.vsix --force # un archivo local, reemplazando una copia anterior
npx @ingotide/cli extensions inspect ./my-tool-1.0.0.vsix # id, versión y engine, sin instalar
npx @ingotide/cli extensions sources # cada fuente, su URL y si está activa
Hábitos
habits trabaja sobre Hábitos, la carpeta de conocimiento por tipo .ingot/habits/: un archivo Markdown por tipo de arreglo con conocimiento duradero, una viñeta por entrada. init crea los archivos de tipo por defecto que falten y nunca sobrescribe. add clasifica el conocimiento como el IDE (el nombre del tipo 2 puntos, cada keyword 1, general si nada encaja) o usa --type, crea el archivo si falta y omite una entrada que ya existe. relevant muestra qué archivos de tipo lee el agente para una tarea y el texto exacto que recibe. new <tipo> <nombre> escribe los mismos archivos que escribe Ingot: new type i18n es un archivo de tipo nuevo (como new-type), new playbook <nombre> un playbook (--when y --step); un new <nombre> sin más es un playbook, como antes. Los playbooks de escenario (archivos con when/steps) mantienen show, new, validate, match, prompt y remove. Nunca llama a un modelo.
npx @ingotide/cli habits init # bug.md, defect.md, … general.md
npx @ingotide/cli habits add "Always add a regression test before fixing a crash" # → bug.md
npx @ingotide/cli habits classify "Never log access tokens" # → security.md, y por qué
npx @ingotide/cli habits relevant "the checkout crashes on an empty cart"
npx @ingotide/cli habits new-type i18n --keyword locale # tu propio archivo de tipo
npx @ingotide/cli habits new type i18n --keyword locale # lo mismo, como new <tipo> <nombre>
npx @ingotide/cli habits new playbook Release --when "Shipping a version" --step "Tag it"
npx @ingotide/cli habits show Release # disparador y pasos de un playbook
npx @ingotide/cli habits types --json
Tokens y registro
El token se toma, por orden, de: --token, la variable de entorno INGOT_PUBLISH_TOKEN y el token guardado por ingot login para ese registro.
El registro es --registry, luego INGOT_REGISTRY, luego https://www.ingotide.com. Los registros deben usar https://; http:// solo se permite para localhost (para probar con un portal local).
| Variable | Para qué |
|---|---|
INGOT_PUBLISH_TOKEN | el token de publicación (CI) |
INGOT_REGISTRY | otra tienda, por ejemplo http://localhost:3000 |
INGOT_CLI_HOME | dónde guarda login las credenciales (por defecto ~/.ingot/cli) |
Códigos de salida y errores
| Código | Significado |
|---|---|
0 | correcto |
1 | el comando falló (errores de validación, la tienda rechazó la subida, error de red), o merge dejó marcadores de conflicto |
2 | uso incorrecto (comando u opción desconocidos, falta un argumento) |
3 | rules test omitió una prueba, o review, tab predict o image notes no llamaron al modelo, por el tope de coste; o la ejecución del agente en la nube que siguió handoff --watch no terminó bien |
Cuando la tienda rechaza una petición, la CLI muestra el código de error y qué hacer:
| Error | Qué hacer |
|---|---|
invalid_token | el token no existe o fue revocado: crea uno nuevo y vuelve a hacer ingot login |
token_expired | crea un token nuevo |
publisher_mismatch | publisher en ingot.json debe ser tu identificador |
version_exists, version_not_newer | ingot version patch y vuelve a publicar |
invalid_manifest, invalid_contents | corrige los campos o archivos de la lista (ingot validate muestra la misma lista) |
package_too_large | quita de files lo que no necesitas |
rate_limited | más de 30 subidas en una hora: espera y reintenta |
publishing_unavailable | la tienda no acepta subidas ahora mismo |