Prerequisites

Before you scaffold an instance, make sure you have the following.

Bun 1.3.14 or newer

Notewright uses Bun as the installer for the scaffolded instance, and the notewright CLI runs under Bun. The CLI bin carries a #!/usr/bin/env bun shebang because notewright doctor imports your composed TypeScript Worker entry directly.

Node-only environments cannot run doctor

The preflight import pulls in agents and cloudflare: modules that plain Node cannot load, so you must have Bun installed to run notewright doctor.

Bun is the installer only. The Worker itself is still bundled by Wrangler; never bundle the Worker with bun build.

A Cloudflare account

You need a Cloudflare account with Workers, Durable Objects, and D1 enabled, plus the Wrangler CLI. Every Wrangler command below is invoked through bunx wrangler, so there is nothing extra to install globally.

A Cloudflare AI Gateway

Extraction runs through a Cloudflare AI Gateway with an Anthropic key stored in it (bring your own key). See AI Gateway setup for the exact steps. Without it, the follow-up pipeline cannot run.

Provider credentials

You need credentials for the providers you compose. With the built-in providers that means:

• A Granola API key for the notes source.
• A Linear API key and a team id for the follow-up sink.

If you only want to sync notes without filing follow-ups, you can compose the noop sink and skip the Linear credentials.