---
title: "cf-opencode"
description: "Run OpenCode workspaces on Cloudflare Containers, in your own Cloudflare account."
---

> Documentation Index
> Fetch the complete documentation index at: https://cf-opencode.system3inference.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# cf-opencode

cf-opencode runs OpenCode in a cloud workspace. You deploy it into your own Cloudflare account. No hosted service is involved.

A workspace is a container with your repository, your tools and an OpenCode server. Your local OpenCode connects to it.

## What you get

- **Work that continues without your laptop.** The agent runs in the workspace. Close the lid and the task goes on.
- **No cost while idle.** An idle workspace saves its disk to a snapshot and stops. The next connect restores it.
- **No model keys.** Models come from your account through the Workers AI and AI Gateway bindings.
- **Private repositories.** The GitHub token stays in the Worker. It never enters the workspace.
- **Shell, SSH and browser access.** You can open a terminal, use `ssh`, or give the agent a browser.
- **Hand off a task.** `cf-opencode run` gives a task to the agent and returns. `cf-opencode tasks` shows the result. An agent on your machine can do the same over MCP, and another agent can use A2A.
- **Preview a dev server.** `cf-opencode preview 3000` opens a dev server of the workspace at `http://localhost:3000`. Nothing is public.
- **Skills.** `cf-opencode skills` copies your skills into a workspace.
- **Web search and page reading.** The agent searches the web and reads pages with no key.
- **Messages.** `cf-opencode notify-url` sends the result of a task to a URL that you own.

## How you use it

Install once:

```sh
npx cf-opencode init
```

Then, from any git checkout:

```sh
npx cf-opencode connect
```

`connect` wakes or creates the workspace for that checkout. It then opens your local OpenCode against it.

## Where to go next

- [Quickstart](https://cf-opencode.system3inference.dev/docs/quickstart/) installs cf-opencode and opens a first workspace.
- [How it works](https://cf-opencode.system3inference.dev/docs/concepts/how-it-works/) explains the parts and the workspace life cycle.
- [CLI reference](https://cf-opencode.system3inference.dev/docs/reference/cli/) lists every command and flag.
- [Hand off a task](https://cf-opencode.system3inference.dev/docs/guides/hand-off-a-task/) gives work to the agent and closes the laptop.
- [Troubleshooting](https://cf-opencode.system3inference.dev/docs/troubleshooting/) explains the `Failed:` errors.
- [Limits and costs](https://cf-opencode.system3inference.dev/docs/limits/) lists what a workspace cannot do and what it costs.

The control plane is a fork of the cf-orbs project. The source is at [github.com/meirdick/cf-opencode](https://github.com/meirdick/cf-opencode).

Source: https://cf-opencode.system3inference.dev/docs/index.mdx
