gitwtfhub

wtf is cloudflare-os?

cloudflare/cloudflare-os — explained in plain English

Analysis updated 2026-08-13

8,003TypeScriptAudience · developerComplexity · 4/5Setup · moderate

TL;DR

Cloudflare OS is an open source AI workspace where agents build sandboxed personal apps and access company data through guarded connectors.

Mindmap

mindmap
  root((Cloudflare OS))
    What it does
      AI workspace
      Agent chat UI
      Sandboxed gadgets
      Security framework
    Tech stack
      TypeScript
      Cloudflare Workers
      Wrangler
      pnpm
    Use cases
      Internal AI tools
      Custom app building
      Guarded integrations
    Audience
      Developers
      Companies
      Ops teams

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Build an internal AI chat workspace preloaded with your company's own knowledge and systems.

REASON 2

Let non-technical employees ask agents to build small custom apps called gadgets safely.

REASON 3

Add guarded, human-approved access to external services like GitHub or Google Docs for your agents.

REASON 4

Deploy a self-hosted alternative to SaaS office tools where every user gets a private app instance.

What's in the stack?

TypeScriptCloudflare WorkerspnpmWranglerworkerd

How it stacks up

cloudflare/cloudflare-ostwbs/iconscloudflare/vinext
Stars8,0038,0098,060
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasymoderate
Complexity4/51/53/5
Audiencedeveloperdesignerdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Runs locally via pnpm and wrangler, but is early access with rough edges.

Wtf does this do

Cloudflare OS is an AI productivity environment that Cloudflare built for its own employees, from engineers to salespeople, and has now open sourced so other companies can adapt it for themselves. The name operating system is used loosely. It does not run on your computer like Windows or macOS. Instead it is a workspace, built on Cloudflare Workers, where people chat with AI agents that already understand how the company operates, and where those agents can build small personal apps called gadgets. The core idea is that every user gets their own private, sandboxed copy of any app they create, rather than everyone sharing one central piece of software. If you ask an agent to build a slide deck tool, you get your own isolated instance of it, and you can ask the agent to add features to it whenever you want, without worrying about affecting anyone else or exposing your data. Security is handled through something called Gatekeepers. These act like guardrails between an agent or gadget and any external service it connects to, such as GitHub or Google Docs. A Gatekeeper manages authorization, limits access to only what is needed, logs every action, and lets a human review and approve actions later rather than forcing them to sit and wait for each approval in real time. You can try it out by installing pnpm and running a local command, which starts the whole stack using Cloudflare's wrangler and workerd tools, or you can deploy it directly to your own Cloudflare account. The project is written in TypeScript and is described as early access, meaning it is actively developed and still has rough edges to work through.

Yoink these prompts

Prompt 1
Help me install pnpm and run Cloudflare OS locally with the run-local command.
Prompt 2
Walk me through deploying Cloudflare OS to my own Cloudflare account.
Prompt 3
Explain how Gatekeepers work in Cloudflare OS and how I would build one for a new external service.
Prompt 4
Show me how to create a custom Blueprint so my team can spin up gadgets from a template.

Frequently asked questions

wtf is cloudflare-os?

Cloudflare OS is an open source AI workspace where agents build sandboxed personal apps and access company data through guarded connectors.

What language is cloudflare-os written in?

Mainly TypeScript. The stack also includes TypeScript, Cloudflare Workers, pnpm.

How hard is cloudflare-os to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is cloudflare-os for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.