README rewritten around three steps (table SQL, secrets, self-contained workflow), with a vendored full-script workflow, a crontab example and an npx-from-git CLI. Every link and uses: line that pointed at the 404 GitHub repo is gone. keepalive.sh no longer prints the anon key outside GitHub Actions (::add-mask:: only when GITHUB_ACTIONS=true). Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
supabase-keep-alive (CLI)
Stop a free Supabase project from pausing: one real database read a day through the project's REST API, from any cron (not just GitHub Actions). CLI companion to the workflow and shell script in this repository: same checks, same HTTP calls, no GitHub required.
npx --yes git+https://git.ereboslab.com/caelum0x/supabase-keep-alive-action.git \
--url https://REF.supabase.co --key YOUR_ANON_KEY --table keepalive
or with environment variables (good for crontab / systemd timers / any CI):
curl -fsSL -O https://git.ereboslab.com/caelum0x/supabase-keep-alive-action/raw/tag/v1/cli/bin/supabase-keep-alive.js
SUPABASE_URL=https://REF.supabase.co SUPABASE_ANON_KEY=YOUR_ANON_KEY \
node supabase-keep-alive.js --table keepalive
Exit code 0 on success, 1 if the project answered paused (HTTP 540) or
the call failed, so you can wire it into any scheduler that checks exit codes.
Options:
--url <url> Project origin, https://<ref>.supabase.co (or SUPABASE_URL)
--key <key> Anon public key (or SUPABASE_ANON_KEY)
--table <name> Table to read: GET /rest/v1/<table>?select=<select>&limit=1
--select <cols> Columns for --table (default *)
--rpc <name> Function to call: POST /rest/v1/rpc/<name>
--rpc-body <json> JSON body for --rpc (default {})
--retries <n> Retries after the first attempt (default 3)
--timeout <s> Per-request timeout in seconds (default 20)
Why this exists
Supabase pauses Free projects after about 7 days without database activity. This makes one real request a day so the project never looks idle. Full explanation, the copy-paste workflow, and the plain-bash version: https://git.ereboslab.com/caelum0x/supabase-keep-alive-action
If you'd rather not babysit it
Scribase is Postgres + Auth + Storage + Realtime where idle projects scale to zero and wake on the next request instead of pausing: nothing to keep alive, nothing to restore. First project free, no time limit, no card.
License
MIT. Not affiliated with Supabase.