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

ComandoQué 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 validateComprueba ingot.json y cada archivo al que apunta, como la tienda
ingot packageEscribe <publisher>.<name>-<version>.ingotx
ingot loginComprueba un token de publicación y lo guarda
ingot logoutOlvida el token guardado
ingot whoamiMuestra 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 exportEscribe .ingot/rules en AGENTS.md, CLAUDE.md, .cursor/rules, .windsurf/rules y las instrucciones de Copilot; --check para CI
ingot rules testEjecuta .ingot/tests/*.yaml contra tus reglas con un modelo barato y un tope de coste estricto
ingot rules pruneLista las reglas obsoletas (sin uso, globs muertos, rutas borradas, paquetes eliminados); --apply las quita
ingot reviewRevisió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|projectsLo 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 learningsContexto 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 sendEnví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|checkLa 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 qrVista 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 usageUnidades 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 agentsEl 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 automationsAgentes 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 acpAgentes 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 arenaEl 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 extensionsExtensiones 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 panesSession 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 layoutDiseñ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 sandboxAgent 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 gitHosts 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 mcpServidores 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|sourcesBú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 habitsHá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ónPor defectoNotas
--typese preguntael tipo de extensión
--nameel nombre de la carpetapalabras en minúsculas unidas con -
--publisherse preguntatu identificador de publicador
--display-namea partir del nombreel nombre en la tienda
--descriptionsegún el tipouna línea para la tarjeta de la tienda
--licenseMITun id SPDX; se escribe un archivo LICENSE MIT
--cigithubgithub (.github/workflows/ingot-publish.yml), gitlab (.gitlab-ci.yml) o none
--forceescribe en una carpeta que no está vacía
-y, --yesno 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).

VariablePara qué
INGOT_PUBLISH_TOKENel token de publicación (CI)
INGOT_REGISTRYotra tienda, por ejemplo http://localhost:3000
INGOT_CLI_HOMEdónde guarda login las credenciales (por defecto ~/.ingot/cli)

Códigos de salida y errores

CódigoSignificado
0correcto
1el comando falló (errores de validación, la tienda rechazó la subida, error de red), o merge dejó marcadores de conflicto
2uso incorrecto (comando u opción desconocidos, falta un argumento)
3rules 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:

ErrorQué hacer
invalid_tokenel token no existe o fue revocado: crea uno nuevo y vuelve a hacer ingot login
token_expiredcrea un token nuevo
publisher_mismatchpublisher en ingot.json debe ser tu identificador
version_exists, version_not_neweringot version patch y vuelve a publicar
invalid_manifest, invalid_contentscorrige los campos o archivos de la lista (ingot validate muestra la misma lista)
package_too_largequita de files lo que no necesitas
rate_limitedmás de 30 subidas en una hora: espera y reintenta
publishing_unavailablela tienda no acepta subidas ahora mismo