> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kombify.io/llms.txt
> Use this file to discover all available pages before exploring further.

# stackkit agent

> Ayudantes nativos para agentes en la automatización de StackKits

Ayudantes nativos para agentes en la automatización de StackKits.

Los ayudantes nativos para agentes emiten planes de instalación, autocomprobaciones, prompts y configuración de MCP sin modificar un despliegue.

```bash theme={null}
stackkit agent [flags]
```

Subcomandos: [`stackkit agent diagnose`](#stackkit-agent-diagnose), [`stackkit agent install-plan`](#stackkit-agent-install-plan), [`stackkit agent mcp-config`](#stackkit-agent-mcp-config), [`stackkit agent prompt`](#stackkit-agent-prompt), [`stackkit agent self-check`](#stackkit-agent-self-check)

## stackkit agent diagnose

Explica un ID de error estable y su acción de recuperación.

Lee la misma guía de recuperación que usan los fallos de la CLI, el autocheck del MCP y docs/TROUBLESHOOTING.md. Esta consulta no observa ni cambia el host.

```bash theme={null}
stackkit agent diagnose <error-id> [flags]
```

| Flag | Tipo | Predeterminado | Descripción |
| - | - | - | - |
| `--json` | bool | — | Emite el contrato de recuperación compartido como JSON; es una guía, no un fallo observado |

## stackkit agent install-plan

Imprime un plan de instalación de StackKits no interactivo.

```bash theme={null}
stackkit agent install-plan [flags]
```

| Flag | Tipo | Predeterminado | Descripción |
| - | - | - | - |
| `--dir` | string | `my-homelab` | Directorio del workspace |
| `--json` | bool | — | Emite JSON |
| `--kit` | string | `basement-kit` | StackKit para el que se planifica |
| `--target` | string | `local` | Tipo de destino: local, ssh, vm o ci |

**Ejemplos**

```bash theme={null}
# Print the install steps for a Basement Kit workspace named my-homelab
stackkit agent install-plan

# A Cloud Kit plan for an agent working over SSH, as JSON
stackkit agent install-plan --kit cloud-kit --target ssh --dir my-cloud --json
```

## stackkit agent mcp-config

Imprime una configuración de conexión de cliente MCP de StackKits.

Imprime una configuración de cliente MCP lista para pegar, llamada "stackkit".

Para los usuarios es una sola conexión MCP de StackKits. En local inicia el adaptador stackkit-mcp; tras la instalación, el mismo conector también puede alcanzarse como stackkit-server /mcp cuando se habilita explícitamente un endpoint protegido.

```bash theme={null}
stackkit agent mcp-config [flags]
```

| Flag | Tipo | Predeterminado | Descripción |
| - | - | - | - |
| `--client` | string | `generic` | Formato de cliente: generic, codex o claude |
| `--mode` | string | `docs,local,server,actions` | Modos de MCP; actions añade las herramientas de ciclo de vida de solo lectura, y las herramientas de escritura siguen requiriendo STACKKIT\_MCP\_ALLOW\_WRITE=true |
| `--server-url` | string | `http://localhost:8082` | URL de stackkit-server |

**Ejemplos**

```bash theme={null}
# Print the connection as Claude mcpServers JSON
stackkit agent mcp-config --client claude

# Print the Codex config.toml block
stackkit agent mcp-config --client codex
```

## stackkit agent prompt

Imprime un prompt de agente de StackKits listo para copiar.

```bash theme={null}
stackkit agent prompt [scenario] [flags]
```

| Flag | Tipo | Predeterminado | Descripción |
| - | - | - | - |
| `--json` | bool | — | Emite JSON |
| `--list` | bool | — | Lista los escenarios de prompt disponibles |

**Ejemplos**

```bash theme={null}
# List the available prompt scenarios
stackkit agent prompt --list

# Print the prompt for diagnosing a failed rollout
stackkit agent prompt diagnose-failed-rollout
```

## stackkit agent self-check

Comprueba los requisitos locales de StackKits orientados a agentes.

```bash theme={null}
stackkit agent self-check [flags]
```

| Flag | Tipo | Predeterminado | Descripción |
| - | - | - | - |
| `--json` | bool | — | Emite JSON |
| `--server-url` | string | `http://localhost:8082` | URL de stackkit-server |

**Ejemplos**

```bash theme={null}
# Check that stackkit, stackkit-server, and stackkit-mcp are on PATH
stackkit agent self-check

# The same checks as JSON
stackkit agent self-check --json
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.