env/dotfiles

0 Fork 0

mirror of https://github.com/prdlk/dotfiles.git synced 2026-11-02 19:32:43 +00:00

Files

T

Prad Nukala 6406208b35 shell: fish functions -> ~/.local/bin executables + bash/zsh ports; manage ~/.agents

- 16 cross-shell utilities converted to sh/bash chezmoi executables:
  ai c2p cp-appid extract_agents fab gdc gh-sonr-org-migrate ghg-clone
  ghn gho git-summary launch_omp_livediff_overlay lc-elir mdcp mdp pj
  (ghg-clone not named ghg: unrelated cargo binary owns that name)
- cwd/history helpers stay per-shell: yy c cd clip-last + ghg/ghn/gho
  cd-wrappers in bash/functions/ and zsh/functions/, loaded by rc files
- fish keeps only shell-state functions; converted ones now hit PATH
- cp-appid ignore gating moved to .local/bin path
- dot_agents/skills: 82 skills materialized from dotstate storage so
  dot_claude skill symlinks resolve on fresh bootstrap; dotstate
  profile/symlinks.json released .agents/skills .bashrc .zshrc

2026-08-10 15:15:06 -04:00

2.4 KiB

Raw Blame History

Cloudflare API Integration

Guide for working with Cloudflare's REST API - authentication, SDK usage, common patterns, and troubleshooting.

Quick Decision Tree

How are you calling the Cloudflare API?
├─ From Workers runtime → Use bindings, not REST API (see ../bindings/)
├─ Server-side (Node/Python/Go) → Official SDK (see api.md)
├─ CLI/scripts → Wrangler or curl (see configuration.md)
├─ Infrastructure-as-code → See ../pulumi/ or ../terraform/
└─ One-off requests → curl examples (see api.md)

SDK Selection

Language	Package	Best For	Default Retries
TypeScript	`cloudflare`	Node.js, Bun, Next.js, Workers	2
Python	`cloudflare`	FastAPI, Django, scripts	2
Go	`cloudflare-go/v4`	CLI tools, microservices	10

All SDKs are Stainless-generated from OpenAPI spec (consistent APIs).

Authentication Methods

Method	Security	Use Case	Scope
API Token ✓	Scoped, rotatable	Production	Per-zone or account
API Key + Email	Full account access	Legacy only	Everything
User Service Key	Limited	Origin CA certs only	Origin CA

Always use API tokens for new projects.

Rate Limits

Limit	Value
Per user/token	1200 requests / 5 minutes
Per IP	200 requests / second
GraphQL	320 / 5 minutes (cost-based)

Reading Order

Task	Files to Read
Initialize SDK client	api.md
Configure auth/timeout/retry	configuration.md
Find usage patterns	patterns.md
Debug errors/rate limits	gotchas.md
Product-specific APIs	../workers/, ../r2/, ../kv/, etc.

In This Reference

api.md - SDK client initialization, pagination, error handling, examples
configuration.md - Environment variables, SDK config, Wrangler setup
patterns.md - Real-world patterns, batch operations, workflows
gotchas.md - Rate limits, SDK-specific issues, troubleshooting

2.4 KiB Raw Blame History