Pronounced "cloud-pi-d".
The pi coding agent, running all the time on Cloudflare. It is the owner's own pi harness (the same tools, skills, roles, and conversation model) with its Sessions in Durable Objects, so they keep working while the laptop is closed. The owner checks on them and steers them from a phone or a desk.
- Sessions run in Durable Objects through pi-durable and survive restarts and deploys.
- Workspaces hold the files in
@cloudflare/computer, with a Container per Workspace for commands that need real binaries. - The web app is an installable PWA that sends a Web Push when a Run ends, fails, or needs the owner.
- alchemy provisions everything, and Effect is the application language.
It has a single user: only the owner gets past Cloudflare Access.
docs/architecture/: the settled design, the repository layout, and the milestones.docs/development/: running, deploying and upgrading the stack.GLOSSARY.md: the terms used in the code, the docs, and the UI.docs/adr/: the decisions that are hard to reverse.AGENTS.md: how to work in the repo.
You need Node, pnpm (the version in package.json's packageManager, which mise.toml pins too), and Docker with buildx to build the Container image. Vite+ (vp) is a development dependency: run it as pnpm exec vp, or through the scripts.
pnpm install
pnpm run check # format, lint, typecheck, test
pnpm --filter @cloudpid/infra run dev # workerd on http://localhost:1337
pnpm --filter @cloudpid/web run dev # the web app, proxied to the dev serverDeploying needs the secrets listed in docs/development/infra.md → Secrets and variables:
pnpm --filter @cloudpid/infra run deploy --stage dev_$USER