Skip to content

heymegabyte/agent-skills / 05-architecture-and-stack

architecture-and-stack

Verified

Cloudflare-first platform selection. Workers, D1, R2, KV, DO, Queues, Vectorize, Containers, Workflows, native Go CLIs and measured Rust/WASM acceleration. Default stack, override conditions, auth, data patterns and reliability.

shared-api-pool.md

View on GitHub
---
name: "Shared API Pool"
description: "185 API keys across 27 categories in chezmoi+age encrypted store. Auto-discovery via get-secret. Every project auto-integrates with available services. Full catalog in ~/.claude/research/api-library.md (150+ APIs with free tiers, env vars, MCP availability, and integration examples)."
updated: "2026-04-23"
---

# Shared API Key Pool

## Rule

ALL Emdash projects share a common pool of API keys. When building any project, automatically integrate with every service that has a key available. Run `discover-secrets.sh` to see what's unlocked.

## Secret Discovery (3 Sources, Priority Order)

### 1. Chezmoi Encrypted Store (185 secrets) — PRIMARY

```bash
get-secret SECRET_NAME          # Decrypt any secret by name
discover-secrets.sh             # Full inventory
discover-secrets.sh --check KEY # Check single key
```

- **Location** — `~/.local/share/chezmoi/home/.chezmoitemplates/secrets/`
- **Cross-machine sync** — `chezmoi apply` on any new machine → all 185 secrets available instantly

### 2. Shared .env.local (54 keys, runtime-loaded)

Active project `.env.local` (check `$CLAUDE_ENV_FILE` when set)

### 3. Emdash Config

`~/.config/emdash/` — `coolify-token`, `gcp-service-account.json`

## Available Keys by Category

### AI/ML (11 keys)

- `OPENAI_API_KEY` — GPT Image 2/Whisper (DALL-E deprecated May 2026)
- `ANTHROPIC_API_KEY` — Claude
- `GEMINI_API_KEY` — Gemini
- `DEEPSEEK_API_KEY` — DeepSeek V3/R1
- `DEEPGRAM_API_KEY` — STT ($200 free)
- `ELEVENLABS_API_KEY` — TTS/voice clone
- `REPLICATE_API_TOKEN` — any ML model
- `MISTRAL_API_KEY` — open-weight LLMs
- `CEREBRAS_API_KEY` — fast inference
- `BASETEN_API_KEY` — model hosting
- `CARTESIA_API_KEY` — voice AI

**Missing:** `GROQ_API_KEY` (fastest, free 30rpm) | `TOGETHER_API_KEY` ($5 free) | `FIREWORKS_AI_API_KEY` ($1 free) | `COHERE_API_KEY` (free embeddings) | `STABILITY_API_KEY` (25 free/day) | `PERPLEXITY_API_KEY` | `FAL_AI_API_KEY` | `ASSEMBLYAI_API_KEY` ($50 free) | `LUMA_API_KEY` | `SUNO_API_KEY`

### Communication (12 keys)

- `SLACK_WEBHOOK_URL`, `SLACK_API_TOKEN`, `SLACK_BOT_USER_OAUTH_TOKEN`, `SLACK_CLIENT_ID/SECRET`
- `DISCORD_BOT_TOKEN`, `DISCORD_CLIENT_ID/SECRET`
- `TWILIO_ACCOUNT_SID`, `TWILIO_AUTH_TOKEN`, `TWILIO_FROM_NUMBER`
- `TELEGRAM_BOT_TOKEN` + `TELEGRAM_BOT_NAME` + `TELEGRAM_RECIPIENT_ID`

**Missing:** `VONAGE_API_KEY`

### Cloud/Infra (15+ keys)

- `CLOUDFLARE_API_TOKEN`, `CLOUDFLARE_API_KEY`, `CLOUDFLARE_ACCOUNT_ID`, `CLOUDFLARE_EMAIL`
- `CLOUDFLARE_R2_*` (6 keys)
- `CLOUDFLARE_TEAMS_*` (2 keys)
- `CLOUDFLARE_SSH_API_TOKEN`, `CLOUDFLARE_ORIGIN_CA_KEY`
- `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`
- `DIGITALOCEAN_ACCESS_TOKEN`

### Media (6 keys)

- `PEXELS_API_KEY`, `PIXABAY_API_KEY`
- `IDEOGRAM_API_KEY` — text-in-image
- `RUNWAY_API_KEY` — video gen
- `REPLICATE_API_TOKEN` — any model
- `CLOUDINARY_API_KEY` + `SECRET` + `CLOUD_NAME` — image CDN

### Social (15+ keys)

- `POSTIZ_API_KEY` — social scheduling
- `TWITTER_API_KEY` + `SECRET` + `ACCESS_TOKEN` + `BEARER_TOKEN` + `OAUTH_*` (7 keys)
- `FACEBOOK_OAUTH_ID/SECRET`
- `REDDIT_APP_ID` + `SECRET` + `USERNAME` + `PASSWORD`
- `PINTEREST_OAUTH_ID/SECRET`
- `YOUTUBE_OAUTH_ID/SECRET`
- `DEVTO_API_KEY`

### Payments

- STRIPE via project `.env` — `STRIPE_SECRET_KEY`, `STRIPE_PUBLISHABLE_KEY`, `STRIPE_WEBHOOK_SECRET`

**Missing:** `LEMONSQUEEZY_API_KEY` (handles tax/VAT automatically)

### Email (2 keys)

- `RESEND_API_KEY` — modern, React Email
- `SENDGRID_API_KEY` — legacy (free tier removed May 2025)

**Missing:** `POSTMARK_SERVER_TOKEN` (highest deliverability) | `LOOPS_API_KEY` (SaaS marketing) | `PLUNK_SECRET_KEY` (open-source)

### Search (3 keys)

- `GOOGLE_SEARCH_API_KEY` + `GOOGLE_SEARCH_ID`
- `SERP_API_KEY`
- `TAVILY_API_KEY` — AI search

**Missing:** `ALGOLIA_APP_ID` + `API_KEY` | `TYPESENSE_API_KEY` | `BROWSERBASE_API_KEY` (for Stagehand)

### Maps/Geo (3 keys)

- `GOOGLE_MAPS_API_KEY`
- `MAPBOX_ACCESS_TOKEN`
- `FOURSQUARE_API_KEY`

**Missing:** `LOCATIONIQ_TOKEN` (free 10K/day) | `OPENWEATHERMAP_API_KEY` (in chezmoi)

### Dev (7 keys)

- `GITHUB_TOKEN`, `GITHUB_GIST_TOKEN`, `GITHUB_READ_TOKEN`
- `GITLAB_TOKEN`, `GITLAB_READ_TOKEN`
- `NPM_TOKEN`
- `DOCKERHUB_TOKEN`

### Domain/DNS (2 keys)

- `GODADDY_API_KEY` + `SECRET`
- `WHOISXML_API_KEY`

**Missing:** `NAMECHEAP_API_KEY` | `DUB_API_KEY` (link shortening)

### Self-Hosted (8 keys)

- `OMI_DEV_KEY` + `OMI_MCP_KEY` — Omi wearable
- `HASS_TOKEN` — Home Assistant
- `SUPERMEMORY_TOKEN`
- `N8N_API_KEY`, `PLANE_API_KEY`, `NOTION_TOKEN`
- `WP_API_PASSWORD` + `USERNAME`
- Plus Coolify token at `~/.config/emdash/coolify-token`

### Infrastructure/VPN (10+ keys)

- `TAILSCALE_AUTH_KEY`, `NGROK_AUTH_TOKEN`
- `NORDVPN_*`, `PROTONVPN_*`
- `PROXMOX_ROOT_PASSWORD`
- `RESTIC_PASSWORD` (backups)
- `HISHTORY_USER_SECRET`, `WAKATIME_API_KEY`

## MCP Servers with Keys (26 servers installed)

Cloudflare | GitHub | Playwright | Stripe | Slack | Airtable | Figma | Google Cal/Drive/Gmail | IFTTT | Notion | Plane | Coolify | WordPress | PostHog | Sentry | Firecrawl | DeepSeek | Sequential Thinking | Supermemory | Computer Use | Context7 | Neon | Snyk | Semgrep | Upstash | Twilio | Replicate | ElevenLabs | Meilisearch | Accessibility Scanner | Idea Reality

## Self-Hosted Services (Proxmox/Coolify, 70+ containers)

- Services follow pattern `{service}.megabyte.space` behind CF Tunnels + Authentik SSO
- 70+ containers managed via Coolify; all URLs discoverable via Coolify API or `~/.config/emdash/`

## Integration Protocol

For EVERY new project:

1. Scan key pool via `discover-secrets.sh`
2. Create PostHog + Sentry project instances
3. Inject keys as CF Worker secrets via `wrangler secret put`
4. Configure client-side snippets
5. Set up server-side reporting

**MANDATORY** — PostHog analytics + Sentry errors on every project.

## Full API Catalog

- 150+ APIs with free tiers, env vars, MCP availability, and code examples — `~/.claude/research/api-library.md`
- Sideload when choosing which APIs to integrate: `Read ~/.claude/research/api-library.md`

## Key Discovery Order

1. Check `.env.local` in current project
2. Check shared pool at rare-chefs `.env.local`
3. Run `get-secret KEY` (chezmoi+age)
4. Check `~/.config/emdash/` tokens
5. Not found → sign up (most have free tiers) → `chezmoi add --encrypt`
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall