workato-cli

A guide to the command-line tools used with Workato, a service for building automations. It covers the Platform CLI for project files and a helper script for Workato API operations that the CLI does not provide.

In plain words
What is it for?
Initializing, pulling, and pushing projects; starting recipes; listing jobs and recipes; inspecting connectors; and pushing custom connectors through the appropriate tool.
Why use it?
It helps developers choose the right command for project management, API lookups, jobs, recipes, connectors, and custom-connector uploads.

Cursor rule

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add rules/rkawaishi/workato-dev-kit/workato-cli
Clone the repo
git clone --depth 1 https://github.com/rkawaishi/workato-dev-kit
Per session 0 Nothing until a file matches its globs; then the whole rule loads.
When invoked 1,446 The whole file, excluding the scripts and references it only reads on demand.
Security scan C 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00000 $0.01446
Opus 5 $0.00000 $0.00723
Sonnet 5 $0.00000 $0.00289
Haiku 4.5 $0.00000 $0.00145

Measured 2d ago against content hash 3fa7ef2318eb, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade C, and why

workato-cli scanned grade C with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Recursive force deletehighDestructive command

rm -rf with a variable or a broad path is one typo away from removing the wrong tree.

rm -rf "projects/_tmp_init_$$"
framework/cursor/rules/workato-cli.mdc · 126 lines

How it starts

The opening of the file, as written. The whole thing — 126 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Workato CLI Tools

Pick the right one of three tools:

1. Platform CLI (project management)

Install: pipx install workato-platform-cli

Common commands:

  • Init: workato init --non-interactive --profile <profile> --project-id <id> --folder-name "projects/<name>"
  • Pull: workato projects use "<name>" && workato pull
  • Push: workato push
  • Push (with restart): workato push --restart-recipes
  • Push (with delete): workato push --delete
  • Start a recipe: workato recipes start --id <id> / workato recipes start --all

2. API helper (complements the CLI)

A script that fills the gaps in Platform CLI by calling the API directly. Profile auto-resolves from workspace_id.

python3 scripts/workato-api.py <command>
Command Use
jobs list --recipe-id <id> [--status <s>] List jobs
jobs get --recipe-id <id> --job-id <id> Job detail
connectors list-platform [--provider <name>] Pre-built connector info
connectors list-custom List custom connectors
recipes list [--folder-id <id>] List recipes (JSON)
sdk push --connector <path> [--connector-id <id>] Push a custom connector (recommended)
sdk pull (--connector-id <id> | --name <name>) Pull a custom connector's source into connectors/<name>/
profile show Show the resolved profile

3. Connector SDK CLI (custom connector development & local testing)

Install: gem install workato-connector-sdk

Note: this gem ships a workato command that collides with Platform CLI. Always scope it with bundle exec.

cd connectors/<name>
bundle exec workato new <PATH>           # create
bundle exec workato exec <PATH> test     # local test

Pushing a custom connector

Use the API helper (recommended). No Ruby needed; authenticates via Platform CLI's profile.

# First push
python3 scripts/workato-api.py sdk push --connector connectors/<name>/connector.rb --title "<Title>"
# Update an existing connector
python3 scripts/workato-api.py sdk push --connector connectors/<name>/connector.rb --connector-id <id>

Read the full file on GitHub · 126 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 126 lines · 0 tokens per session scan C 3fa7ef2318eb

Subscribe to this mod's changes

workato-cli is a cursor rule published in the GitHub repository rkawaishi/workato-dev-kit (5 stars, last pushed 2d ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 1,446 tokens. A static security scan graded it C with 1 finding (recursive force delete). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.