Settings are one JSON object in ~/.skyworker/config.json. The file is optional. A key in the file replaces the default. skyworker init and skyworker upgrade apply the file to the Worker. Run skyworker upgrade after you change it.
{
"idlePauseMinutes": 30,
"instance": { "memoryMib": 8192 },
"maxTaskCost": 5
}A bad value fails with a Failed: line that names the key. ~/.skyworker/config.json that is not JSON, or not one object, fails with the same kind of line. The key notifyUrl is not a setting. The notify URL is a Worker secret. Use skyworker notify-url.
Size
instance sets the container size. The same size applies to every workspace of the install. Give an object, or a size name: lite or standard-1 to standard-4. In an object, a key that you leave out keeps its default.
| Key | Default | Meaning |
|---|---|---|
instance.vcpu |
2 | Virtual CPUs: 1, 2, 3 or 4. |
instance.memoryMib |
6144 | Memory in MiB. |
instance.diskMb |
20000 | Disk in MB. |
Pause and limits
| Key | Default | Range | Meaning |
|---|---|---|---|
maxRunning |
10 | 1 to 100 | The most workspaces that run at once. |
maxAwakeHours |
12 | 1 to 168 | A workspace that is awake this long pauses, also while it works. |
idlePauseMinutes |
20 | 1 to 1440 | Minutes with no use before a workspace pauses. |
warmMinutes |
10 | 0 to 1440 | After a pause, the container stays warm this long. Zero stops it at once. |
checkpointMinutes |
0 | 0 to 1440 | Zero is off. Above zero, a workspace with changes saves a snapshot without stopping after this many minutes. |
snapshotRefreshDays |
3 | 0 to 29 | This many days before a snapshot expires, the Worker restores it briefly to start a new 30 days. Zero lets it expire. |
inactivityTimeoutMinutes |
15 | 1 to 1440 | The inactivity timeout of the platform for a container. |
alarmSeconds |
60 | 10 to 3600 | The interval of the alarm that keeps a workspace awake. It must be shorter than inactivityTimeoutMinutes. |
serverPort |
4096 | 1 to 65535 | The port of opencode serve in the container. Port 4097 is the port of the bridge and fails. |
projectSnapshotRefresh |
"off" |
"off" or "on-change" |
Accepts only these two values. |
Long tasks
| Key | Default | Range | Meaning |
|---|---|---|---|
autoContinue |
3 | 0 to 20 | Automatic continues of a task after a stop that no person asked for. run --continues sets it for one task. |
maxTaskHours |
24 | 1 to 720 | The time budget of a task in hours of work. run --max-hours sets it for one task. |
maxTaskCost |
0 | 0 to 10000 | The cost budget of a task in dollars. Zero is off. run --max-cost sets it for one task. |
stallMinutes |
30 | 0 to 1440 | A working task with no change for this long gives one stall notice. Zero is off. |
progressNoteHours |
6 | 0 to 168 | One progress note for each this many hours of work. Zero is off. |
cpuShare |
0.25 | 0 to 1 | The share of the provisioned vCPU that the cost estimate counts as busy. |
autoReply |
true |
true or false | Send one automatic reply to a handed-off session that ends its turn with commits that are not pushed or processes left running. |
Models and network
| Key | Default | Meaning |
|---|---|---|
ai |
true |
Models through the AI binding of the Worker. Off: OpenCode keeps only its own providers. |
model |
cloudflare-workers-ai/@cf/zai-org/glm-5.3 |
The default model of OpenCode, as provider/model. Empty: OpenCode chooses. |
aiGateway |
"default" |
The AI Gateway that the binding uses. |
searchProvider |
"exa" |
The provider of web search from a workspace. The Worker source names exa, linkup and ceramic. |
lockdown |
false |
True: a workspace has no general internet. Only the provider hosts whose secret is set resolve. |
Features
| Key | Default | Meaning |
|---|---|---|
store |
false |
Add an R2 bucket for files that outlive a workspace. init and upgrade make it. See skyworker store. |
a2a |
false |
Serve the Agent2Agent Agent Card and endpoint on the Worker. It is one more way to run code. |
images |
{} |
Extra image references, as an object. |
Files in ~/.skyworker
| Path | Content |
|---|---|
install.json |
The Worker URL, name, account, Custom Domain and web client URL. |
control-token |
The control token. Mode 600. |
config.json |
The settings above. |
workspaces/<id>.json |
What this machine knows of one workspace. |
workspaces/<id>.password |
The workspace password. Mode 600. |
ssh/id_ed25519 |
The SSH key of this machine for workspaces. |
ssh/known_hosts |
The host keys of workspaces. |
deploy/ and deploy.log |
The copy of the sources of the last deploy, and its log. |
license-key |
The licence key. Mode 600. |
builds/<version> |
A build that the installer downloaded. |