Workato Platform CLI (Fork)

This is a fork of workato-devs/workato-platform-cli with additional features. Not intended for upstream contribution.

A modern, type-safe command-line interface for the Workato API, designed for automation and AI agent interaction. Perfect for AI agents helping developers build, validate, and manage Workato recipes, connections, and projects.

Changes from upstream

Feature	Description	Status
Jobs commands	workato jobs list / workato jobs get — レシピのジョブ一覧・詳細取得	PR #1
SDK commands	workato sdk new / push / generate schema / exec / oauth2 — workato-connector-sdk の機能を統合	PR #2
workspace_id によるプロファイル解決	.workatoenv の workspace_id でプロファイルを自動選択。ファイルを Git でチーム共有可能に	PR #3
Custom OAuth Profile 管理	workato oauth-profiles (list/get/create/update/delete) — Custom OAuth Profile の CRUD 操作	PR #5
push --delete	workato push --delete — ローカルに存在しないリモートアセットを削除同期	PR #6

Features

• Project Management: Create, push, pull, and manage Workato projects
• Recipe Operations: Validate, start, stop, and manage recipes
• Connection Management: Create and manage OAuth connections
• API Integration: Manage API clients, collections, and endpoints
• AI Agent Support: Built-in documentation and guide system

Quick Start Guide

Get the Workato CLI running in 5 minutes.

Prerequisites

• Python 3.11+
• Workato account with API token
• Ruby 2.7+ and workato-connector-sdk gem（workato sdk exec / oauth2 を使う場合のみ）

Getting Your API Token

1. Log into your Workato account
2. Navigate to Workspace Admin → API clients
3. Click Create API client
4. Fill out information about the client, click Create client
5. Copy the generated token (starts with wrkatrial- for trial accounts or wrkprod- for production)

Installation

From PyPI (Coming Soon)

pip install workato-platform-cli

From Source

git clone https://github.com/rkawaishi/workato-platform-cli.git
cd workato-platform-cli
make install

Having issues? See DEVELOPER_GUIDE.md for troubleshooting.

Setup

# Initialize CLI (will prompt for API token and region)
workato init

# Verify your workspace
workato workspace

First Commands

# List available commands
workato --help

# List your recipes
workato recipes list

# List your connections
workato connections list

# Check project status
workato workspace

Next Steps

• Need detailed commands? → See COMMAND_REFERENCE.md
• Want real-world examples? → See USE_CASES.md
• Looking for sample recipes? → See examples/
• Installation issues? → See DEVELOPER_GUIDE.md
• Looking for all documentation? → See INDEX.md

Quick Recipe Workflow

# 1. Validate a recipe file
workato recipes validate --path ./my-recipe.json

# 2. Push changes to Workato
workato push

# 3. Pull latest from remote
workato pull

You're ready to go!

Contributing to the CLI

These commands are for CLI maintainers and contributors, not for developers using the CLI to build Workato integrations.

For Development

# Setup (with uv - recommended)
make install-dev

# Run all checks
make check          # linting, formatting, type checking
make test          # run tests
make test-cov      # run tests with coverage

# Development workflow
make format        # auto-format code
make lint         # check code quality
make build        # build distribution packages

Tech Stack

• 🐍 Python 3.11+ with full type annotations
• ⚡ uv for fast dependency management
• 🔍 mypy for static type checking
• 🧹 ruff for linting and formatting
• ✅ pytest for testing
• 🔧 pre-commit for git hooks

License

MIT License