Skip to content

workato-devs/labs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 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