The full history is in CHANGELOG.md in the repository.
0.4.0 (not released)
After cf-opencode upgrade, run cf-opencode rebuild <workspace> for each older workspace. A rebuild puts cf-opencode-job and cf-opencode-store on its disk.
Start a task:
run --branch,--auto,--newand--worktree. See Hand off a task.- One task at a time uses the checkout of a workspace. A second
runfails with the two fixes:--newand--worktree. tasks <ses_…> --pullfetches the task’s branch into the local checkout.- MCP:
handoff_tasktakesbranch,auto,newWorkspaceandworktree, and there is a new tool,pull_task. A2A:metadata.autoandmetadata.worktree.
Work that a task leaves in the workspace:
- A task that ends with commits that are not pushed or processes left running gets one automatic reply. The task stays
runninguntil that turn ends. The settingautoReplyturns it off. cf-opencode-jobin the workspace runs a long command apart from the agent’s turn. A running job keeps the workspace awake up to its--max-minutes. See The workspace image.
Files:
cf-opencode cpcopies a file or a folder between workspaces, or between a workspace and this machine.- The store, an optional R2 bucket (
store: true):cpwithstore:<name>,cf-opencode store, andcf-opencode-storein a workspace.
The Worker URL:
init --domain <hostname>puts the Worker on a Custom Domain.init --urlrepairs an install after the Worker URL changed.doctorprints that fix when the URL does not answer.
0.3.0 (2026-11-16)
Fixes from a first long run of handed-off tasks with the laptop closed.
After cf-opencode upgrade, run cf-opencode rebuild <workspace> for each workspace made before 0.3.0. A rebuild puts Node, mise and the browser fix on its disk.
Tasks:
- The result record has
unpushedandprocesses. A task can enddonewith commits that are only in the workspace, or with a process that the next pause stops.cf-opencode tasksshowsdone !for such a task.tasks <ses_…>shows the facts and the--replycommand that tells the agent to finish. See Work that is not safe. - The instruction that
runadds to each task tells the agent to push work that is not complete, and not to end its turn while a process that it started still runs. See Long jobs. commitsandchangedFilesdo not count what a merge or a new branch brings from the remote.
The workspace image:
- Node 22 is installed.
miseis installed for a project that pins another version: runmise trust && mise install. See The workspace image. cf-opencode-browseworks from the workspace with Python’swebsocketmodule. Before, the Worker refused the connection with HTTP 403.cf-opencode-fetchtakes its options before or after the URL. Before, an option after the URL was ignored.PORTis not in the environment of the tools that the agent runs.
The CLI:
- The preflight failure of
runnames the local checkout and its path. The check reads your machine, not the workspace. cf-opencode ssh,ssh-configandpreviewsetConnectTimeout 120. Before, the first connection to a paused workspace could stop withConnection timed out during banner exchange. Replace a Host block that an olderssh-configprinted.connectandrunrefuse a session ID in the place of a workspace ID.- A dropped connection from your machine does not read as a lost task.
--waitand--followtry again for 5 minutes, then stop with exit code 3. Thecannot reachline says that workspaces and their tasks are not affected. See Troubleshooting.
Docs: Move a file between workspaces.
0.2.2 (2026-11-12)
- Just after a deploy, Cloudflare can answer for some seconds with its own page. The CLI now tries the request again. If it stops, it prints one line with the HTTP status. Before,
connectcould stop withFailed: <!DOCTYPE html>.
0.2.1 (2026-11-12)
- A workspace that was running when you set the notify URL now sends task results to it. Before, it sent them only after its next restart.
changedFilesin the result of a task lists the files of the commits of the task and its uncommitted changes. It does not list files that changed in the remote.initandupgradewait for the deployed version before they print the “Worker healthy” line.
0.2.0 (2026-11-12)
Hand off tasks, preview dev servers, copy skills, and a tighter Worker.
New:
cf-opencode run "<task>"hands a task to OpenCode in the workspace of the checkout, and returns. A preflight fails on changes that are not committed or pushed (--allow-dirtyskips it). Flags:--title,--model,--skills,--schema,--wait,--follow,--timeout.cf-opencode taskslists handed-off tasks across workspaces. The states arerunning,done,failed,waitingandstopped.tasks <ses_…>shows one task.--unseenlists results that you did not read.--reply "<text>"sends one more message to a session. The exit codes of--waitand--followare 0 done, 1 failed, 2 waiting, 3 timed out, 4 stopped. See Hand off a task.- The result record: state, summary, and the branch, commits, changed files and pull request that the Worker reads with
gitandgh pr viewin the workspace.run --schema <file.json>adds a checkedstructuredvalue. --followshows the agent’s tool calls and messages live.cf-opencode notify-urlsets where the Worker sends a task’s result, signed with a key fromcf-opencode notify-key. The URL is the Worker secretNOTIFY_URL. Failed deliveries retry after 1, 5 and 30 minutes.cf-opencode-notify "<text>"in the workspace sends a note.cf-opencode mcpis an MCP server over stdio with the toolshandoff_task,get_task,wait_taskandlist_tasks. See Hand off tasks over MCP.- An A2A endpoint on the Worker, off by default (setting
a2a). See Hand off tasks over A2A. cf-opencode skillprints the handoff skill for agents, and--installcopies it.initinstalls it for Claude Code and OpenCode when their config folder exists.--no-skillskips it.cf-opencode skillscopies skills from your machine into a workspace.connect --skillsandrun --skillscopy in the same step.skills defaultsaves a list for new workspaces. Nothing is copied unless you ask. See Skills in a workspace.cf-opencode preview [workspace] <port...>opens a dev server of the workspace athttp://localhost:<port>through an SSH forward.--webuses a Worker URL behind a one-time sign-in link.--publicmakes a public URL,--stopremoves it and--listlists them. See Preview a dev server.cf-opencode completion <bash|zsh|fish>prints a tab-completion script.cf-opencode-searchandcf-opencode-fetchin the workspace search the web and read pages through the bindings of the Worker. The settingsearchProviderdefaults toexa.cf-opencode-preview <port>in the workspace prints the preview URL. The remote browser opens a dev server ashttp://p<port>.preview.internal/.- A session knows where it is. The workspace notes say that the workspace is a clone of the remote. A handed-off session gets a Handoff block before the task. See What the agent knows.
Security in 0.2.0
This release was audited before it shipped. It hardens these areas:
- Access checks on the new preview, task and agent-protocol routes.
- How the CLI shows text from a workspace in your terminal and in tab completion.
- The signature on notifications, and limits on what a workspace can send.
- Outbound requests that carry a credential.
- The notify URL is a secret.
0.1.1 (2026-11-12)
cf-opencode-searchin the workspace: web search through the AI binding and AI Gateway of the account. No key. The settingsearchProviderselects the provider. The default isexa.cf-opencode-fetchin the workspace: a page as Markdown, links, HTML, a screenshot or a PDF, through the Browser Run binding.- The image has the Python
websocketmodule.
Security in 0.1.1
This release hardens the install. If you run 0.1.0, upgrade.
- The Worker checks authentication earlier. A request without valid credentials gets one uniform answer.
- The workspace image build verifies what it downloads.
- Browser sessions and SSH keys are tied to their workspace.
- The terminal and browser routes refuse requests from other websites.
lockdownalso covers page reads.
0.1.0 (2026-11-12)
First release. It has one package, cf-opencode: the CLI. It carries the Worker source and the workspace image. It deploys them to your Cloudflare account with cf-opencode init.
What works:
- Workspaces on Cloudflare Containers. They pause to a snapshot when idle and restore on connect.
- Models through the AI binding of your account and AI Gateway. Browsing through the Browser Run binding. No keys.
shell,sshandssh-configover the Worker. No open port.- GitHub access with a token that stays in the Worker.
initsets it up once from theghlogin of the machine. connect --continueandconnect --sessionopen a session in the workspace.sessionslists sessions across workspaces.rebuildmoves a workspace to the deployed image. Snapshots refresh before they expire.
Known limits are on the Limits and costs page.