Beta Próximamente. Esta función aún está en desarrollo; los nombres y detalles pueden cambiar antes del lanzamiento.

Hosts de Git

Conecta GitLab, Bitbucket, Azure DevOps, Gitea o Forgejo a Ingot y da a los agentes un único conjunto de herramientas para repositorios, pull requests, issues y CI.

Beta Hosts de Git es una función opcional y está desactivada hasta que la actives. Funciona con servidores en la nube y autoalojados: GitLab.com y GitLab Self-Managed o Dedicated, Bitbucket Cloud y Bitbucket Data Center (o Server), Azure DevOps Services y Azure DevOps Server, Gitea, Forgejo y Codeberg, además de cualquier otra URL autoalojada, donde Ingot averigua qué host corre allí. Inicia sesión con un token de acceso o con OAuth. GitHub mantiene su propia integración en Git.

El panel Git Hosts de Ingot: una cuenta de GitLab conectada, el repositorio del proyecto y sus merge requests abiertos con ramas, autores y fechasEl panel Git Hosts de Ingot: una cuenta de GitLab conectada, el repositorio del proyecto y sus merge requests abiertos con ramas, autores y fechas
El panel Git Hosts de Ingot: una cuenta de GitLab conectada, el repositorio del proyecto y sus merge requests abiertos con ramas, autores y fechas

Actívalo

Hosts de Git se encuentra de tres formas, como toda función opcional:

  • Una sugerencia en el chat. Cuando mencionas GitLab, merge requests, Bitbucket, Azure DevOps, Gitea o Forgejo, o preguntas por pull requests, issues o CI mientras el origin del proyecto está en uno de esos hosts, una tarjeta pequeña sobre el cuadro del chat ofrece Enable Git Hosts. × la oculta para siempre.
  • Settings › Features › Git Hosts. Un interruptor. Desactivarlo oculta el panel y quita las herramientas a los agentes; tus cuentas siguen conectadas.
  • El botón Git Hosts de la barra de estado. Un clic activa Hosts de Git y abre el panel. Cuando está activo, el botón muestra u oculta el panel. El atajo es ⌥⇧⌘\ en macOS y Ctrl+Alt+Shift+\ en Windows y Linux.
La tarjeta de sugerencia de Git Hosts sobre el cuadro del chat de Ingot, con Enable Git Hosts y un botón para cerrarLa tarjeta de sugerencia de Git Hosts sobre el cuadro del chat de Ingot, con Enable Git Hosts y un botón para cerrar
La tarjeta de sugerencia de Git Hosts sobre el cuadro del chat de Ingot, con Enable Git Hosts y un botón para cerrar
El botón Git Hosts en la barra de estado de Ingot, con el panel Git Hosts abiertoEl botón Git Hosts en la barra de estado de Ingot, con el panel Git Hosts abierto
El botón Git Hosts en la barra de estado de Ingot, con el panel Git Hosts abierto
Ajustes de Ingot, página Features: Suggest features in chat, Session Panes y el interruptor de Git HostsAjustes de Ingot, página Features: Suggest features in chat, Session Panes y el interruptor de Git Hosts
Ajustes de Ingot, página Features: Suggest features in chat, Session Panes y el interruptor de Git Hosts

Conecta un host

Haz clic en Connect… en el panel (o ejecuta Git Hosts: Connect GitLab, Bitbucket, Azure DevOps, Gitea or Forgejo… desde Find Action). Elige el host, revisa la URL base, elige cómo iniciar sesión y haz clic en Connect.

HostURL baseNotas
GitLabhttps://gitlab.com o tu URL de GitLabLos pull requests son merge requests; las ejecuciones de CI son pipelines
Bitbucket Cloudhttps://bitbucket.orgInicia sesión con un token de API de Atlassian y tu e-mail de Atlassian como usuario, o con OAuth
Bitbucket Data Centerhttps://bitbucket.example.comTambién Bitbucket Server. Los repositorios son PROYECTO/repo; el CI son estados de build; Data Center no tiene issues
Azure DevOpshttps://dev.azure.com/<organización> o https://tfs.example.com/<colección>Los repositorios son proyecto/repo; los issues son work items; el CI son builds de Azure Pipelines
Giteahttps://gitea.example.comEl CI son Gitea Actions o estados de commit
Forgejohttps://codeberg.org o tu URL de ForgejoIgual que Gitea
Otro autoalojadocualquier URLDetect pregunta al servidor y elige GitLab, Bitbucket Data Center, Azure DevOps Server, Gitea o Forgejo
El formulario Connect de Git Hosts: selector de host con GitLab, Bitbucket Cloud y Data Center, Azure DevOps, Gitea, Forgejo y Other self-hosted, URL base, token de acceso y nombreEl formulario Connect de Git Hosts: selector de host con GitLab, Bitbucket Cloud y Data Center, Azure DevOps, Gitea, Forgejo y Other self-hosted, URL base, token de acceso y nombre
El formulario Connect de Git Hosts: selector de host con GitLab, Bitbucket Cloud y Data Center, Azure DevOps, Gitea, Forgejo y Other self-hosted, URL base, token de acceso y nombre

Con un token de acceso

Pega un token de acceso personal. El formulario muestra los permisos que necesita el token y un enlace Create a token a la página de tokens del host:

HostPermisos del token
GitLabapi (o read_api si los agentes solo leen)
Bitbucket Cloudread:repository, read:pullrequest, write:pullrequest, read:issue, write:issue, read:pipeline
Bitbucket Data CenterEscritura de repositorio (token de acceso HTTP)
Azure DevOpsCode (Read & write), Work Items (Read & write), Build (Read)
Gitea y Forgejorepository, issue y user (lectura y escritura)

Ingot comprueba el token preguntando al host quién eres y luego guarda la cuenta. Un token que el host rechaza nunca se muestra en el error.

Con OAuth

Registra una aplicación OAuth en el host con la URI de redirección http://127.0.0.1:<cualquier puerto>/callback (Ingot elige un puerto libre en cada inicio de sesión, como describe RFC 8252 para apps de escritorio). Elige OAuth, escribe su client ID (y el client secret solo si el host creó una app confidencial) y haz clic en Sign in with browser. La página de consentimiento del host se abre en tu navegador; cuando apruebas, el host devuelve el navegador a Ingot y la cuenta queda conectada. Ingot usa PKCE, así que las apps públicas no necesitan secreto, y renueva el token antes de que caduque.

Custom endpoints and scopes permite fijar la URL de autorización, la URL del token y los permisos cuando tu servidor usa otros. Por defecto se usan los endpoints OAuth estándar del host, por ejemplo /oauth/authorize y /oauth/token en GitLab con los permisos api read_user, y Microsoft Entra ID para Azure DevOps.

El formulario Connect de Git Hosts en modo OAuth: client ID, client secret opcional y la URI de redirección que hay que registrar en el hostEl formulario Connect de Git Hosts en modo OAuth: client ID, client secret opcional y la URI de redirección que hay que registrar en el host
El formulario Connect de Git Hosts en modo OAuth: client ID, client secret opcional y la URI de redirección que hay que registrar en el host

Dónde se guardan las cuentas y los tokens

La cuenta (host, URL base, usuario, forma de inicio de sesión) va a ~/.ingot/git-hosts.json, que también lee la CLI de ingot. Los tokens nunca van ahí: Ingot los guarda en su archivo de claves, ~/.ingot/keystore.json, que solo tu usuario puede leer. Disconnect borra ambos.

Explora un repositorio

A la izquierda están tus cuentas y los repositorios de la cuenta elegida (escribe en el filtro y pulsa Enter para buscar en el host). Cuando el remoto origin del proyecto está en un host conectado, su repositorio se abre solo. Las pestañas muestran:

PestañaQué muestra
Pull requestsNúmero, título, rama origen → destino, autor y última actualización. Open, Merged, Closed o All
IssuesNúmero, título, tipo, etiquetas y autor (work items de Azure DevOps). Open, Closed o All
BranchesTodas las ramas, con la predeterminada marcada y su commit
CIEjecuciones recientes: pipelines de GitLab, Bitbucket Pipelines o estados de build, builds de Azure Pipelines, Actions de Gitea y Forgejo o estados de commit, con su estado

Haz clic en una fila para abrirla en el host. El botón de pulso junto a una cuenta comprueba que sigue funcionando (Test connection); el botón del enchufe la desconecta.

La pestaña CI del panel Git Hosts: un pipeline de merge request fallido, uno de push correcto y otro en curso, con ramas y commitsLa pestaña CI del panel Git Hosts: un pipeline de merge request fallido, uno de push correcto y otro en curso, con ramas y commits
La pestaña CI del panel Git Hosts: un pipeline de merge request fallido, uno de push correcto y otro en curso, con ramas y commits

Las PR abiertas tienen un botón Follow: Ingot vigila la CI y los comentarios de revisión de la PR y hace que el agente arregle lo que falla, con tu aprobación para cada push y cada respuesta. Ver Seguir la PR hasta verde.

Qué obtienen los agentes

Mientras Hosts de Git está activo, los agentes reciben el servidor MCP integrado git-hosts: un conjunto de herramientas que funciona igual en todos los hosts conectados. Aparece en Rules, Commands & MCP Servers con la etiqueta Built-in, donde puedes desactivar herramientas sueltas; no tiene comando ni archivo propio, así que no hay nada que editar ni quitar. Las lecturas piden aprobación como cualquier herramienta MCP hasta que eliges Always Run.

HerramientaQué hace
list_accountsLas cuentas conectadas
list_reposRepositorios de una cuenta, con búsqueda opcional
list_branchesRamas de un repositorio
list_pull_requestsPull requests (merge requests), por estado
get_pull_requestUn pull request con su descripción
create_pull_requestAbre un pull request: título, origen, destino (la rama predeterminada si falta), descripción, borrador
list_issuesIssues o work items, por estado
create_issueCrea un issue o work item
list_ci_runsEjecuciones de CI recientes, opcionalmente de una rama

Todas las herramientas aceptan account y repo; ambos son opcionales cuando el origin del proyecto está en un host conectado. Read-only for agents en los ajustes deja fuera create_pull_request y create_issue. Los errores del host llegan al agente sin ningún token.

Teclado

AcciónFind ActionAtajo (macOS / Windows y Linux)
Mostrar u ocultar Git HostsGit Hosts: Show / Hide⌥⇧⌘\ / Ctrl+Alt+Shift+\
Activar y abrirGit Hosts: Open
Conectar un hostGit Hosts: Connect GitLab, Bitbucket, Azure DevOps, Gitea or Forgejo…
ActualizarGit Hosts: Refresh

Ajustes

Settings › Tools › Git Hosts:

AjustePredeterminadoQué hace
Give agents the Git hosts tools (ingot.gitHosts.agentTools)trueOfrece el servidor MCP integrado git-hosts a los agentes mientras Hosts de Git está activo
Read-only for agents (ingot.gitHosts.readOnly)falseDeja fuera las herramientas que abren pull requests y crean issues

Settings › Features:

AjustePredeterminadoQué hace
Git Hosts (ingot.gitHosts.enabled)falseMuestra el panel Git Hosts y da sus herramientas a los agentes; las cuentas siguen conectadas cuando está desactivado
Suggest features in chat (ingot.suggestions.enabled)trueMuestra las tarjetas de sugerencia sobre el cuadro del chat, para todas las funciones opcionales
Ajustes de Ingot, Tools › Git Hosts: Give agents the Git hosts tools, Read-only for agents y Open Git HostsAjustes de Ingot, Tools › Git Hosts: Give agents the Git hosts tools, Read-only for agents y Open Git Hosts
Ajustes de Ingot, Tools › Git Hosts: Give agents the Git hosts tools, Read-only for agents y Open Git Hosts

Desde la terminal

ingot git hace lo mismo desde una terminal o un script, con el mismo archivo de cuentas. Guarda sus propios tokens en ~/.ingot/cli/git-hosts-credentials.json (modo 600), así que conecta una vez en cada sitio.

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                        # pull requests del origin del clon
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

ingot git mcp sirve las mismas herramientas git-hosts a cualquier cliente MCP: añade { "git-hosts": { "command": "ingot", "args": ["git", "mcp"] } } a su mcp.json. Todos los comandos están en la página de la CLI.

Preguntas frecuentes

¿Ingot envía mi código al host? No. Hosts de Git solo llama a la API del host para repositorios, ramas, pull requests, issues y CI, con tu token, desde tu ordenador.

¿Puedo conectar dos cuentas en el mismo host? Una cuenta por host y URL base. Conectar de nuevo (por ejemplo con OAuth en vez de un token) sustituye el inicio de sesión de esa cuenta.

¿Por qué el agente no ve las herramientas? Hosts de Git debe estar activo, Give agents the Git hosts tools debe estar activo y el servidor git-hosts debe estar activo en Rules, Commands & MCP Servers.