Set up Pigeon

Pigeon creates a Cloudflare R2 bucket, configures upload access, and installs a shared agent skill.

1. Create Cloudflare tokens

Set CLOUDFLARE_API_TOKEN to a token with Workers R2 Storage Write. Set CLOUDFLARE_TOKEN_TOKEN to a token made from Cloudflare's Create additional tokens template. Bootstrap tokens are never stored.

2. Run setup

To supply pre-made bucket credentials instead, add --with-key.

3. Check it works

Doctor uploads a small file, opens it through the public route, then deletes it.

Requirements

Agents use aws-cli to upload files. Screenshot capture uses native tools or headless Chromium. Config lives at ~/.pigeon/config.

Manage it

pigeon env --shell sh

pigeon rotate

pigeon destroy