Agente de código local-first · macOS, Linux y Windows · MIT

Lee, edita y ejecuta en tu proyecto solo con tu permiso.

Kiwi es un agente para la terminal. Corre en tu máquina, guarda cada sesión en SQLite local y funciona con el proveedor de modelos que tú elijas. No hace un solo cambio que no hayas aprobado.

curl -fsSL https://raw.githubusercontent.com/oscar1223/kiwi/main/install.sh | sh
● sin telemetría por defecto● sesiones en SQLite local● 19 proveedores listos

Modos de permiso

Tres modos. Uno activo. shift+tab para cambiar.

El modo decide qué puede hacer el agente sin preguntarte. Pruébalo aquí: haz clic en un modo, o enfoca la ventana y pulsa shift+tab.

kiwi — ~/code/kiwi
  1. ›añade un flag --json a kiwi ask
  2. ⏺read_file cmd/kiwi/ask.go
  3. Añado el flag y serializo la respuesta final.
  4. ⏺edit_file cmd/kiwi/ask.go
  5. +jsonOut := flag.Bool("json", false, "salida en JSON")
  6. ?¿Aplicar esta edición? [s] sí [n] no [a] siempre
ask│sonnet│ctx 12%

Herramientas

Lo que el agente puede tocar.

Todas pasan por el modo activo, las nativas y las que traiga un servidor MCP.

  • read_file

    Lee cualquier fichero del proyecto, y grep y glob lo buscan. También puedes adjuntarlo tú escribiendo @ruta/al/fichero.

  • edit_file

    Edita en sitio y te enseña el diff antes de tocar nada. write_file crea ficheros nuevos.

  • bash

    Ejecuta comandos. Los largos van en segundo plano con bash_background, bash_output y kill_shell.

  • lsp

    Habla con tu servidor de lenguaje: definiciones, referencias y diagnósticos reales en vez de adivinar.

  • remember

    Guarda un hecho duradero. Pasa por el mismo permiso que una escritura: en plan está bloqueada.

  • load_skill

    Carga instrucciones bajo demanda desde las skills en Markdown que tengas instaladas.

  • ask_questions

    Te hace preguntas de opción múltiple antes de cerrar un plan. Mejor preguntar una vez que suponer.

  • mcp

    Las tools de cualquier servidor MCP configurado se añaden solas, detrás del mismo permiso.

Memoria y contexto

Dos cosas que se suelen confundir.

La conversación

Grande, propia de la sesión, y se compacta sola. El umbral sale de la ventana real del modelo activo — la mitad — así que uno de 200k no se compacta con el mismo criterio que uno de 32k. Al saltar, los mensajes viejos se sustituyen por un resumen y los recientes siguen tal cual.

/compactctx 58%

Las notas guardadas

Un puñado de líneas que sobreviven a la sesión y viajan en cada prompt. Ámbito global sobre ti, o project sobre este directorio. Al llenarse caen las más antiguas, y Kiwi te lo dice en vez de olvidar en silencio.

~/.config/kiwi/memory/global.md

~/.config/kiwi/memory/projects/kiwi.md

fuera del repo — nunca aparece en tu git status

Para instrucciones compartidas y versionadas está KIWI.md / AGENTS.md, que Kiwi lee y nunca escribe.

Proveedores

Trae tu propia key.

Veinte perfiles de fábrica sobre cinco integraciones nativas — Anthropic, OpenAI, Azure OpenAI, Vertex y Bedrock. Cualquier otra API con formato chat-completions entra cambiando base_url y la variable de la key, y la key nunca se guarda en la config: solo el nombre de su variable de entorno.

  • anthropic
  • openai
  • ollama
  • openrouter
  • groq
  • deepseek
  • mistral
  • xai
  • cerebras
  • perplexity
  • together
  • fireworks
  • deepinfra
  • moonshot
  • zhipu
  • gemini
  • azure
  • vertex
  • bedrock

Empezar

Tres pasos.

  1. 01

    Instala

    Un binario, sin Go, sin runtime ni demonio detrás. Verifica su SHA256 antes de instalarse.

    curl -fsSL https://raw.githubusercontent.com/oscar1223/kiwi/main/install.sh | sh
  2. 02

    Arranca

    Desde la raíz del proyecto en el que quieras trabajar.

    kiwi
  3. 03

    Elige proveedor

    La primera vez, un onboarding te pide proveedor, modelo y API key. Luego se ajusta con /model.

    /model

Otras formas de instalar

Windows · PowerShell

irm https://raw.githubusercontent.com/oscar1223/kiwi/main/install.ps1 | iex

Homebrew

brew install oscar1223/tap/kiwi

Scoop

scoop bucket add oscar1223 https://github.com/oscar1223/scoop-bucket; scoop install kiwi

Desde fuentes · requiere Go 1.27+

go install github.com/oscar1223/kiwi/cmd/kiwi@latest

También puedes bajar el binario a mano desde Releases. En Windows, la tool bash ejecuta los comandos con bash -c: necesitas Git Bash o WSL en el PATH.

Para un solo turno no interactivo: git diff | kiwi ask "revisa este patch" -. Todo lo demás está en la documentación.