Skip to content

workato-devs/labs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Workato Labs

Build recipes with the AI coding tools you already use.

An open-source developer toolkit for building, validating, visualizing, and managing Workato recipes — designed for humans and coding agents alike.

🟢 Beta — Design Partner Program


The workflow

Four tools that replace the loop of guess, push, break, repeat.

Agent writes recipe (recipe-skills) → Developer inspects (visualizer) → Linter validates (wk lint) → CLI pushes (wk push)


Install the toolkit

Four steps, each using a command you already know. No install scripts, no ambient dependencies, no magic.

1. Install the CLI

A unified CLI for Workato platform operations and recipe development. Single binary, no dependencies.

macOS (Homebrew):

brew install workato-devs/tap/wk
wk version

Windows (Scoop):

scoop bucket add workato-devs https://github.com/workato-devs/scoop-bucket
scoop install wk
wk version
Manual install

Download and extract the binary for your platform from Releases, then:

xattr -d com.apple.quarantine /path/to/wk      # macOS: allow the binary to run
sudo mv /path/to/wk /usr/local/bin/
wk version

Tip: Right-click the extracted binary in Finder and hold Option to copy its full path.

2. Install the recipe linter

Deterministic validation — catches errors that agent self-validation misses.

macOS (Homebrew):

brew install workato-devs/tap/recipe-lint
wk plugins install recipe-lint

Windows (Scoop):

scoop install recipe-lint
wk plugins install recipe-lint
Manual install

Download and extract the archive for your platform from Releases. The binary inside is named recipe-lint (not wk-lint).

sudo mv /path/to/extracted-folder /usr/local/lib/recipe-lint  # move to a permanent location
sudo xattr -rd com.apple.quarantine /usr/local/lib/recipe-lint  # macOS: allow the binary to run
sudo ln -s /usr/local/lib/recipe-lint/recipe-lint /usr/local/bin/recipe-lint  # symlink so wk can find the plugin
wk plugins install recipe-lint
which recipe-lint

Tip: Right-click the extracted binary in Finder and hold Option to copy its full path.

3. Clone the recipe skills

Agent-consumable knowledge for recipe authoring — connector config, datapill syntax, control flow, schemas. Also where connector-specific lint rules live. Point your coding agent here.

git clone https://github.com/workato-devs/recipe-skills.git

4. Install the recipe visualizer

IDE extension that renders recipe JSON as interactive workflow graphs. Works in VS Code, Cursor, and Windsurf.

Download the .vsix from this repo's downloads/ folder, then:

# VS Code
code --install-extension ./recipe-visualizer-0.5.3.vsix

# Cursor
cursor --install-extension ./recipe-visualizer-0.5.3.vsix

What's in the box

Each tool covers a piece of the developer lifecycle. Together, they replace manual recipe wrangling with an agent-native development flow.

wk CLI · Go A unified CLI for Workato platform operations and recipe development. wk pull, wk push, wk diff, and wk status across workspaces. Plugin system for extending with custom commands.

Recipe Linter · Go Deterministic validation via wk lint. Catches datapill syntax errors, schema mismatches, and structural issues that agents can't self-validate.

Recipe Skills · 7 connectors Agent-consumable knowledge for recipe authoring. Connector config, datapill syntax, control flow, error handling. Also home to connector-specific lint rules. Point your coding agent at the skills directory.

Recipe Visualizer · .vsix IDE extension rendering recipe JSON as interactive workflow graphs. Click a node, navigate to the source. Export graphs as images. VS Code, Cursor, Windsurf.


Repositories

Repo Description
workato-labs Hub — docs, downloads, .vsix extensions
wk CLI — Go binary, workspace ops
recipe-skills Agent knowledge — 7 connector skill sets
wk-lint Recipe linter — deterministic validation

Feedback

Workato Labs is an open-source initiative from Workato. Community feedback welcome, no SLA.

File issues here for general toolkit feedback, or on the individual repos for tool-specific bugs.

Join the conversation →

About

Landing page and hub repo for Workato Labs — an open-source developer toolkit for building, validating, visualizing, and managing Workato recipes with AI coding agents.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors