A monorepo for running pi-style coding agents and related tools on Cloudflare Workers.

This repo contains:

• reusable Worker-focused packages
• worker-friendly forks of pi runtime pieces
• deployable examples, including a full terminal-native agent

The most complete example in the repo.

A browser terminal UI backed by:

• a SQLite-backed Durable Object session store
• persistent files
• dynamic worker sandboxes for code execution
• published session-scoped Workers
• Durable Object alarm-powered cron jobs

Read more here:

• examples/terminal-agent/README.md
• live deployment: https://pi.camelai.dev

.
├── packages/
│   ├── pi-worker/                # reusable Cloudflare Worker helpers/tools
│   ├── pi-coding-agent-worker/   # worker-friendly fork of pi-coding-agent
│   └── pi-tui-worker/            # worker-friendly fork of pi-tui
├── examples/
│   ├── hello-agent/              # minimal example
│   ├── ffmpeg-agent/             # ffmpeg-focused worker example
│   ├── codegen-worker/           # code generation / scaffold example
│   └── terminal-agent/           # full browser terminal agent

Core Worker-oriented primitives and helpers.

Includes utilities like:

• file tool implementations
• execute tool support using Dynamic Worker Loaders
• in-memory / R2 / SQLite-backed helper patterns
• download helpers

A worker-friendly fork/wrapper around @mariozechner/pi-coding-agent.

Used so pi's coding-agent runtime can run in Cloudflare Workers instead of a normal Node CLI environment.

A worker-friendly fork/wrapper around @mariozechner/pi-tui.

This underpins terminal-style UI behavior in Worker-compatible environments.

A tiny example showing the basic shape of a Worker-based pi agent.

An example focused on media tooling / ffmpeg workflows.

A codegen/scaffolding example for generating Worker projects and related files.

The flagship example.

Features:

• terminal UI in the browser
• persistent Durable Object sessions
• persistent SQLite-backed filesystem
• code execution in dynamic sandbox Workers
• publish-a-file-as-a-Worker
• cron jobs that feed prompts back into the session
• outbound fetch via a loopback Worker entrypoint in the same Worker

Install dependencies from the repo root:

npm install

Then work inside an example directory, for example:

cd examples/terminal-agent
npm run dev

This repo is currently organized as a monorepo-first codebase.

That means:

• packages in packages/ are the source of truth
• examples in examples/ consume those local workspace packages
• the terminal-agent example is the best place to start if you want to see the whole stack working together

Package tests and example tests live alongside their code.

For example, the terminal agent example has worker-pool tests:

cd examples/terminal-agent
npm test

• Some examples require local secrets in .dev.vars.
• This repo is actively experimental, but the terminal-agent example is real and deployable.

If you're new to the repo, start with:

1. examples/terminal-agent/README.md
2. examples/terminal-agent/src/index.ts
3. packages/pi-worker/src/index.ts

MIT