PG AIGuide — plugin oficial de Timescale para que Claude escriba mejor PostgreSQL

Qué es#

PG AIGuide es un plugin oficial de Timescale (la empresa detrás de TimescaleDB y de varios extensions populares de Postgres). Resuelve un problema concreto: los LLMs tienden a generar SQL "que funciona" pero no idiomático, no performante o que ignora features modernas de Postgres.

El plugin trae:

• MCP server que le da a Claude acceso directo a la documentación oficial de Postgres (queries semánticas sobre docs)
• Skills con patrones de Postgres serios: indexing, query optimization, JSON ops, window functions, CTEs, etc.

El resultado: Claude pasa de "escribir SQL como si fuera 2010" a "escribir SQL como si supiera realmente cómo funciona Postgres por dentro".

1.7k stars y respaldo oficial de Timescale = es la referencia para Postgres con AI coding tools.

Tabla resumen#

Cómo se instala#

/plugin marketplace add timescale/pg-aiguide
/plugin install pg-aiguide@timescale-pg-aiguide

O /plugin → Discover.

Para Claude:

Instalá pg-aiguide del marketplace timescale. Tengo un Postgres
[versión X.Y] con [extensiones que uses: TimescaleDB, pgvector,
PostGIS, etc.]. Mostrame ejemplos de cómo cambia tu output con
y sin el plugin para una query de [caso de uso].

Qué podés hacer con esto#

Queries que aprovechan features modernas#

Sin el plugin, Claude tiende a escribir SQL conservador (joins clásicos, agregaciones simples). Con PG AIGuide, propone CTEs recursivas, window functions, lateral joins, JSON path operators — las features que hacen Postgres potente.

Optimización con EXPLAIN#

El plugin sabe leer planes de ejecución (EXPLAIN ANALYZE) y proponer cambios concretos: índices a crear, queries a reescribir, joins a invertir. No solo "tu query es lenta" — concreto cómo arreglarla.

Indexing inteligente#

Cuando agregás un campo nuevo o cambia el patrón de queries, Claude propone los índices correctos (B-tree, GIN, GiST, BRIN según el caso). Distingue entre cuándo conviene index normal, partial, expression o covering.

Trabajar con extensions#

Si usás TimescaleDB (obvio, es de Timescale), pgvector (vector search para AI), PostGIS (geo), pg_partman, etc. — el plugin sabe sus particularidades. Tipo "para esta query de proximidad geo, conviene <-> con índice GiST".

JSONB serio#

JSON en Postgres tiene muchas operadoras (->, ->>, @>, ?, ?|, #>, JSON path). El plugin las conoce todas y propone la correcta para tu caso.

Migraciones sin downtime#

Patterns para ALTER TABLE en tablas grandes sin lockear: agregar columnas con default, cambiar tipos, mover datos, todo con estrategias de zero-downtime.

Beneficios reales#

• Oficial de Timescale — empresa con expertise probado en Postgres.
• Cubre Postgres puro + extensions — incluyendo TimescaleDB, pgvector.
• Conecta docs oficiales vía MCP — Claude no inventa, consulta.
• Queries idiomáticas, no traducciones de MySQL.
• Optimización con planes reales — no consejos genéricos.

Cuándo NO conviene#

Bajalo de la fuente#

• Ficha en aitmpl.com: Pg AIGuide — comando exacto.
• Repo en GitHub: timescale/pg-aiguide — código, MCP server, skills.

Recursos relacionados#

• Claude Code Best Practices — para combinar con buenos prácticas de cómo usar MCPs.
• Anatomía de Claude — para ubicar PG AIGuide como MCP server + skills (lo más profundo del stack).
• All Deploy — para publicar a producción una vez que tu schema Postgres está pulido.