- Supapool provides ephemeral, isolated Supabase instances for running commands in CI or agent workflows.
- The 'npx @supapool/cli run' command wraps any command, leasing a clean instance with injected Supabase credentials.
- Each instance includes real Postgres, Auth, and S3-compatible Storage, avoiding mocks and parallel agent conflicts.
- Instances are colocated near the agent, spin up quickly, and are released upon command exit with all data wiped.
- The CLI injects standard Supabase environment variables (e.g., SUPABASE_URL, DATABASE_URL) and aliases for popular frameworks.
- Leases have a default 30-minute TTL, renewed every 5 minutes; CI jobs skip browser login by using an API key.
- The npm package also offers a 'withInstance' function for programmatic use, ensuring lease acquisition and release even on errors.