> 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/que-es-kiwi.md).

# Qué es Kiwi

Kiwi es un agente de código para la terminal. Le describes lo que quieres, lee tu proyecto, propone cambios y ejecuta comandos — siempre con el permiso que tú le des.

Es **local-first**: corre en tu máquina, guarda cada conversación en una base de datos SQLite bajo tu directorio de usuario, y no hay ningún servidor de Kiwi por medio. Lo único que sale de tu equipo son las peticiones al proveedor del modelo que hayas configurado.

## Cómo se usa

Dos formas, y las dos cuentan:

```sh
kiwi
```

Abre la interfaz interactiva (TUI). Es donde pasarás la mayor parte del tiempo: conversación, aprobación de cambios, comandos con `/`.

```sh
git diff | kiwi ask "revisa este parche"
```

Un solo turno, sin interfaz, con la respuesta en stdout. Compone con tuberías como cualquier otra herramienta Unix.

## Lo que conviene saber antes de empezar

* **Tú controlas qué puede hacer.** Tres modos de permiso — `ask`, `plan` y `work` — deciden si cada edición y cada comando se aplican solos o te preguntan. Arranca en `ask`, que confirma todo. Ver [Modos de permiso](/kiwi-docs/modos-de-permiso.md).
* **No se guarda ninguna clave en la configuración de Kiwi.** El fichero de config nombra la *variable de entorno* donde vive tu clave, nunca la clave. Ver [Configuración](/kiwi-docs/configuracion.md).
* **Funciona con varios proveedores.** Anthropic, OpenAI, Azure, Google Vertex, y cualquier API compatible con OpenAI — incluido un modelo local corriendo en tu propia máquina.

## Qué no hace

* No tiene demonio ni proceso en segundo plano: cuando cierras Kiwi, no queda nada corriendo. Los comandos que lanzó en segundo plano se paran con él.
* No sube tu código a ningún sitio que no sea el proveedor del modelo que elijas.
* No edita tu `.zshrc` ni tu `PATH` sin decírtelo.

## Siguiente paso

[Instalación](/kiwi-docs/instalacion.md) → [Primeros pasos](/kiwi-docs/primeros-pasos.md)


---

# 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/que-es-kiwi.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.