Integrations

Overview

Watchflows is local-first and account-free. Integrations are opt-in connections you add yourself so your flows can react to and act on external tools. Nothing is connected by default — you decide what to wire up.

Any credentials you provide are stored locally on your Mac in the system keychain and are never uploaded. Connections live entirely on your machine.

Open the integrations surface at Settings → Integrations (“Connect your tools”).

Linear

Connect Linear to file issues, add comments, and query your issues directly from your flows.

To connect:

• Open Settings → Integrations and click the Linear tile, then Connect an account.
• Paste a Personal API key. Create one in Linear at Settings → Security & access → Personal API keys.
• Click Validate & Connect. Watchflows validates the key, resolves your workspace name and email, and stores the key locally.

Once connected, a row shows the workspace, your email, and a Disconnect button. Connections are workspace-scoped — one email can connect multiple workspaces, each as a separate connection. If a key is revoked upstream, the row shows an error so you can disconnect and re-add it.

Watchflows keeps its Linear access narrow — it files issues, adds comments, and reads the issues you ask it to query. Nothing more.

Connecting Linear unlocks three action nodes:

• Linear: Create Issue — File a new issue from your flow.
• Linear: Add Comment — Add a comment to an existing issue.
• Linear: Query Issues — Read issues — your assigned work, the current cycle, a project, or a filtered search — as a real array to loop over or feed an AI node.

Artifyde

Connect Artifyde to publish HTML from your flows as hosted web pages — a report an AI node wrote, a rendered template, a dashboard on a stable URL.

To connect:

• Open Settings → Integrations and find the Artifyde tile.
• Paste an API token. Create one at artifyde.com under Settings → API tokens — API tokens are available on every Artifyde tier, including free.
• Click Validate & Connect. Watchflows validates the token against Artifyde and stores it locally. Artifyde exposes no account identity, so the connected row shows a masked token suffix (like ak_…Kkzf).

Pages you push are public by default — anyone with the URL can open them. The node's Private option restricts a page, and requires a paid Artifyde plan.

Connecting Artifyde unlocks one action node:

• Artifyde: Push Page — Publish HTML as a hosted page and get its URL back for the rest of the flow.

Apple Calendar

Apple Calendar needs no connection and no API key. It uses native macOS Calendar access through EventKit.

You simply grant Full Calendars access at the standard macOS permission prompt the first time a Calendar trigger runs. From there, your flows can react to calendar events without any account setup.

See the Calendar Event (Apple) trigger to get started.

More Coming

The integrations surface is built to grow. Today, Linear (via a Personal API key), Artifyde (via an API token), and Apple Calendar (via native macOS permissions) are the connections that ship.

As new integrations land, they will appear as additional tiles under Settings → Integrations — always opt-in, always with credentials stored locally on your Mac.