> ## 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

> Agent-native Helfer für StackKits-Automatisierung

Agent-native Helfer für StackKits-Automatisierung.

Agent-native Helfer geben Installationspläne, Selbstchecks, Prompts und MCP-Konfiguration aus, ohne einen Rollout zu verändern.

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

Unterbefehle: [`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

Eine stabile Fehler-ID und ihre Wiederherstellungsaktion erklären.

Liest dieselben Wiederherstellungshinweise, die auch CLI-Fehlschläge, der MCP-Self-Check-Plan und docs/TROUBLESHOOTING.md verwenden. Diese Abfrage beobachtet oder verändert den Host nicht.

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

| Flag | Typ | Standard | Beschreibung |
| - | - | - | - |
| `--json` | bool | — | Den gemeinsamen Wiederherstellungsvertrag als JSON ausgeben; dies ist eine Anleitung, kein beobachteter Fehler |

## stackkit agent install-plan

Einen nicht-interaktiven StackKits-Installationsplan ausgeben.

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

| Flag | Typ | Standard | Beschreibung |
| - | - | - | - |
| `--dir` | string | `my-homelab` | Workspace-Verzeichnis |
| `--json` | bool | — | JSON ausgeben |
| `--kit` | string | `basement-kit` | StackKit, für das geplant wird |
| `--target` | string | `local` | Zieltyp: local, ssh, vm oder ci |

**Beispiele**

```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

Eine StackKits-MCP-Client-Verbindungskonfiguration ausgeben.

Eine sofort einfügbare MCP-Client-Konfiguration mit dem Namen "stackkit" ausgeben.

Für Nutzer ist das eine einzige StackKits-MCP-Verbindung. Lokal startet sie den stackkit-mcp-Adapter; nach der Installation ist derselbe Connector auch als stackkit-server /mcp erreichbar, wenn ein geschützter Endpunkt ausdrücklich aktiviert wird.

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

| Flag | Typ | Standard | Beschreibung |
| - | - | - | - |
| `--client` | string | `generic` | Client-Format: generic, codex oder claude |
| `--mode` | string | `docs,local,server,actions` | MCP-Modi; actions fügt die schreibgeschützten Lifecycle-Tools hinzu, und Schreib-Tools benötigen weiterhin STACKKIT\_MCP\_ALLOW\_WRITE=true |
| `--server-url` | string | `http://localhost:8082` | stackkit-server-URL |

**Beispiele**

```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

Einen kopierfertigen StackKits-Agent-Prompt ausgeben.

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

| Flag | Typ | Standard | Beschreibung |
| - | - | - | - |
| `--json` | bool | — | JSON ausgeben |
| `--list` | bool | — | Verfügbare Prompt-Szenarien auflisten |

**Beispiele**

```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

Lokale, für Agents relevante StackKits-Voraussetzungen prüfen.

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

| Flag | Typ | Standard | Beschreibung |
| - | - | - | - |
| `--json` | bool | — | JSON ausgeben |
| `--server-url` | string | `http://localhost:8082` | stackkit-server-URL |

**Beispiele**

```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.