Así funciona la IA de PocketCode por dentro
Un vistazo técnico a cómo diseñamos el asistente de IA de PocketCode: sugerencias en línea, chat contextual y herramientas que llegan a los módulos de la app, con tu propio proveedor.
Así funciona la IA de PocketCode por dentro
La inteligencia artificial de PocketCode no es un chatbot genérico pegado a un editor. Es un sistema integrado que entiende tu proyecto, tu código y los módulos que estás usando. En este post te contamos cómo lo hemos construido.
Arquitectura general
El sistema de IA tiene tres piezas principales:
1. Sugerencias en línea (ghost text)
Mientras escribes, el editor puede mostrar una sugerencia en gris después del cursor, con el proveedor de IA que hayas conectado. Funciona aparte de los servidores de lenguaje, que dan completado y diagnósticos en local.
Qué hace y qué no:
- Una ventana alrededor del cursor: la petición lleva hasta 2.000 caracteres antes del cursor y 500 después (estilo Fill-in-the-Middle), más el lenguaje. No envía el resto del proyecto.
- Código corto y en bruto: se le pide al modelo que responda solo con código, como máximo 10 líneas, o que no responda nada si nada encaja.
- Activado por defecto, con un proveedor: necesita un proveedor con clave o inicio de sesión, el aviso de datos que aceptas la primera vez y los interruptores Sugerencias automáticas y Completado de código (Ajustes → IA, ambos activados por defecto). Se desactiva solo en archivos muy grandes.
2. Chat contextual
El chat de IA no es un simple prompt-respuesta. En cada turno la app construye un contexto y lo envía junto con tu mensaje:
- El archivo abierto (hasta 4.000 caracteres), su lenguaje y el nombre del proyecto
- Una lista de rutas y un mapa del repositorio
- La memoria del proyecto (hasta 4.000 caracteres), si la hay
- Tus menciones con
@, los archivos que adjuntas y los resultados de las herramientas
Esto significa que puedes preguntar "¿qué hace esta función?" sin copiar y pegar código. Antes de que un prompt salga del dispositivo, las formas comunes de clave (claves de OpenAI, Anthropic, Google, GitHub, AWS, etc.) y tus secretos guardados se enmascaran: una red de seguridad, no una garantía.
3. Herramientas de los módulos (Tool Calling)
Esta es la parte más potente. La app declara 84 herramientas y un chat normal ofrece hasta 79 de ellas en 14 categorías (archivos, terminal, Git, base de datos, API, SSH, despliegue, el Dev Browser y más) para que la IA trabaje con los módulos de la app. Una muestra representativa:
| Herramienta | Qué hace |
|---|---|
create_file | Crea archivos en tu proyecto |
run_in_terminal | Ejecuta un comando en el shell local |
db_query | Ejecuta consultas contra la base de datos |
design_list | Lista y lee proyectos del diseñador visual |
git_status | Consulta el estado de Git |
read_file | Lee archivos del proyecto |
semantic_search | Ordena el código por las palabras clave de una pregunta en lenguaje natural |
grep_search | Busca en el código una cadena o patrón exactos |
Cuando le dices a la IA "crea un ViewModel para la lista de usuarios", no solo genera código: puede crear el archivo en la carpeta que le pidas y editar los archivos que necesiten el cambio.
Seguridad
Lo que el agente puede hacer lo decide un nivel de acceso de cinco pasos: Sin herramientas, Solo lectura, Preguntar, Editar solo (Auto-edit, el valor por defecto: escribe archivos por su cuenta y pregunta antes de ejecutar comandos) y Acceso total.
- Siempre pregunta por lo que sale del dispositivo: un
git push, un despliegue, una petición de API o un comandosshesperan tu OK en todos los niveles, salvo que apagues esa protección en Permisos de herramientas IA. - Comprobación de riesgo de los comandos: los comandos de terminal se clasifican antes de ejecutarse, y uno catastrófico nunca se ejecuta. Es defensa en profundidad, no un sandbox.
- Permisos por herramienta: en Ajustes → IA → Permisos de herramientas IA puedes denegar cualquier herramienta para un proveedor o un modelo.
- Límites: un comando espera 30 segundos por defecto (120 como máximo) y
read_filerechaza archivos de más de 5 MB.
Modelos compatibles
PocketCode funciona con varios proveedores de IA bajo un modelo BYOK (trae tu propia clave), con inicio de sesión de ChatGPT y de GitHub donde el proveedor lo admite. PocketCode no es un proveedor de IA: cada petición va directamente del dispositivo al proveedor que elijas, y el uso lo factura el proveedor según su política.
- Gemini (Google) — solo API key
- OpenAI — API key, o inicia sesión con tu cuenta de ChatGPT mediante el Codex CLI incluido (solo móviles ARM de 64 bits)
- Anthropic Claude — solo API key (
sk-ant-…) - GitHub Copilot — inicia sesión con tu cuenta de GitHub
- Custom (compatible con OpenAI) — cualquier endpoint
/v1: OpenRouter, Groq, DeepSeek, LM Studio, Ollama o tu propio servidor. HTTP sin cifrar solo funciona con localhost; un Ollama o LM Studio en tu red necesita HTTPS o un túnel.
La lista de modelos no es fija: la lista de cada proveedor se lee en vivo del propio proveedor, y la app guarda una pequeña lista de respaldo para cuando no tienes red o clave.
Todos los proveedores son gratis. PocketCode nunca cobra por el acceso a los modelos; el plan de pago es para sus propios motores y herramientas (Swarmcode, Cortex y AI Office son Pro, y también Cloud Sync).
Los usuarios conectan su cuenta o su API key en Ajustes → IA → Claves API.
Conclusión
La IA de PocketCode no es un componente añadido: es una parte integral de la experiencia de desarrollo. Todos los módulos de la app (terminal, base de datos, diseñador, Git) están conectados, y la IA puede llegar a todos a través de herramientas, bajo el nivel de acceso que elijas.
Puedes ver el estado completo del desarrollo en nuestro post de estado.
Asistente de IA