https://github.com/workato-devs/labs
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.
https://github.com/workato-devs/labs
Last synced: about 1 month ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/workato-devs/labs
- Owner: workato-devs
- Created: 2026-04-24T00:12:05.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-05-13T18:07:18.000Z (2 months ago)
- Last Synced: 2026-05-13T20:11:12.453Z (2 months ago)
- Language: HTML
- Size: 1.36 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 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):**
```bash
brew install workato-devs/tap/wk
wk version
```
**Windows (Scoop):**
```powershell
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](https://github.com/workato-devs/wk-cli-beta/releases), then:
```bash
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):**
```bash
brew install workato-devs/tap/recipe-lint
wk plugins install recipe-lint
```
**Windows (Scoop):**
```powershell
scoop install recipe-lint
wk plugins install recipe-lint
```
Manual install
Download and extract the archive for your platform from [Releases](https://github.com/workato-devs/wk-lint-beta/releases). The binary inside is named `recipe-lint` (not `wk-lint`).
```bash
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.
```bash
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/`](https://github.com/workato-devs/labs/tree/main/downloads) folder, then:
```bash
# 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](https://github.com/workato-devs/labs) | Hub — docs, downloads, .vsix extensions |
| [wk](https://github.com/workato-devs/wk-cli-beta) | CLI — Go binary, workspace ops |
| [recipe-skills](https://github.com/workato-devs/recipe-skills) | Agent knowledge — 7 connector skill sets |
| [wk-lint](https://github.com/workato-devs/wk-lint-beta) | 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 →](https://github.com/workato-devs/labs/discussions)