К основному содержанию
скилл CX Codex

pglite — скилл для Claude Code: PostgreSQL в браузере

Скилл по PGlite: подсказывает агенту, как поднять сборку PostgreSQL 17.4 на WASM в браузере или Node.js, выбрать хранилище и настроить live-запросы.

MIT 156 установок ★ 29 обновлён 2026-08-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add oakoss/agent-skills --skill pglite -a claude-code
Открыть на GitHub

Что делает pglite

Скилл описывает PGlite — сборку PostgreSQL 17.4 на WASM, меньше 3 МБ в gzip. Агент получает рабочий набор вызовов: PGlite.create() для инстанса, db.query для запросов с параметрами, db.transaction для ACID-блока, db.exec для строки из нескольких операторов. Хранилище задаётся схемой адреса: память, idb:// или opfs-ahp://.

Под SKILL.md лежат файлы в references/: установка и хранилища, запросы с транзакциями, расширения, live-запросы, React, воркеры на несколько вкладок, синхронизация с Electric. Расширения вроде pgvector, pg_trgm и pgcrypto объявляют в опциях создания инстанса, а не подгружают потом.

Границы простые. OPFS-AHP работает только в Web Worker, а Safari нужных API не даёт, поэтому там остаётся idb://. Синхронизация через Electric идёт в одну сторону, с сервера в таблицу, и запись обратно не вернётся. Для нескольких вкладок нужен PGliteWorker с leader election: запись из них без лидера скилл называет ошибкой.

Какие задачи решает

  • поднять Postgres в браузере без отдельного сервера
  • выбрать хранилище: память, IndexedDB или OPFS
  • обернуть несколько операторов в одну транзакцию
  • подключить pgvector или pg_trgm к встроенной базе
  • сделать live-запрос, который обновляется при изменении данных

Примеры запросов агенту

  • Подключи PGlite к приложению на React и сделай хук live-запроса к таблице tasks.
  • Перепиши эту вставку на db.sql с параметрами и оберни в db.transaction.
  • Настрой PGliteWorker с leader election, чтобы две вкладки не писали одновременно.

Как установить pglite

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill pglite -a claude-code

2Вручную: положить файлы

~/.claude/skills/pglite/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/pglite/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о pglite

Как установить скилл pglite в Claude Code?

Выполните npx skills add oakoss/agent-skills --skill pglite -a claude-code. Файл скилла появится по пути ~/.claude/skills/pglite/SKILL.md.

Что делает скилл pglite?

Даёт агенту справочник по PGlite: создание инстанса, хранилища, запросы, транзакции, расширения, live-запросы, React-интеграция, воркеры на несколько вкладок и синхронизация с Electric.

Почему OPFS не подходит для Safari?

В Safari нет нужных OPFS API, поэтому скилл советует хранилище idb://. Сам OPFS-AHP к тому же требует контекста Web Worker.

Исходный текст

SKILL.md · MIT
---
name: pglite
description: |
  PGlite embeds PostgreSQL 17.4 in the browser and Node.js via WASM, under 3MB gzipped. Covers storage backends, queries, transactions, extensions (pgvector, pg_trgm, full-text search), live queries, React integration, multi-tab worker architecture, and Electric sync.

  Use when setting up PGlite, choosing storage backends, writing queries or transactions, configuring extensions, implementing live queries, integrating with React, managing multi-tab workers, or syncing with Electric.
license: MIT
metadata:
  author: oakoss
  version: '1.0'
  source: 'https://pglite.dev/docs'
user-invocable: false
---

# PGlite

## Overview

PGlite is a lightweight WASM build of PostgreSQL 17.4 that runs directly in the browser, Node.js, and Bun with no external dependencies. It provides a full Postgres query engine with extensions, transactions, COPY support, and listen/notify in under 3MB gzipped.

**When to use:** Local-first apps needing a real SQL engine, browser-based analytics, offline-capable PWAs, embedded Postgres for testing, prototyping without a server.

**When NOT to use:** High-concurrency server workloads (use native Postgres), apps requiring full Postgres replication, Safari OPFS storage (not supported), write-heavy multi-tab scenarios without leader election.

## Quick Reference

| Pattern              | API                                              | Key Points                    |
| -------------------- | ------------------------------------------------ | ----------------------------- |
| Create instance      | `PGlite.create(dataDir?, options?)`              | Awaits ready internally       |
| In-memory DB         | `PGlite.create()`                                | Default, ephemeral storage    |
| IndexedDB storage    | `PGlite.create('idb://dbname')`                  | Persists in browser           |
| OPFS storage         | `PGlite.create('opfs-ahp://dbname')`             | Worker only, no Safari        |
| Parameterized query  | `db.query<T>(sql, params)`                       | Returns `QueryResult<T>`      |
| Tagged template      | `db.sql\`SELECT ...\``                           | Auto-parameterized            |
| Multi-statement exec | `db.exec(sqlString)`                             | No params, returns void       |
| Transaction          | `db.transaction(async (tx) => {})`               | Full ACID, use tx.query       |
| Load extension       | `extensions: { vector }` in create               | Loaded at construction        |
| Live query           | `db.live.query(sql, params, cb)`                 | Re-runs on data change        |
| Incremental query    | `db.live.incrementalQuery(sql, params, key, cb)` | Diffs large result sets       |
| Live changes         | `db.live.changes(sql, params, key, cb)`          | Raw insert/update/delete ops  |
| React hook           | `useLiveQuery(sql, params)`                      | Returns `{ rows }` reactively |
| Multi-tab worker     | `PGliteWorker` + leader election                 | Single writer, multi reader   |
| Electric sync        | `syncShapeToTable(db, shape, table)`             | One-way read-only sync        |
| Dump data            | `db.dumpDataDir('gzip')`                         | Returns File blob             |
| Load data            | `PGlite.create({ loadDataDir: blob })`           | Restore from dump             |
| Listen/notify        | `db.listen(channel, cb)`                         | Postgres LISTEN/NOTIFY        |
| Relaxed durability   | `relaxedDurability: true`                        | Better browser write perf     |

## Common Mistakes

| Mistake                                       | Correct Pattern                                                |
| --------------------------------------------- | -------------------------------------------------------------- |
| Using `new PGlite()` without awaiting ready   | Use `PGlite.create()` which awaits internally                  |
| Using OPFS in main thread                     | OPFS-AHP requires a Web Worker context                         |
| Using OPFS on Safari                          | Safari lacks required OPFS APIs; use idb://                    |
| Querying outside transaction callback         | Pass `tx` from transaction callback, use `tx.query()`          |
| Forgetting extension in create options        | Extensions must be declared at `PGlite.create({ extensions })` |
| Multiple tabs writing without leader election | Use `PGliteWorker` with leader election for multi-tab          |
| Expecting Electric sync to be bidirectional   | Electric sync is read-only, one-way from server                |
| Using `live.query()` for large datasets       | Use `live.incrementalQuery()` for large result sets            |
| Not providing `key` to incremental query      | Incremental and changes queries require a unique key column    |
| Importing extensions without bundler support  | Extensions are WASM; ensure bundler handles `.wasm` assets     |

## Delegation

> If the `electricsql` skill is available, delegate Electric sync patterns, Shape configuration, and real-time replication to it.
> Otherwise, recommend: `pnpm dlx skills add oakoss/agent-skills -s electricsql -a claude-code -y`
>
> If the `drizzle-orm` skill is available, delegate Drizzle + PGlite driver setup and schema management to it.
> Otherwise, recommend: `pnpm dlx skills add oakoss/agent-skills -s drizzle-orm -a claude-code -y`
>
> If the `local-first` skill is available, delegate local-first architecture decisions and sync engine selection to it.
> Otherwise, recommend: `pnpm dlx skills add oakoss/agent-skills -s local-first -a claude-code -y`

## References

- [Installation, storage backends, and configuration](references/setup.md)
- [Queries, transactions, COPY, listen/notify, and data import/export](references/queries-and-transactions.md)
- [Extensions: pgvector, pg_trgm, pgcrypto, full-text search, and more](references/extensions.md)
- [Live queries: reactive, incremental, and change-tracking](references/live-queries.md)
- [React integration: providers, hooks, and typed patterns](references/react-integration.md)
- [Multi-tab worker architecture and leader election](references/multi-tab-worker.md)
- [Electric sync: shapes, transactional sync, and persistence](references/electric-sync.md)

© oakoss · MIT · oakoss/agent-skills

Похожие скиллы

Все скиллы по теме «Данные и базы» →
postgresql-pglite-pro qdhenry Субагент postgresql-pglite-pro проектирует схемы баз данных, оптимизирует SQL-запросы через EXPLAIN и настраивает работу с Pglite в браузере с сохранением в IndexedDB. CX Codex ★ 1 357звёзд репо pgmicro-postgres-sqlite reason-machines Скилл pgmicro-postgres-sqlite подключает к ассистенту инструкции по pgmicro — движку, который разбирает диалект PostgreSQL и исполняет его поверх хранилища SQLite без запуска полноценного сервера. CX Codex +1 819установок neon-realtime neondatabase Скилл neon-realtime для Claude Code превращает SQL-запросы в живые подписки на изменения строк Lakebase Postgres. Передаёт изменения батчами для дашбордов, лент и синхронизации между устройствами. CX Codex +1 24 200установок performance-profiler OneWave-AI Скилл performance-profiler для Claude Code находит узкие места в сети, рендеринге, памяти и вычислениях. Разбирает медленные приложения и утечки памяти. CX Codex +1 333установок python-fastapi-scalable-api-cursorrules-prompt-fil PatrickJS Правило python-fastapi-scalable-api-cursorrules-prompt-fil для Cursor задаёт стиль разработки масштабируемых API на FastAPI и интерфейсов на React. Оно применяется к файлам по маске **/*. CX Codex +1 ★ 41 178звёзд репо nuxt-server Claude Skills Maintainers Серверная разработка на Nuxt 4 с Nitro — API-роуты, middleware, базы данных и WebSocket. Бэкенд живёт внутри Nuxt-проекта. CX Codex +1 423установок

Из того же набора106

Весь набор →
react-performance Скилл react-performance для Claude Code собирает паттерны оптимизации React и включается автоматически в задачах о скорости приложения. CX Codex +1 163установок design-system Скилл design-system для Claude Code собирает дизайн-систему с токенами, темами и архитектурой компонентов. Задаёт структуру для dark mode, CVA-вариантов и доступности. CX Codex +1 160установок zustand Скилл помогает настроить Zustand v5 в React: от типизированных хранилищ и middleware до SSR, тестов и миграции с Redux или Context. CX Codex +1 158установок tanstack-start По TanStack Start описывает серверные функции, SSR со стримингом, middleware и деплой. CX Codex +1 156установок tanstack-table Настраивает headless-таблицы TanStack Table v8 в React: серверная пагинация, фильтры и сортировка без циклических ререндеров. CX Codex +1 155установок changesets Скилл changesets помогает вести версии и changelog пакетов в монорепозитории. Он пригодится для согласованных релизов и публикации пакетов в npm. CX Codex +1 154установок opentofu Помогает писать и проверять конфигурации OpenTofu и Pulumi. Помогает управлять инфраструктурой, состоянием и окружениями из кода. CX Codex +1 153установок arktype-validation Скилл arktype-validation для Claude Code описывает схемы ArkType строками в синтаксисе TypeScript, включая морфы и рантайм-валидацию данных и переменных окружения через ArkEnv. CX Codex +1 153установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой