cloud-code

miantiao-me/cloud-code is ranked 17,007 among these 8 peers; ogulcancelik/pi-extensions is ranked 17,008.

Cloud Code (Cloudflare + OpenCode) **Cloud Code** is a containerized Agent solution that combines Cloudflare's powerful infrastructure with OpenCode's intelligent capabilities. This is a TypeScript project based on Cloudflare Workers and Cloudflare Containers. It leverages Cloudflare's infrastructure to run and manage containerized workloads. js (v20+ recommended) Wrangler CLI ( ) Install Dependencies Local Development Start the local development server: This command will start , simulating the Cloudflare Workers environment. Generate Type Definitions If you modify the bindings in , you need to regenerate the type

files: 📦 Deployment Deploy your code to Cloudflare's global network: 📂 Project Structure 🔐 Secure Access (Basic Auth) To protect your Agent from unauthorized access, this project supports standard HTTP Basic Auth authentication. If not set, authentication is **disabled**. Authentication is only enabled when the environment variable is set. If authentication fails, the server returns a status code. 💾 Data Persistence (S3/R2) Cloud Code containers have built-in support for S3-compatible storage (such as Cloudflare R2, AWS S3), using to mount object

storage as a local filesystem for persistent data storage. **Mount Point**: When the container starts, the S3 bucket is mounted at . **Working Directory**: The actual workspace is located at . **OpenCode Configuration**: OpenCode's configuration files (XDG directory) are also stored in , ensuring editor state persistence. **Initialization**: If the S3 bucket (or specified prefix path) is empty, the container will automatically copy the preset directory contents into it. If S3 configuration is missing, the container will fall back to non-persistent local

directory mode. 🌐 Tunnel Exposure (Cloudflared) The container comes pre-installed with the CLI, which can be used to expose services running inside the container (such as development servers, web applications) to the public internet via Cloudflare Tunnel. This is useful in the following scenarios: Debugging web services running inside the container Temporarily sharing development environments Configuring SSH access Usage example (in the container terminal): 🛠 Tech Stack **Runtime**: Cloudflare Workers **Language**: TypeScript **Core Libraries**: : Workers standard library : Container management and interaction

**Tools**: Wrangler **Container Environment**: : Python 3. js 22 : S3 filesystem mount : Cloudflare Tunnel client : Intelligent coding Agent 📝 Development Guidelines The official language for this project is **English** (code, comments, and commit messages are in English). For detailed development guidelines, code style, and Agent behavior rules, please refer to AGENTS.