Service: Open Builder - EyevinnOSC/community GitHub Wiki
Open Builder
Open Builder (serviceId eyevinn-open-builder) is an open source web interface for Claude Code. It lets you interact with Claude AI in the browser through a permission-controlled UI, without installing the CLI. In Eyevinn Open Source Cloud (OSC) it is a long-running service instance with up to 10 GiB of storage per instance. License: MIT.
What it can do
- Chat with Claude in the browser and have it read files, write code and run commands in a sandboxed file workspace.
- Require user approval for potentially sensitive operations (permission system).
- Keep Claude SDK session continuity across conversations.
- Use MCP (Model Context Protocol) servers.
- Deploy static websites to Open Source Cloud.
You need your own Anthropic API key.
Creating an instance
Create the instance with create-service-instance using serviceId: "eyevinn-open-builder". The instance name must be alphanumeric and at most 20 characters. Open Builder has no dependencies on other OSC services.
Store your Anthropic API key as a service secret first with create-service-secret (serviceId: "eyevinn-open-builder"), for example a secret anthropickey with the key as value.
{
"name": "mybuilder",
"AnthropicApiKey": "{{secrets.anthropickey}}",
"OscAccessToken": "{{secrets.osctoken}}"
}
OscAccessToken is optional. Wait for the instance with wait-for-service-ready and get the URL with describe-service-instance.
With the OSC CLI:
osc create eyevinn-open-builder mybuilder \
-o AnthropicApiKey="{{secrets.anthropickey}}"
Options
| Option | Required | Type | Meaning |
|---|---|---|---|
| name | Yes | string | Name of the instance. Alphanumeric, at most 20 characters. |
| AnthropicApiKey | Yes | string, sensitive | Anthropic API key (format sk-ant-..., created in the Anthropic Console), used server-side by Open Builder to call Claude (ANTHROPIC_API_KEY). It is not exposed to the browser. Store it as a secret and pass {{secrets.NAME}}. |
| OscAccessToken | No | string, sensitive | Personal access token for Open Source Cloud (OSC_ACCESS_TOKEN). Needed for the features that deploy generated sites to OSC and lets the Claude agent manage OSC services on your behalf. Store it as a secret and pass {{secrets.NAME}}. |
A {{secrets.NAME}} reference must be the whole field value. Changing a secret later does not restart a running instance.
Using the instance
Open the instance URL in a browser and start a conversation with Claude: ask it to read files, write code or run shell commands within the sandboxed environment. Approve or deny operations when Open Builder asks for permission.
Limitations
- Storage is limited to 10 GiB per instance.
- An Anthropic API key is required.