Changelog

Notable product and API changes to FlowKoi.

Notable changes to the FlowKoi product and API. The public REST API follows semver — breaking changes go to /api/v2/; non-breaking additions are listed here too.

2026-06-12 — Live file editing & skill cascades

Files

  • New per-instance Pull latest files button to refresh a running instance’s files on demand.
  • File edits now push to running containers on save, and deletions propagate live — changes show up in the running instance immediately.

Skills

  • Skill providers gain an Update all workflows cascade action, reporting how many workflows it touched.
  • Skill update failures now surface an error instead of silently doing nothing.

2026-06-11 — Project-wide instances & file management

  • The Instances tab now shows runs from every project member, not just your own.
  • Drag and drop files between folders, and rename files and folders, in the workflow Files tab.

2026-06-09 — Scheduling

  • The Scheduled badge tooltip now shows the next run in both UTC and your local time.

2026-06-05 — Visibility improvements

  • Workflow cards show a Scheduled badge with a next-run hint.
  • Hover hints on instance status badges explain each state.
  • Project Settings: the Integrations tab is now Git.
  • Project-wide sync logs are visible to all project members.

2026-06-04 — Team projects & Opus 4.8

  • New Members tab in Project Settings for managing who can access a project.
  • Claude Opus 4.8 is selectable as a workflow model.

2026-06-01 — Sandcastle launch (v1)

Public REST + streaming surface ships.

API

  • POST /api/v1/flows/{flowId}/runs — trigger a run with prompt + idempotency.
  • GET /api/v1/flows, GET /api/v1/runs/{runId}, GET /api/v1/runs/{runId}/logs, GET /api/v1/runs/{runId}/files, GET /api/v1/runs/{runId}/files/{path}.
  • GET /api/v1/runs/{runId}/stream — SSE stream.
  • POST /api/v1/runs/{runId}/messages — follow-up message into a running PTY.
  • POST /api/v1/runs/{runId}/files — file injection (persisted + live-delivered).
  • POST /api/v1/runs/{runId}/stop, DELETE /api/v1/runs/{runId}.

Quotas & limits

  • Per-key token bucket, default 60 req/min.
  • Per-project concurrent-runs cap, default 10.
  • Optional per-project monthly run quota.
  • Per-key daily usage aggregates in the API tab.

Webhooks

  • runFinished event, HMAC-signed via X-FlowKoi-Signature, retried 3× with 2s/10s/30s backoff.
  • Per-project webhookSecret, lazy-created.

SDK

  • @flowkoi/sdk@0.1.0 published to npm.

Dashboard

  • Environment Variables moved to a dedicated Project Settings tab.

2026-05-31 — Git sync & secrets

  • Replaced the .flowfiles allowlist with a .flowignore denylist plus a debounced full-sweep — everything in your workdir syncs unless explicitly ignored.
  • Manual full-sync buttons in flow and project settings.
  • Environment variable values are masked, with a base64 helper.

2026-05-26 — Flow Items & skill providers

  • New Flow Items catalog to install, update, and remove items per workflow, with one-click bundle installs for multiple items at once.
  • Link external .claude skill packs to projects as skill providers.