> For the complete documentation index, see [llms.txt](https://kiwi-8.gitbook.io/kiwi-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kiwi-8.gitbook.io/kiwi-docs/comandos-del-cli.md).

# Comandos del CLI

```
kiwi [flags]
kiwi [comando]
```

Sin argumentos abre la interfaz interactiva. Con un subcomando hace una cosa concreta y sale.

## Flags globales

| Flag                     | Qué hace                                             |
| ------------------------ | ---------------------------------------------------- |
| `-c`, `--continue`       | continúa la sesión más reciente de este proyecto     |
| `--resume <id>`          | retoma una sesión concreta (ver `kiwi session list`) |
| `--cwd <ruta>`           | directorio de trabajo (por defecto, el actual)       |
| `-m`, `--model <perfil>` | perfil de modelo a usar                              |
| `--mode <modo>`          | modo de arranque: `ask`, `plan` o `work`             |
| `-v`, `--version`        | versión                                              |

## `kiwi ask`

Un turno sin interfaz, pensado para scripts y tuberías. Tiene su propia página: [kiwi ask en scripts](/kiwi-docs/kiwi-ask-en-scripts.md).

## `kiwi session list`

Lista las conversaciones guardadas de este proyecto, con sus identificadores. El id que devuelve es lo que espera `--resume`.

```sh
kiwi session list
kiwi --resume 3f2a1c
```

## `kiwi doctor`

Dice qué formas de llegar a internet tienen los agentes en tu máquina: páginas web, búsqueda, YouTube, GitHub, RSS y servidores MCP. Para cada una indica si funciona, qué usa y cómo activarla o mejorarla. **Solo mira: no instala nada.**

```
$ kiwi doctor
✓ Web pages    web_fetch; reader: true for JavaScript pages (Jina Reader)
✓ Web search   web_search via DuckDuckGo (no key) — set EXA_API_KEY or JINA_API_KEY with /config for better results
✗ YouTube      brew install yt-dlp
✓ GitHub       gh (signed in)
✓ RSS / Atom   web_fetch
✓ Reddit, X    web_fetch (.json or reader: true); best effort
✗ MCP servers  none configured; add one with /mcp
```

Dentro de la interfaz, `/doctor` enseña lo mismo. Ver [Herramientas](/kiwi-docs/herramientas.md#fuera-de-tu-maquina).

## `kiwi update`

Actualiza Kiwi a la última release. Descarga la build de tu plataforma, **verifica el SHA256** contra los checksums publicados y reemplaza el binario en marcha.

```sh
kiwi update
kiwi update --check   # solo dice si hay algo más nuevo, no instala
```

Si instalaste Kiwi con un gestor de paquetes, el binario es suyo: en ese caso `update` no lo sobrescribe a sus espaldas, sino que te imprime el comando de actualización que corresponde (`brew upgrade`, `scoop update`…).

El reemplazo es seguro en las dos plataformas. En Unix es un `rename` atómico, así que la sesión desde la que lanzaste el comando sigue viva con el binario anterior. En Windows el `.exe` viejo se aparta y se borra al siguiente arranque, porque el sistema no deja eliminar un ejecutable en uso.

Para desactivar el aviso automático de versión nueva:

```sh
export KIWI_NO_UPDATE_CHECK=1
```

## `kiwi completion`

Genera el script de autocompletado para tu shell. `kiwi completion --help` explica dónde ponerlo en cada una.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://kiwi-8.gitbook.io/kiwi-docs/comandos-del-cli.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.