What an extension can add.

An extension can put something in almost every part of OpenChamber, and some of its work needs no window at all. Pick a number to see what goes there, how one of ours uses it, and which part of the SDK does it.

Pick a number to see what goes there.

A full-screen page

A row under Pages opens the extension full screen, in place of the chat. Acme Tasks draws its task board there.

Usescontributes.page
Read in the docs

Work with no window open

A local service runs next to OpenChamber and keeps working while nobody looks.

Runs in the background A service can start with OpenChamber or wake on a schedule. Acme Deploys checks staging every night at 03:00. service.keepRunningservice.schedule
Read in the docs
Hears what happens in sessions The extension's service learns when a turn finishes or fails and when the agent asks something, in every project. Acme Tasks moves UPL-31 to review when the agent is done. contributes.sessionEvents
Read in the docs
Drives sessions The extension's service starts sessions, sends messages and answers permission requests with no window open. Acme Chat starts a session from a message in the team's chat. contributes.sessionControl
Read in the docs
Adds to what agents read The extension adds text to the instructions of your sessions and offers skills to every agent. Acme Deploys tells agents that deploys go through the release branch. contributes.instructionscontributes.skills
Read in the docs
Brings an OpenCode plugin An OpenCode plugin in the extension's package loads into OpenCode while the extension is on, so people install one thing. Acme Tasks ships the tools the agent calls. contributes.opencodePlugin
Read in the docs
Lets the agent wait The agent starts a wait and ends its turn, and OpenChamber wakes the session when the service says the wait is over. The agent waits for the staging deploy, then checks the uploads. contributes.waits
Read the SDK reference
Uses the Small Model One-off text from the user's Small Model, outside any session. Acme Tasks writes the title of a new task. host.generate()
Read in the docs
Reads and writes files Files in the open project, and paths outside it that the manifest lists and the user approves. host.readFile()contributes.filesystem
Read in the docs
Stores data on the server JSON on the OpenChamber server that survives reloads and goes away with the extension. The task board keeps its columns there. host.storage
Read in the docs
Watches background commands The shell commands agents leave running, with their output, and a way to stop them. host.onRunningShells()
Read in the docs
Reads OpenCode A service can read sessions, messages and live events from the OpenCode that OpenChamber uses. provides: ["opencode"]
Read the SDK reference

Start building

An extension is a folder with a manifest and a web page. Build an extension covers both and how to install it from the folder while you work, and the Example page has a complete one to copy.