mirror of https://github.com/different-ai/openwork synced 2026-05-09 16:52:02 +02:00

Files

ben bf001a8384 fix: wire reload toast through OpenWork server (#362 )

* feat(app): reload via OpenWork server

* feat(server): emit reload events for UI

* fix: resolve reload timeout and approval errors

- Add idleTimeout: 120 to Bun.serve() to prevent 10-second timeout on long operations
- Pass --approval auto flag when spawning OpenWork server from desktop app
- Suppress dead_code warning on OpenwrkStateFile.version field

2026-01-31 23:34:24 -08:00

script

feat: host mode prefers OpenWork server for skills/plugins management (#304 )

2026-01-28 19:11:03 -08:00

src

fix: wire reload toast through OpenWork server (#362 )

2026-01-31 23:34:24 -08:00

cli

feat(onboarding): add browser setup entry

2026-01-29 18:33:58 -08:00

package.json

feat(headless): ship openwrk as compiled binary (#339 )

2026-01-30 15:49:42 -08:00

README.md

fix: wire reload toast through OpenWork server (#362 )

2026-01-31 23:34:24 -08:00

tsconfig.json

feat: auto-start OpenWork server sidecar (#284 )

2026-01-27 14:36:34 -08:00

README.md

OpenWork Server

Filesystem-backed API for OpenWork remote clients. This package provides the OpenWork server layer described in packages/app/pr/openwork-server.md and is intentionally independent from the desktop app.

Quick start

npm install -g openwork-server
openwork-server --workspace /path/to/workspace --approval auto

openwork-server ships as a compiled binary, so Bun is not required at runtime.

Or from source:

pnpm --filter openwork-server dev -- \
  --workspace /path/to/workspace \
  --approval auto

The server logs the client token and host token on boot when they are auto-generated.

Config file

Defaults to ~/.config/openwork/server.json (override with OPENWORK_SERVER_CONFIG or --config).

{
  "host": "127.0.0.1",
  "port": 8787,
  "approval": { "mode": "manual", "timeoutMs": 30000 },
  "workspaces": [
    {
      "path": "/Users/susan/Finance",
      "name": "Finance",
      "workspaceType": "local",
      "baseUrl": "http://127.0.0.1:4096",
      "directory": "/Users/susan/Finance"
    }
  ],
  "corsOrigins": ["http://localhost:5173"]
}

Environment variables

OPENWORK_SERVER_CONFIG path to config JSON
OPENWORK_HOST / OPENWORK_PORT
OPENWORK_TOKEN client bearer token
OPENWORK_HOST_TOKEN host approval token
OPENWORK_APPROVAL_MODE (manual | auto)
OPENWORK_APPROVAL_TIMEOUT_MS
OPENWORK_WORKSPACES (JSON array or comma-separated list of paths)
OPENWORK_CORS_ORIGINS (comma-separated list or *)
OPENWORK_OPENCODE_BASE_URL
OPENWORK_OPENCODE_DIRECTORY
OPENWORK_OPENCODE_USERNAME
OPENWORK_OPENCODE_PASSWORD

Endpoints (initial)

GET /health
GET /capabilities
GET /workspaces
GET /workspace/:id/config
PATCH /workspace/:id/config
GET /workspace/:id/events
POST /workspace/:id/engine/reload
GET /workspace/:id/plugins
POST /workspace/:id/plugins
DELETE /workspace/:id/plugins/:name
GET /workspace/:id/skills
POST /workspace/:id/skills
GET /workspace/:id/mcp
POST /workspace/:id/mcp
DELETE /workspace/:id/mcp/:name
GET /workspace/:id/commands
POST /workspace/:id/commands
DELETE /workspace/:id/commands/:name
GET /workspace/:id/audit
GET /workspace/:id/export
POST /workspace/:id/import

Approvals

All writes are gated by host approval. Host APIs require X-OpenWork-Host-Token:

GET /approvals
POST /approvals/:id with { "reply": "allow" | "deny" }

Set OPENWORK_APPROVAL_MODE=auto to auto-approve during local development.