What problem does it solve?
Operators running gbrain often don't know whether their brain is backed by PGLite or Postgres, and switching engines by hand risks splitting data across two stores. This Skill detects the active engine, provisions Postgres when wanted, and migrates existing PGLite data through the guarded migration path.
Core Features & Use Cases
- Engine Detection: Runs
gbrain engine status --json to report the effective engine, config source, and probe health without needing the database up.
- Postgres-First Provisioning: Uses
gbrain init --prefer-postgres to walk an install ladder covering env URLs, Supabase Management API discovery, local Postgres, opt-in Docker, and PGLite fallback.
- Guarded Migration: Moves an existing PGLite brain with
gbrain migrate --to supabase, which resumes partial runs from a manifest and only flips config after a fully clean run.
- Use Case: A team with three concurrent agents and a 5000-page PGLite brain asks to upgrade; the Skill confirms consent, provisions a Supabase database, migrates all pages, and verifies the result with
gbrain doctor.
Quick Start
Ask the agent to check which gbrain engine is running and upgrade the brain to Postgres if it is still on PGLite.