runbook (59)
- Start screenpipe dev GUI on corp VDI 2026-07-02Run the full screenpipe desktop GUI in dev mode (free, no build needed) on Windows 11 corp VDI using the chirag127/screenpipe fork.
- Umbrella deploy workflow usage 2026-07-02How to trigger, test, and debug .github/workflows/deploy.yml on chirag127/workspace.
- WORKSPACE_DISPATCH_PAT setup 2026-07-02Create fine-grained PAT for downstream repos to trigger umbrella deploy via repository_dispatch.
- Start dev server from source (OmniRoute, freellmapi, any fleet fork) 2026-06-30Step-by-step: replace global npm install with a local cloned-fork dev server. Auto-start on Windows login, pull upstream on every launch, run via Windows Terminal tab.
- ZCode MCP Server Setup 2026-06-29Step-by-step guide for configuring all 8 workspace MCP servers in ZCode via the GUI.
- Fix cavemem hooks failing with "Executable not found in $PATH: sh" 2026-06-29Claude Code wraps every command hook in `sh -c`. On Windows without Git\bin in PATH, sh.exe isn't found and every hook silently fails. Add Git\bin to user PATH + verify.
- Upload MCP servers to Smithery toolbox `@chirag127/toolbox` 2026-06-29Add MCP server to Smithery toolbox under @chirag127/toolbox endpoint
- Mirror all hosts setup — one-time token generation + repo pre-creation for the 9 popular hosts 2026-06-28One-time 9-host mirror setup
- chirag127 fork cleanup 2026-06-26 — bulk delete with downstream-aware sparelist 2026-06-2643 chirag127 forks deleted, 5 spared
- GitHub profile customization — what works via API vs manual 2026-06-26GH profile: API-patchable fields vs pinned repos
- VS Code Copilot warning suppression + GitHub Copilot Free signup 2026-06-26Silence VS Code Copilot nag; claim free 2k-completions/mo tier (no card)
- Publish a userscript to Greasy Fork (manual paste, then webhook auto-update) 2026-06-24Publish userscript to Greasy Fork; manual paste first version, webhook auto-update
- Publish a VS Code extension to the Marketplace (vsce publish) 2026-06-24Ship VS Code extension to Marketplace + Open VSX via vsce + ovsx
- Manage a private organization repository mirroring public upstream releases 2026-06-24Merge upstream updates into private fork
- Auth bug: 'Sign in shows even after login' — root causes + fix layers 2026-06-24Fix cross-domain auth-state-not-reflected bug; cookie sync across account.oriz.in
- Backup metadata to Backblaze B2 (weekly, single umbrella workflow) 2026-06-24Weekly backup of repo metadata (issues/PRs/wiki/releases) to Backblaze B2
- Free hosting — serverless functions + edge (CF Workers, Deno Deploy, AWS Lambda EXCEPTION, Render, Koyeb, Val.town, HF Spaces, Modal — 2026-06-23 audit) 2026-06-23Serverless free tiers: CF Workers → Deno → Lambda → Render
- Codeberg as 2nd git remote — DR mirror for the family 2026-06-23Codeberg as DR mirror via nightly GH Actions
- Free hosting — Azure for Students (student-verified, NO card at signup) 2026-06-22Azure for Students: $100/yr, no card, student-verified
- Free hosting — image CDN + transforms + durability replication (Cloudinary, ImageKit, imgbb, GitHub Releases, Uploadcare) 2026-06-224-host replicate-everywhere image CDN strategy
- Free hosting providers catalog — no-card, large-fleet picks (2026-06-22) 2026-06-22Catalog of every free-tier hosting provider vetted for the oriz family. Hard rule: NO card-on-file at signup. Must support a 50+ project fleet, decent bandwidth, and commercial use. Each sub-file is one category with provider-by-provider numbers, sources, and a KEEP / EVALUATE / DROP verdict.
- Free hosting — object storage (R2, B2, IDrive, Filebase, Storj, Wasabi) 2026-06-22Object storage free tiers: R2, B2, Storj
- Free hosting — databases (Firestore, Supabase, Neon, Turso, Mongo, CockroachDB, Upstash, D1, KV) 2026-06-22DB free-tier numbers for Firestore, Neon, D1, Turso, KV
- Free hosting — monitoring (Better Stack, UptimeRobot, Healthchecks, Sentry, Axiom) 2026-06-22Monitoring free-tier: Better Stack, Sentry, Axiom
- Free hosting — queues + pub-sub (CF Queues, Upstash QStash, Inngest, Trigger.dev, Pusher) 2026-06-22Queues + pub-sub free tiers: CF, QStash, Inngest
- Free hosting — static sites (CF Pages, GH Pages, Netlify, Vercel, Surge, Render, Neocities, Bunny, Fleek) 2026-06-22Static site free tiers: CF Pages primary, GH Pages mirror
- Free hosting — web services (Render, Fly, Railway, Koyeb, Replit, Cyclic, Glitch) 2026-06-22Web services free tiers: Render (sleep) and Koyeb (1 nano)
- Cloudflare Pages — branch deploys mitigation for 100-project limit 2026-06-22Branch-based environments inside each CF Pages project
- GitHub Apps audit — chirag127 account, 2026-06-22 2026-06-22One-shot audit of GitHub Apps on chirag127 account
- Set up Razorpay Subscriptions + Paddle Checkout (Pro Monthly/Yearly + Max Monthly/Yearly) 2026-06-22Set up Razorpay (INR) + Paddle (USD) subscription tiers
- Razorpay end-to-end setup — TEST keys + 4 plans + 4 promos + webhook + E2E test + LIVE 2026-06-22Step-by-step Razorpay subscriptions setup: test keys, webhook, promo codes, E2E test, LIVE
- Env management — sops + age + GitHub Org Secrets 2026-06-22sops + age + GH Org Secrets env pipeline
- npm publish — token setup for chirag127/* packages 2026-06-21Generate npm Granular Access Token; store as NPM_TOKEN for unattended publish/unpublish
- Mirror cron — pre-flight checklist 2026-06-21Pre-flight checklist for 4-host git mirror cron
- Install free GitHub Apps to all 39+ chirag127/oriz* repos in one pass 2026-06-21Install free GH Apps to all org repos in one pass
- Migrate CI/CD from GitHub Actions to GitLab CI or CircleCI 2026-06-21Plan-B runbook when GitHub Actions unusable; translates CI to GitLab CI + CircleCI
- Add a new chirag127/*-npm-pkg repo to packages.oriz.in catalog 2026-06-21Publish npm package, auto-appears in catalog
- Build PWA + Android AAB/APK + Windows MSIX + desktop EXE from one app 2026-06-21Build PWA + Android + MSIX + desktop from one app
- Install + bootstrap the umbrella workspace 2026-06-21Umbrella workspace clone + bootstrap procedure
- Scaffold a new chirag127 site 2026-06-21Add new Astro site in <10 min: clone starter, edit config, deploy to CF Pages
- Set / update GitHub Actions secrets at the chirag127 org level 2026-06-20Pull secret from Doppler, push to chirag127 org-level GH secrets via gh CLI
- Scaffold a new chirag127 tool site (Astro + dark theme + CI) 2026-06-20Bootstrap tool site from stub README to deployable Astro app
- Rename a repo to its role-suffixed slug 2026-06-20Rename chirag127/oriz* repo to role-suffixed slug; update .gitmodules + submodules
- Apply per-site CI templates to every oriz-* submodule 2026-06-20Apply CI templates to every submodule in one pass
- Migrate the knowledge bundle to a new OKF spec version 2026-06-20Run when OKF spec moves beyond v0.1; batch-update format_version across concept files
- Lifestream auto-sources setup — wire the 3 pipelines to live cron + webhooks 2026-06-20Wire 3 lifestream pipelines to cron + webhooks
- Auth setup — log in once, publish + deploy forever 2026-06-20Login commands + dashboard URLs for publish/deploy; tokens in envpact vault
- Add a new decision to the knowledge bundle 2026-06-20Capture decisions as knowledge before session ends
- Add a new Chrome / Firefox / Edge extension 2026-06-20Add extension repo with cross-store publish workflow
- Add a new site to the family 2026-06-20Add new site submodule with CI + CF Pages deploy
- Bump a submodule pointer in master 2026-06-20Bump master submodule pointer after feature lands
- Clean install — bootstrap the entire family on a fresh machine 2026-06-20Clone + pnpm install boots full family in under 10 min
- Sync .env.example from master to every repo 2026-06-20Add/remove/rename family-wide env var; sync from master to all submodules
- Rotate a leaked secret 2026-06-20Revoke, reissue, re-login, store via envpact, verify, audit leak
- Set up the weekly restic → Backblaze B2 backup 2026-06-20Weekly encrypted restic backup to Backblaze B2 via GH Actions
- Rotate Cloudflare + npm tokens, set as org-level GH secrets 2026-06-20Rotate Cloudflare + npm tokens; store at chirag127 org level
- Install auto-start services (Headroom + cavemem)
- Web crawler MCPs (3-tier fallback)
- Keyed MCPs via Smithery CLI