Stop letting precious Antigravity quotas evaporate into thin air while sleeping, touching grass, or losing track of time.
A lightweight, zero-CVE 24/7 sentry, AI overcharge guard, and pull-based task coordinator for Google Antigravity (agy). Built for Node 26 (node:26-slim) with pure TypeScript and 3 runtime dependencies (discord.js,ky,zod).
Google Antigravity gives you generous rolling quotas across Claude, Gemini, and GPT — on aggressive 5-hour sprint throttles and weekly deadlines. Finishing the day with 80% headroom left means donating free compute back to the ether; leaving an unattended script running overnight with flex credits enabled means waking up to a surprise bill.
Agylity solves both. Running 24/7 on a Raspberry Pi, homelab box, or VPS, it watches both quota buckets, alerts your channels before headroom expires, and acts as an emergency brake against paid overages — while coordinating backlog work and maintenance routines across isolated swarm runners.
- Dual-Bucket Quota Sentry: Tracks 5-hour rolling throttles and weekly budgets via Language Server Connect-RPC (with headless CLI fallback).
- Wallet Protection Shield: Enforces
MIN_DISPATCH_HEADROOM_PERCENT(default10%, or0%on flat-tier accounts to burn quota down to the last drop). - 3-Tier Coordinator & Swarm Runners: Orchestrates immediate dispatches, backlog items, and pre-reset routines across pull-based runners (
src/runner/) without opening inbound ports. - Config with Common Sense: Three-tier fallback (
SQLite Overrides→.env→Defaults) with AES-256-GCM encrypted secrets, live UI edits, and silent-by-default multi-channel alerts (discord,webhook,console). - Hardened Web Dashboard: Optional Vite + Preact + Tailwind v4 UI (
WEB_UI_ENABLED=true, port8484) with Bearer auth, rate limiting, and trusted-proxy CIDR validation.
No need to clone the repo — grab the compose file and env template directly:
curl -sLO https://raw.githubusercontent.com/OtterBoops/agylity/main/docker-compose.yaml
curl -sLO https://raw.githubusercontent.com/OtterBoops/agylity/main/.env.example
cp .env.example .env
# Configure notifications, safety floor, WEB_UI_AUTH_TOKEN, and GITHUB_TOKEN (for runners)
docker compose up -dDashboard: http://localhost:8484.
Note
Runner containers need GITHUB_TOKEN in both .env and compose.yaml environment: — otherwise they exit 1 at boot rather than burning quota on a branch they cannot push. Set ALLOW_TOKENLESS_RUNNER=true only for non-GitHub remotes.
- Architecture & Security — Connect-RPC protocols, SQLite schema, 3-tier task lifecycle, and security invariants.
- Configuration Reference — Every
.envvariable, milestone window, and SQLite override. - Deployment Playbooks — Docker Compose, runner registration, and Node 26 systemd templates.
- Testing & Verification — Deterministic unit and e2e suites using Node's native test runner.
Requires Node.js >= 26.0.0 and npm >= 10.0.0.
git clone https://github.com/OtterBoops/agylity.git && cd agylity
npm ci && npm --prefix frontend ci
cp .env.example .env
# Dev servers (backend on :8484, Vite HMR on :5173)
npm run dev:server
npm run dev:client
# Verification & production build
npm run lint
npm run typecheck
npm test
npm run build && npm start- Bump
versioninpackage.jsonandfrontend/package.json, commit, and pushmain. - Push an annotated tag:
git tag -a vX.Y.Z -m "vX.Y.Z — Short Title" && git push origin vX.Y.Z.
Built with Vite, Preact, Tailwind CSS, Discord.js, and Rosé Pine (the best color palette on the internet).
PolyForm Noncommercial License 1.0.0 © OtterBoops. Free for personal homelabs, noncommercial hacking, and learning; commercial hosting or SaaS wrapping is strictly prohibited.